Lib: compartido y fivem
@aicore8/lib/shared y /fivem: las utilidades que funcionan en ambos lados, para qué sirve cada entrada y cada página temática.
Dos partes de la lib funcionan igual en el cliente y en el servidor:
| Entrada | Qué contiene | Dónde puedes usarla |
|---|---|---|
@aicore8/lib/shared | Utilidades simples que nunca llaman a un native de FiveM: rechazos, lectores de entrada, formato de números y texto, matemáticas de vectores, geometría de zonas, lectores de datos del panel, los textos de idioma de una página NUI. | Cliente, servidor, resource/common/ y código NUI (React). |
@aicore8/lib/fivem | Utilidades que llaman a natives que existen en ambos lados: exports entre recursos, el planificador, la gestión de la detención de recursos, el cargador de archivos de idioma. | Cliente, servidor y resource/common/. No en código NUI. |
Las entradas de cliente y de servidor reexportan todo lo de /fivem, así que en un archivo de cliente o de servidor también puedes importar esas utilidades desde @aicore8/lib/client o @aicore8/lib/server. Usa /fivem solo en los archivos de resource/common/ que empaquetan ambos lados.
import { fail, readInt, groupDigits } from "@aicore8/lib/shared";
import { resourceExport, every, createLocale } from "@aicore8/lib/fivem";Lua
Solo unas pocas de estas utilidades tienen un equivalente en Lua en aiLib (cárgalo con shared_script '@ai-lib/init.lua', consulta Lib para Lua): every, waitFor, formatText, locale, fail, numbers.round, numbers.groupDigits, numbers.headingTo y stripGameText. Cada entrada muestra la llamada Lua cuando la hay, y lo indica cuando no la hay. Lua tiene sus propias herramientas para el resto: matemáticas de vectores (#(a - b) para una distancia), Entity(e).state para los state bags, exports['name']:Fn() para los exports.
Temas
Exports entre recursos
registerExport, resourceExport, optionalExport, callExport, provideExport, isResourceStarted.
Planificación y ciclo de vida
every, onStop, caller, ByResource, Reasons, sleep, waitFor.
State bags
EntityState, PlayerState, GlobalKey, GlobalGroup y sus parsers: leer valores replicados desde la memoria.
Acciones y entrada del cliente
ActionResult, fail, isActionOk, replyError, readInt, readText, readId, readVec3, oneArg, asArgs.
Texto y números
formatText, round, groupDigits, formatWeight, stripGameText, randomInt, pickRandom, rollChance, ServerClock.
Posiciones
distance, flatDistance, headingTo, nearestOf, gridCell, cellKey.
Vehículos
plateOf, normalizePlate, vehicleTypeOfClass, toVehicleProps, toVehicleSetup.
Datos del panel
num, int, bool, str, record, vec4, spec, readRecords, RecordObjects, withoutSchemaKey.
Acceso, blips y NPC de lugares
readAccess, ACCESS_FIELDS, decideAccess, readBlipStyle, readPlacePed y sus campos del panel.
Idioma
createLocale, loadLocaleTexts, LangTexts: los archivos de idioma de tu recurso en el juego y en la NUI.
Logging
createLogger, logSafe, previewJson.
Geometría de zonas
ZoneShape, zoneContains, zoneBounds, polyFromCorners, readZoneShape.
Los tipos compartidos (Vec3, Vec4, ActionResult, AccessRule, BlipStyle, ZoneShape, VehicleProps...) se explican campo por campo en Tipos compartidos.