Lib: shared ve fivem
@aicore8/lib/shared ve /fivem: iki tarafta da çalışan yardımcılar, her girişin ne için olduğu ve tüm konu sayfaları.
Lib’in iki parçası client’ta ve server’da aynı şekilde çalışır:
| Giriş | Ne içerir | Nerede kullanabilirsin |
|---|---|---|
@aicore8/lib/shared | Hiçbir zaman FiveM native’i çağırmayan düz yardımcılar: reddetmeler, girdi okuyucular, sayı ve metin biçimlendirme, vektör matematiği, bölge geometrisi, panel verisi okuyucuları, bir NUI sayfasının dil metinleri. | Client, server, resource/common/ ve NUI (React) kodu. |
@aicore8/lib/fivem | İki tarafta da var olan native’leri çağıran yardımcılar: resource’lar arası export’lar, zamanlayıcı, resource durdurma işleme, dil dosyası yükleyicisi. | Client, server ve resource/common/. NUI kodunda değil. |
Client ve server girişleri /fivem’deki her şeyi yeniden export eder; bu yüzden bir client ya da server dosyasında bu yardımcıları @aicore8/lib/client ya da @aicore8/lib/server’dan da import edebilirsin. /fivem’i yalnızca iki tarafın da paketlediği resource/common/ dosyalarında kullan.
import { fail, readInt, groupDigits } from "@aicore8/lib/shared";
import { resourceExport, every, createLocale } from "@aicore8/lib/fivem";Lua
Bu yardımcıların yalnızca birkaçının aiLib üzerinde bir Lua karşılığı vardır (onu shared_script '@ai-lib/init.lua' ile yükle, bkz. Lua için lib): every, waitFor, formatText, locale, fail, numbers.round, numbers.groupDigits, numbers.headingTo ve stripGameText. Her girdi, varsa Lua çağrısını gösterir, yoksa bunu belirtir. Geri kalanı için Lua’nın kendi araçları vardır: vektör matematiği (mesafe için #(a - b)), state bag’ler için Entity(e).state, export’lar için exports['name']:Fn().
Konular
Resource’lar arası export’lar
registerExport, resourceExport, optionalExport, callExport, provideExport, isResourceStarted.
Zamanlama ve yaşam döngüsü
every, onStop, caller, ByResource, Reasons, sleep, waitFor.
State bag’ler
EntityState, PlayerState, GlobalKey, GlobalGroup ve ayrıştırıcıları: replike edilen değerleri bellekten okumak.
Aksiyonlar ve client girdisi
ActionResult, fail, isActionOk, replyError, readInt, readText, readId, readVec3, oneArg, asArgs.
Metin ve sayılar
formatText, round, groupDigits, formatWeight, stripGameText, randomInt, pickRandom, rollChance, ServerClock.
Konumlar
distance, flatDistance, headingTo, nearestOf, gridCell, cellKey.
Araçlar
plateOf, normalizePlate, vehicleTypeOfClass, toVehicleProps, toVehicleSetup.
Panel verisi
num, int, bool, str, record, vec4, spec, readRecords, RecordObjects, withoutSchemaKey.
Erişim, blip’ler ve yer NPC’leri
readAccess, ACCESS_FIELDS, decideAccess, readBlipStyle, readPlacePed ve panel alanları.
Dil
createLocale, loadLocaleTexts, LangTexts: resource’unun dil dosyaları oyunda ve NUI’da.
Loglama
createLogger, logSafe, previewJson.
Bölge geometrisi
ZoneShape, zoneContains, zoneBounds, polyFromCorners, readZoneShape.
Paylaşılan tipler (Vec3, Vec4, ActionResult, AccessRule, BlipStyle, ZoneShape, VehicleProps...) Paylaşılan tipler sayfasında alan alan açıklanır.