Agency-Admin Painel web
Painel admin para FiveM no design Agency com um painel web completo no seu 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 a pasta do servidor |
| 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 |
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 allow4 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-HousingQuando 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.