Kurulum
AI Core sunucusunu txAdmin ile birkaç dakikada ya da elle kur.
Gereksinimler
| Bağımlılık | Sürüm | Neden |
|---|---|---|
| txAdmin’li FXServer (artifact) | 38039 veya üstü | ai-core bunu ister: sunucu oyuncu ölümlerini kendisi görür. |
| MariaDB (veya MySQL) | güncel | Veritabanı. AI Core tablolarını kendisi kurar. |
| Bun | güncel | Sadece script değiştirmek veya derlemek için. Her script derlenmiş haliyle gelir; sunucu çalıştırmak için derleme aracı gerekmez. |
txAdmin ile kurulum (önerilen)
txAdmin’i başlat
Güncel FXServer artifact’ını indirip başlat: txAdmin tarayıcıda açılır. Resmi rehberi kurulum (deployment) adımına kadar izle.
AI Core recipe’sini kullan
Popular Recipes > Remote URL Template seçeneğini seç ve şunu yapıştır:
https://raw.githubusercontent.com/aicore8/aicore-server/main/recipe/ai-core.yamlBilgileri doldur
Sunucu adını, portal.cfx.re’den aldığın lisans anahtarını ve veritabanını gir. Recipe server.cfg ve env.cfg dosyalarını yazar, veritabanına bağlanır ve tüm ai-* script’lerini indirir. İçe aktarılacak SQL dosyası yok: AI Core ve script’ler ilk açılışta kendi tablolarını kurar ve günceller.
Kendini admin yap
Sunucuya gir. Bir karşılama kartı seni admin yapacak satırı gösterir: bu satırı permission.cfg dosyasına ekleyip sunucuyu yeniden başlat. Sonra F10 ile admin panelini aç; kurulum rehberi ilk ayarlarda sana yol gösterir.
Sunucu listesindeki ad, açıklama, etiketler, dil, banner’lar ve Discord bağlantısı server.cfg’den değil portal.cfx.re/servers üzerinden ayarlanır.
Elle kurulum
Sunucu klasörünü al
Sunucu klasörünü (cfg dosyaları, recipe/, tools/, template/) indir. Her ai-* script’i için GitHub’daki son release’ten <name>.zip dosyasını indir ve resources/[ai]/ içine aç. Kaynak olmadan sadece sunucunun çalıştırdığı dosyaları istiyorsan onun yerine <name>-runtime.zip dosyasını kullan.
Gizli ayarları gir
env.example.cfg dosyasını env.cfg olarak kopyala, lisans anahtarını ve veritabanı bağlantısını yaz, sonra veritabanını oluştur.
Sunucuyu başlat
FXServer’ı (txAdmin) bu klasörü sunucu veri klasörü olarak göstererek başlat.
Klasör yapısı
| Yol | Ne |
|---|---|
server.cfg | Resource listesi ve config dosyaları. |
env.cfg | Lisans, slot, endpoint, veritabanı, RCON. Makineye özel, git’e girmez. |
security.cfg | Sıkı FiveM güvenlik ayarları. Gevşetme: her script bu değerlere göre yazıldı. |
permission.cfg | Adminler ve ACE yetkileri. |
misc.cfg | Dil ve diğer ortak convar’lar. |
resources/[ai]/ | AI Core script’leri; her ai-* script’i için bir klasör. |
resources/[standalone]/ | Eklediğin üçüncü parti resource’lar. |
packages/ | @aicore8/* paketleri (geliştiriciler için). |
template/ | Yeni script şablonu: bun run new <ad> "<açıklama>". |