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

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ágina | O que você pode fazer |
|---|---|
| Painel | Jogadores online, tempo de tick, tempo ativo, resources, dinheiro na cidade, ações recentes |
| Jogadores | Todas 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 vivo | O console completo do servidor e comandos executados como console do servidor |
| Resources | Iniciar, parar e reiniciar qualquer resource, verificar novamente a lista de resources |
| Configs | Os arquivos de configuração de todos os resources do seu servidor, editados como ajustes ou como código |
| Arquivos | Gerenciador de arquivos com editor para os seus resources |
| Banimentos, registro de ações, equipe e cargos, controle do servidor | Banimentos 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ão | Libera | Herdada |
|---|---|---|
companion_console | Console ao vivo e resources | sim |
server_power | Reiniciar e parar o servidor | não, apenas o cargo mais alto e os cargos que você marcar |
web_files | Arquivos e Configs | nã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ção | O que mostra |
|---|---|
| Ajustes | Cada 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ódigo | O 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.