Agency Docs
Standalone

Agency-Admin Painel web

Painel de administração para FiveM no design Agency com um painel web completo no teu PC.

v1.10.0Pago7 Páginas

1 O painel web no Agency Companion

O Agency-Admin tem um painel de administração completo para o seu PC: companion.agencyg.de/app/admin. Ele roda dentro do Agency Companion no seu navegador e chega ao seu servidor pelo relay criptografado da Agency, como o app do celular. Não é preciso abrir nenhuma porta e nada fica hospedado no seu servidor de jogo.

PáginaO que você pode fazer
PainelJogadores online, tempo de tick, tempo ativo, resources, dinheiro na cidade, ações recentes
JogadoresTodas as ações de administração do painel do jogo, mensagens e advertências, visão ao vivo da tela de um jogador
Console ao vivoO console completo do servidor e comandos executados como console do servidor
ResourcesIniciar, parar e reiniciar qualquer resource, verificar novamente a lista de resources
ConfigsOs arquivos de configuração de todos os resources do seu servidor, editados como ajustes ou como código
ArquivosGerenciador de arquivos com editor para os seus resources
Banimentos, registro de ações, equipe e cargos, controle do servidorBanimentos offline, o histórico de todas as ações de administração, reiniciar ou parar o servidor com contagem regressiva

O painel web foi feito para PC. No celular ou tablet, use o app Agency Companion, que já vem com o módulo de administração.

2 Conectar

No jogo, abra o menu de administração, vá em Painel web e clique em Abrir no navegador, ou digite /webpanel. O navegador abre o painel e já faz o login para você.

Em outro PC, abra companion.agencyg.de/app/admin e digite o código de 6 dígitos da página Painel web. Um código vale por 5 minutos.

Você pode conectar quantos servidores gerenciar e alternar entre eles no painel. Cada conexão é um dispositivo pareado, e você pode desconectá-la no jogo em Configurações > Companion.

3 Permissões e segurança

O navegador guarda um token de dispositivo, como o app. Cada clique é verificado ao vivo no seu servidor de acordo com o cargo e as permissões do administrador, com o mesmo limite de frequência e o mesmo registro de ações do jogo.

PermissãoLiberaHerdada
companion_consoleConsole ao vivo e resourcessim
server_powerReiniciar e parar o servidornão, apenas o cargo mais alto e os cargos que você marcar
web_filesArquivos e Configsnão, apenas o cargo mais alto e os cargos que você marcar

Sem estar no jogo. Como o txAdmin, o painel web também funciona quando você não está no servidor. O Agency-Admin lembra as permissões de cada administrador da última vez que esteve no jogo, também quando vêm do ACE ou do framework (permissões do QBCore, grupos do ESX), e as mantém atualizadas enquanto eles jogam. Um administrador que fica três minutos no servidor sem acesso ao painel perde as permissões lembradas. As permissões que você define para um jogador no painel e as atribuições de cargo sempre têm prioridade.

O console, a nova verificação de resources e a reinicialização do servidor rodam como comandos de console. Eles precisam de uma linha no server.cfg:

add_ace resource.Agency-Admin command allow

4 Configs de todos os resources

A página Configs lista os arquivos de configuração de todos os resources do seu servidor, de qualquer autor, encontrados automaticamente: config.lua, shared/config.lua, config/*.lua, settings.lua, config.json e todos os arquivos de configuração citados no fxmanifest.lua de um resource. Nenhum resource precisa registrar nada.

VisualizaçãoO que mostra
AjustesCada valor simples (verdadeiro ou falso, números, textos) como interruptor ou campo, com o comentário do arquivo ao lado, agrupado por seção. Ao editar um valor, só essa linha muda; a formatação e os comentários permanecem.
CódigoO arquivo inteiro com cores de sintaxe.

Salvar verifica primeiro a sintaxe no servidor, então um config.lua quebrado nunca é gravado. A versão antiga é mantida antes de cada salvamento (as últimas 15 por arquivo, em Agency-Admin/config_backups). Salvar e reiniciar reinicia o resource na hora, e Versões anteriores restaura uma versão antiga.

Configs criptografadas com FiveM Escrow aparecem com um cadeado e não podem ser editadas.

5 Builds novas do FXServer: uma linha por resource

As builds do FXServer a partir de cerca da 25770 isolam o sistema de arquivos em um sandbox: um resource só pode gravar em outro resource se o server.cfg permitir isso antes de o servidor iniciar. Um servidor em execução ignora essas linhas. Adicione uma linha para cada resource cuja config você quer salvar pelo painel e depois reinicie o servidor uma vez:

add_filesystem_permission Agency-Admin write qb-core
add_filesystem_permission Agency-Admin write Agency-Housing

Quando falta uma linha, o painel avisa ao salvar e mostra as linhas exatas para copiar, para esse resource ou para todos os resources com config de uma vez. No txAdmin, você cola as linhas no CFG Editor.

6 Arquivos

A página Arquivos abre todos os resources do seu servidor com um gerenciador de arquivos e um editor: navegue, abra, edite, salve, crie, renomeie e exclua arquivos e pastas, com a mesma linha por resource da seção 5 para salvar em outros resources.

As builds novas do FXServer não permitem que nenhum resource leia a pasta do servidor, o server.cfg ou pastas de categoria como [standalone]. Por isso, acima dos resources o painel mostra as pastas montadas a partir dos seus resources instalados, somente leitura e com uma observação. Dentro de um resource você trabalha como de costume. O server.cfg é editado no txAdmin, no CFG Editor.

Arquivos maiores que Config.WebPanelFiles.MaxEditKb (1024 KB por padrão) não são abertos no editor. Config.WebPanelFiles.ReadOnly = true transforma o gerenciador de arquivos em um visualizador.

Continuas sem avançar depois desta página? O nosso suporte assume daqui.