Lib: servidor
@aicore8/lib/server y el lado de servidor de aiLib: qué son, cómo cargarlos en TypeScript y Lua, y cada página temática.
La lib de servidor es el conjunto de utilidades que usa cada script de servidor ai-* en lugar de escribir el mismo código otra vez: responder a los clientes de forma segura, comandos, jugadores, objetos, vehículos, dinero, logs y el panel de administración. La mayoría de las utilidades que tocan otro sistema (inventario, llaves, teléfono, prisión...) pasan por ai-core, así que tu script sigue funcionando cuando el dueño del servidor cambia el script de inventario o de teléfono.
TypeScript
Importa desde @aicore8/lib/server en los archivos bajo resource/server/. Las utilidades que funcionan en cualquier lado (rechazos, lectores de entrada, matemáticas) vienen de @aicore8/lib/shared.
import { onClientCallback, inventory, notify } from "@aicore8/lib/server";
import { fail, oneArg, readId } from "@aicore8/lib/shared";Cada recurso creado a partir de la plantilla de ai-core ya depende del paquete ("@aicore8/lib": "workspace:*" en package.json); la compilación lo empaqueta en dist/server.js.
Lua
Los recursos Lua obtienen las mismas utilidades en la tabla global aiLib desde el recurso ai-lib. Añade dos líneas a tu fxmanifest.lua:
dependency 'ai-lib'
shared_script '@ai-lib/init.lua'Después llama a aiLib.<name> en cualquier archivo de servidor. Cada módulo se carga la primera vez que lo usas y se ejecuta dentro de tu recurso, así que los comandos y callbacks que registras pertenecen a tu recurso y desaparecen cuando se detiene.
aiLib.addCommand('hello', { help = 'Says hello' }, function(source)
aiLib.notify(source, 'Hello!', 'success')
end)Las funciones Lua marcadas con Espera (progressFor, minigameFor, spawnVehicle, triggerClientCallback, billing.unpaid, appearance.get) pausan el código hasta que llega la respuesta. Solo funcionan dentro de un hilo. Los handlers de aiLib.onClientCallback y aiLib.onClientEvent ya se ejecutan en uno; en cualquier otro sitio, envuelve la llamada en CreateThread(function() ... end).
No todas las utilidades de TypeScript tienen un equivalente en Lua. Cada entrada lo indica cuando no lo tiene. Las que faltan en Lua: PendingActions, PlayerMap, Cooldowns, KeyedCooldowns, SourceLock, KeyWatchers, las utilidades de posición, AreaStream, las clases de state bags, AdminPanel, DataFile y las utilidades de base de datos (los recursos Lua usan la API oxmysql de ai-mysql para SQL).
Temas
Entrada del cliente
onClientCallback, onClientEvent, guardas, triggerClientCallback, progressFor, minigameFor, PendingActions.
Comandos
addCommand: argumentos procesados, permisos, sugerencias de chat.
Jugadores y personajes
online, onCharacter, notify, jugadores cercanos, posiciones, PlayerMap, cooldowns, bloqueos, límites de frecuencia.
Personajes, cargados o no
characters: encuentra, lee y cambia cualquier personaje a través de ai-core - dinero, trabajos, bandas, metadatos, nombre, tiempo jugado.
Objetos
inventory: dar, quitar, contar, almacenes, tiendas, objetos usables.
Vehículos
spawnVehicle, vehicleType, vehicleKeys, combustible, garajes, entidades a partir de net ids.
Dinero y banca
money.transfer, banking, billing.
Trabajos y servicios
dispatch, prison, mdt, ems, medical, stress, needs, definiciones, isPrimeTime.
Mundo
Hora y clima, routing buckets, puertas, personajes guardados.
Teléfono y apariencia
números de teléfono, correos, mensajes; aspecto guardado de los personajes.
State bags
EntityState, PlayerState, GlobalKey, GlobalGroup: escribir valores replicados.
Logs
aiLog, aiLogChannels: logs a través de ai-core a Discord, Fivemanage y más.
Streaming por áreas
AreaStream: objetos del mundo enviados solo a los jugadores cercanos.
Panel de administración
AdminPanel y DataFile: los ajustes de tu script en el panel de ai-core.
Base de datos
createDatabaseTables, WriteQueue.
Utilidades compartidas con el cliente
La entrada de servidor también reexporta las utilidades de /fivem, así que puedes importarlas también desde @aicore8/lib/server. Se documentan una sola vez en Lib: compartido y fivem:
registerExport, resourceExport, optionalExport, callExport, provideExport, isResourceStarted, createLocale, loadLocaleTexts, LOCALE_CONVAR, ByResource, caller, onStop, plateOf, Reasons, every (con los tipos EveryOptions y Job), stateBoolean, stateNumber, stateString (tipo StateParse).
Las clases de state bags EntityState, PlayerState, GlobalKey y GlobalGroup exportadas desde la entrada de servidor son las versiones de servidor: añaden set. Consulta State bags.
Dos utilidades que solo usa ai-core
sendPlayerData(source, key, value) y patchPlayerData(source, key, patch) envían un valor de los datos de un jugador (AiPlayerData) al cliente de ese jugador. ai-core las llama; tu script nunca las necesita. Lee los datos del jugador en el cliente con getPlayerData (Lib: cliente).
Pertenencia y datos del jugador
hasJob, inGang, onDutyIn, allows, onMembershipChange, getPlayerData, onPlayerData y seedPlayerData - el personaje, el dinero, los trabajos, el servicio y las bandas del jugador local tal como los envía ai-core.
Entrada del cliente
Responde a los clientes de forma segura: onClientCallback, onClientEvent, guardas, triggerClientCallback, barras de progreso y minijuegos comprobados por el servidor, PendingActions.