Solução de problemas

/admin não abre#

Confirme Config.GrupoStaff, o nível devolvido por Bridge.GetStaffLevel e se o personagem já foi carregado pela framework.

Uma ação aparece, mas falha#

Confira o nível em Config.PermsAcao e a função correspondente na bridge. Spawn de item depende de GiveItem; dinheiro depende de GetMoney/AddMoney/RemoveMoney; veículos dependem de AddVehicle e da estrutura da garagem da sua base.

Bans ou logs não são salvos#

Garanta que oxmysql iniciou antes do resource, que a conexão do servidor está correta e que o usuário MySQL pode criar tabelas. Não troque Config.Database depois que houver dados.

Notify, screenshot ou spectate não funcionam#

Adapte Bridge.Notify, Bridge.Screenshot, Bridge.SpectateStart e Bridge.SpectateStop aos eventos/resources realmente usados na sua base.

Licença recusada#

Use o pacote mais recente do painel, mantenha o nome sf_admin e confira o IP/porta vinculados. Para trocar de máquina, resete o vínculo no painel; não edite server/loader.lua nem server/license.lua.

Antes de abrir ticket: /sfdiagnostico#

Rode /sfdiagnostico no console do servidor (ou dentro do jogo, se você estiver no grupo configurado). Ele confere, resource por resource:

• dependências declaradas no manifesto que não estão rodando, ou que sobem depois deste resource;
• tabelas que deveriam existir no banco e não existem;
• itens citados na configuração que não existem na sua base;
• permissões e grupos configurados;
• se a licença autenticou.

Cada problema vem com o próximo passo, não só com o diagnóstico. Um comando só cobre todos os resources SF instalados.