AI Core

Genel bakış

AI Core nasıl kuruldu - depolar, derleme, her script’in uyduğu kurallar.

AI Core baştan sona TypeScript. Her resource overextended/fivem-ts düzenini izler; Lua sadece ai-core içindeki ESX / QB / Qbox köprüsünde ve ai-lib’in Lua tarafında kullanılır.

Depolar

DepoNe
Sunucu klasörüserver.cfg ve diğer cfg dosyaları, recipe/ (txAdmin), tools/, template/, yapay zekâ araçları için kurallar ve dokümanlar. Aynı zamanda bun workspace kökü.
ai-core ve her ai-*Script başına bir depo, sadece kaynak. Her release, derleme çıktısını ve kaynağı içeren bir zip ekler; sunucular derleme aracı olmadan çalışır.
packagesnpm paketleri: @aicore8/lib (yardımcılar), @aicore8/mysql (veritabanı motoru), @aicore8/shared (resource’lar arası sözleşmeler), @aicore8/build (derleme adımları).

Derleme

bun run setup          # sunucu klasöründe: packages/ ve her ai-* script’ini klonlar
bun install            # sunucu klasöründe: paketleri ve her resource’u bağlar
bun run build          # her resource (yaklaşık 40 sn) ya da: bun run build ai-core ai-fuel
bun run typecheck
bun run lint

Bir resource içinde aynı komutlar sadece o resource için çalışır; bun run dev izler. fxmanifest.lua package.json’dan üretilir: elle düzenleme. Derlemeden sonra resource’u (bun tools/rcon.ts "ensure ai-fuel") ya da ai-core’dan sonrakilerin hepsini (bun tools/restart.ts) yeniden başlat. Release zip’inden gelen bir script kendi başına derlenir: klasöründe bun install && bun run build (@aicore8/* paketleri npm’den gelir).

Her script’in uyduğu kurallar

  • Karar sunucunun. Client’tan gelen her istek lib’in kapısından geçer (onClientEvent / onClientCallback): gerçek oyuncu kontrolü, hız sınırı, koruyucular (admin, karakteri var, bir noktaya yakın), argüman ayrıştırıcı. Para, eşya ve yetkiler client’ta değişmez.
  • Snapshot ve delta. Canlı veri client’lara bir kez tam, sonra sadece değişenler olarak ve sadece ihtiyacı olana gider. Sürekli sorgulama ve "değişti, tekrar çek" sinyali yok.
  • Önce lib. Etkileşim noktaları, blip’ler, alanlar, tuşlar, komutlar, menüler, ilerleme, araçlar, state bag’ler ve periyodik işler @aicore8/lib’den gelir; elle yazılmış ikinci bir kopya hatadır.
  • Her şey panelde. Sunucu sahibinin ayarladığı her şey admin panelinde (schema.ts + data/*.json), asla bir config dosyasında değil.
  • AI Core üzerinden. Eşyalar, araç anahtarları, ihbarlar, telefon, hava, hapishane, kıyafet ve ölümler AI Core’un katmanlarından geçer; belirli bir script’in export’larından değil.
  • Önce ölçek. Koleksiyonlar milyonlarca kayıt için tasarlanır ve benchmark’larla ölçülür.

Kuralların tamamı sunucu klasöründe: CLAUDE.md ve .claude/rules/.

API başvurusu

Export’lar, olaylar ve imzasıyla her lib yardımcısı: API başvurusu.

Bu sayfada