ai-core
O framework. Jogadores e personagens, a tela de personagens, dinheiro, empregos e gangues, permissões, o painel de administração e a ponte ESX, QBCore, Qbox e vRP.
O ai-core é o próprio AI Core: o framework sobre o qual todo outro script é construído. Ele sabe quem está jogando, qual personagem a pessoa escolheu, quanto dinheiro ela tem, a quais empregos e gangues pertence, e quem é administrador. Ele hospeda o painel de administração de todos os scripts, e deixa scripts de ESX, QBCore, Qbox e vRP rodarem sem alterações.
Esta página é uma visão geral. O painel de administração em si é descrito em Painel de administração.
Jogadores e personagens
- Contas. Um jogador é identificado pela sua conta do FiveM (o identificador
fivem:). Conectar sem uma é recusado. Os ids de license e Discord são guardados ao lado dela para scripts que os leem. - Vários personagens por conta (3 vagas por padrão). Os jogadores podem apagar personagens, a menos que você desligue isso.
- Tela de personagens. Os personagens do jogador ficam em uma cena real da cidade, cada um com suas próprias roupas; a câmera desliza até o escolhido. O nome do seu servidor, o subtítulo e o slogan aparecem nela.
- Criar um personagem pede nome e sobrenome, data de nascimento (idade mínima de 18 por padrão), sexo e nacionalidade. Um novo personagem passa então pelo criador de roupas (ai-appearance ou outro script de roupas).
- Onde aparecer. Um novo personagem aparece no ponto First spawn. Opcionalmente, depois de escolher um personagem, uma lista mostra o último local e os lugares que você definiu.
- Salvamento. Dinheiro e associações são salvos na hora. Posição, colete e outras pequenas mudanças são salvos a cada 5 minutos (painel), ao sair, quando o recurso para e no desligamento pelo txAdmin.
- PvP. Um interruptor decide se os jogadores podem machucar uns aos outros (ligado por padrão); os administradores o invertem no jogo com
/togglepvp.
Dinheiro
- Contas Cash (500 para começar), Bank (5000), Dirty money e Crypto por padrão. Você adiciona, renomeia ou remove contas no painel (Money accounts), cada uma com um valor inicial e se ela pode ficar abaixo de zero.
- Empregos e gangues também têm suas próprias contas (dinheiro de sociedade).
- Toda mudança é escrita com uma linha de registro: quem, quanto, o motivo.
Empregos e gangues
- Vários empregos por personagem (3 por padrão, ou um quando Several jobs per character está desligado), e várias gangues (2 por padrão) com uma gangue ativa.
- Serviço. Um personagem fica em serviço em no máximo um emprego. O salário vem só do emprego em serviço. Os jogadores começam fora de serviço depois de entrar, a menos que você ligue Keep duty after rejoining.
- Salário. A cada 15 minutos (painel), os jogadores em serviço recebem o salário do seu cargo na conta do banco, pago pelo servidor ou, se você escolher, pela conta do próprio emprego.
- Horário nobre. Fora das horas movimentadas (18:00 a 01:00 por padrão), os salários caem pela metade. As horas, o corte e o interruptor ficam no painel; um emprego pode ter suas próprias horas.
- Os empregos e gangues em si (cargos, salários, cargos de chefe) são registros nas abas Jobs e Gangs do painel.
Permissões
- Administradores são jogadores com o ACE
ai.admin. Opermission.cfgda receita o dá agroup.admin; adicione um jogador comadd_principal identifier.fivem:<id> group.admin. Em um servidor novo, o cartão de boas-vindas mostra a linha exata. - Comandos feitos com a lib do AI Core verificam as permissões no servidor: todos, administradores, ou certos ACEs e grupos. A aba Commands do painel lista todo comando com quem pode usá-lo.
- Permissões de empregos e gangues. O ai-core espelha as associações em principals de ACE:
ai.job.<name>eai.job.<name>.<grade>(todo cargo até o do jogador), o mesmo para gangues. Entãoadd_ace ai.job.police command.mdt allowdá um comando a todo policial.
Painel de administração
O ai-core hospeda o painel dentro do jogo (F10 ou /aiadmin) para si mesmo e para todo script ai-*. Suas próprias seções:
| Seção | O que você configura |
|---|---|
| General | Nome do servidor, subtítulo, slogan e fundo; vagas de personagens, apagar, idade mínima; o intervalo de salvamento; quais scripts de inventário, chaves, alerta da polícia, roupas, combustível, trancas de portas, garagem, notificação, cobranças, banco, MDT e médico o AI Core usa (Automatic escolhe o primeiro que estiver rodando); interação por aviso ou por target; PvP; verificação de atualizações; recusar jogadores enquanto um script desnecessário roda; o guia de configuração. |
| Spawn points | O primeiro spawn e os lugares que os jogadores podem escolher. |
| Character screen | A cena por trás da tela de personagens: câmera, hora e clima, os pontos onde os personagens ficam. |
| Job and gang rules | Quantos empregos e gangues, serviço depois de reentrar, o salário, horário nobre. |
| Jobs, Gangs | Todo emprego e gangue com seus cargos, salários e cargos de chefe. |
| Money accounts | Os tipos de dinheiro e com quanto um novo personagem começa. |
| Keybinds | As teclas de todos os scripts: a tecla padrão para todos e se o HUD a mostra como dica. |
| Commands | Todo comando do servidor com seus argumentos e quem pode usá-lo. |
| Other panels | Telas de configuração de outros scripts, abertas a partir do dashboard. |
| vRP scripts | Quem recebe as permissões, grupos e itens que os scripts de vRP pedem. |
| Logs | Console, Discord, Fivemanage e FiveM Stats, níveis, webhooks. |
Ele também verifica atualizações de todo script com repositório no GitHub (uma vez a cada 6 horas por script) e recomenda no dashboard scripts gratuitos que valem a pena instalar.
A ponte (ESX, QBCore, Qbox, vRP)
O ai-core faz provide de es_extended, qb-core, qbx_core e vrp, e responde aos exports, core objects e eventos deles. Scripts escritos para esses frameworks enxergam o AI Core como seu framework: chamadas ESX.GetPlayerFromId, QBCore.Functions.GetPlayer, exports.qbx_core:GetPlayer, vRP 1, 2 e 3 funcionam todas sobre os jogadores, o dinheiro e os empregos do AI Core.
Ele também desenha os recursos de UI dos frameworks com os próprios menus e cartões do AI Core: esx_context, esx_textui, esx_notify, esx_progressbar, esx_menu_default, esx_menu_dialog, esx_menu_list, qb-menu, qb-input e progressbar. Remova esses recursos: o ai-core responde pelos nomes deles. Veja Compatibilidade.
Camadas: um lugar para cada tipo de script
Itens, chaves de veículos, alertas da polícia, roupas, mortes e reanimações, prisão, combustível, trancas de portas, garagens, hora e clima, cobranças, banco, celulares, o menu radial, o HUD e as notificações passam todos pelo ai-core. Um script pede ao ai-core ("dê este item"), e o ai-core chama o script que você usa para aquela tarefa. É por isso que você pode trocar quase qualquer script ai-* por um de terceiros, e por isso o ai-core avisa no console quando dois scripts para a mesma tarefa rodam ao mesmo tempo.
Instalação
A receita do txAdmin do AI Core o instala. À mão: coloque a pasta em resources/[ai]/ e adicione ensure ai-core ao server.cfg depois de ensure ai-mysql e antes de todo outro script ai-*. Ele precisa do OneSync e do banco de dados:
add_convar_permission ai-core read mysql_connection_stringAs tabelas dele (ai_core_users, ai_core_characters, ai_core_accounts, ai_core_transactions, ai_core_character_jobs, ai_core_character_gangs, ai_core_bills, ai_core_vrp_data) são criadas na primeira inicialização. Não instale es_extended, qb-core ou qbx_core junto com ele. Mantenha set resources_useSystemChat false.
Comandos
| Comando | Argumentos | Quem | O que faz |
|---|---|---|---|
/aiadmin | nenhum | administradores | Abre o painel de administração. |
/togglepvp | nenhum | administradores | Liga ou desliga o dano entre jogadores (salva a configuração do painel). |
aicore_switch | [id] | administradores | Manda um jogador (padrão: você) de volta para a tela de personagens. |
aicore_job | <job> <grade> [id] | administradores | Dá um emprego em um cargo. |
aicore_duty | <job | off> [id] | administradores | Coloca um jogador em serviço em um emprego, ou fora de serviço. |
aicore_money | <account> <amount> [id] | administradores | Adiciona a uma conta (um valor negativo retira). |
aicore_gang | <gang> <grade> [id] | administradores | Dá uma gangue em um cargo. |
aicore_db | [slow] | administradores | Estatísticas do banco de dados de cada recurso no console do servidor; slow lista as consultas lentas recentes. |
aicore_alert | [high] | administradores | Envia um alerta de teste da polícia na sua posição pelo script de alerta ativo. |
Os comandos aicore_* são ferramentas de teste: eles respondem no console do servidor. Os comandos de administração conhecidos do QB / ESX (setjob, givemoney...) vêm com o ai-admin.
Teclas
| Tecla padrão | O que faz | Nome nas configurações do GTA |
|---|---|---|
| F10 | Abre o painel de administração (só administradores) | Open the admin panel |
Limites conhecidos
- Os jogadores precisam de uma conta do FiveM vinculada (o identificador
fivem:); jogadores sem uma não conseguem entrar. - Um script cujo substituto roda ao mesmo tempo (tgiann-inventory junto com o ai-inventory) mantém todos fora enquanto os dois rodam, se Refuse players while both run estiver ligado (padrão). O console diz o nome da pasta a apagar.