Lib: servidor
@aicore8/lib/server e o lado servidor do aiLib: o que são, como carregá-los em TypeScript e Lua, e todas as páginas de tópicos.
A lib do servidor é o conjunto de helpers que todo script de servidor ai-* usa em vez de escrever o mesmo código de novo: responder clientes com segurança, comandos, jogadores, itens, veículos, dinheiro, logs e o painel de administração. A maioria dos helpers que tocam outro sistema (inventário, chaves, celular, prisão...) passa pelo ai-core, então seu script continua funcionando quando o dono do servidor troca o inventário ou o script de celular.
TypeScript
Importe de @aicore8/lib/server em arquivos dentro de resource/server/. Helpers que funcionam em qualquer lado (recusas, leitores de entrada, matemática) vêm de @aicore8/lib/shared.
import { onClientCallback, inventory, notify } from "@aicore8/lib/server";
import { fail, oneArg, readId } from "@aicore8/lib/shared";Todo recurso feito a partir do template do ai-core já depende do pacote ("@aicore8/lib": "workspace:*" no package.json); o build o empacota em dist/server.js.
Lua
Recursos em Lua recebem os mesmos helpers na tabela global aiLib, do recurso ai-lib. Adicione duas linhas ao seu fxmanifest.lua:
dependency 'ai-lib'
shared_script '@ai-lib/init.lua'Depois chame aiLib.<name> em qualquer arquivo de servidor. Cada módulo carrega na primeira vez que você o usa e roda dentro do seu recurso, então os comandos e callbacks que você registra pertencem ao seu recurso e somem quando ele para.
aiLib.addCommand('hello', { help = 'Says hello' }, function(source)
aiLib.notify(source, 'Hello!', 'success')
end)Funções Lua marcadas com Espera (progressFor, minigameFor, spawnVehicle, triggerClientCallback, billing.unpaid, appearance.get) pausam o código até a resposta chegar. Elas só funcionam dentro de uma thread. Os handlers de aiLib.onClientCallback e aiLib.onClientEvent já rodam em uma; em qualquer outro lugar, envolva a chamada em CreateThread(function() ... end).
Nem todo helper de TypeScript tem um equivalente em Lua. Cada entrada informa quando não tem. Os que faltam em Lua: PendingActions, PlayerMap, Cooldowns, KeyedCooldowns, SourceLock, KeyWatchers, os helpers de posição, AreaStream, as classes de state bag, AdminPanel, DataFile e os helpers de banco de dados (recursos em Lua usam a API oxmysql do ai-mysql para SQL).
Tópicos
Entrada do cliente
onClientCallback, onClientEvent, guards, triggerClientCallback, progressFor, minigameFor, PendingActions.
Comandos
addCommand: argumentos interpretados, permissões, sugestões no chat.
Jogadores e personagens
online, onCharacter, notify, jogadores próximos, posições, PlayerMap, cooldowns, locks, limites de taxa.
Personagens, carregadas ou não
characters: encontre, leia e altere qualquer personagem através do ai-core - dinheiro, empregos, gangues, metadados, nome, tempo de jogo.
Itens
inventory: dar, tirar, contar, baús, lojas, itens usáveis.
Veículos
spawnVehicle, vehicleType, vehicleKeys, combustível, garagens, entidades a partir de net ids.
Dinheiro e banco
money.transfer, banking, billing.
Empregos e serviços
dispatch, prison, mdt, ems, medical, stress, needs, definitions, isPrimeTime.
Mundo
Hora e clima, routing buckets, portas, personagens salvos.
Celular e aparência
números de celular, e-mails, mensagens; visual salvo dos personagens.
State bags
EntityState, PlayerState, GlobalKey, GlobalGroup: escrever valores replicados.
Logs
aiLog, aiLogChannels: logs pelo ai-core para Discord, Fivemanage e mais.
Streaming por área
AreaStream: objetos do mundo enviados só aos jogadores perto deles.
Painel de administração
AdminPanel e DataFile: as configurações do seu script no painel do ai-core.
Banco de dados
createDatabaseTables, WriteQueue.
Helpers compartilhados com o cliente
A entrada do servidor também reexporta os helpers de /fivem, então você também pode importá-los de @aicore8/lib/server. Eles são documentados uma vez em Lib: compartilhada e fivem:
registerExport, resourceExport, optionalExport, callExport, provideExport, isResourceStarted, createLocale, loadLocaleTexts, LOCALE_CONVAR, ByResource, caller, onStop, plateOf, Reasons, every (com os tipos EveryOptions e Job), stateBoolean, stateNumber, stateString (tipo StateParse).
As classes de state bag EntityState, PlayerState, GlobalKey e GlobalGroup exportadas pela entrada do servidor são as versões de servidor: elas adicionam set. Veja State bags.
Dois helpers que só o ai-core usa
sendPlayerData(source, key, value) e patchPlayerData(source, key, patch) enviam um valor dos dados de um jogador (AiPlayerData) para o cliente desse jogador. O ai-core os chama; seu script nunca precisa deles. Leia os dados do jogador no cliente com getPlayerData (Lib: cliente).
Vínculos e dados do jogador
hasJob, inGang, onDutyIn, allows, onMembershipChange, getPlayerData, onPlayerData e seedPlayerData - o personagem, o dinheiro, os empregos, o serviço e as gangues do jogador local como o ai-core os envia.
Entrada do cliente
Responda aos clientes com segurança: onClientCallback, onClientEvent, guards, triggerClientCallback, barras de progresso e minigames verificados pelo servidor, PendingActions.