Uyumluluk
AI Core’un ESX, QBCore, Qbox ve vRP script’lerini nasıl çalıştırdığı ve üçüncü parti resource’lara nasıl bağlandığı.
FiveM script’lerinin neredeyse hepsi ESX, QBCore, Qbox veya vRP için yazılıyor; bu yüzden onları çalıştırmak ana hedeflerden biri. AI Core üçüncü parti script dağıtmaz ve hiçbir satıcıyı öne çıkarmaz: kendi script’lerini sen kurarsın.
Üç katman
Framework köprüsü (bridge)
AI Core es_extended, qb-core ve qbx_core adlarını sağlar (provide); bunların export’larını, core nesnelerini, oyuncu nesnelerini, callback’lerini, olaylarını ve dosya include’larını (@qb-core/shared/locale.lua, @es_extended/imports.lua, @qbx_core/modules/playerdata.lua) cevaplar. Böylece ESX, QBCore veya Qbox için yazılmış script’ler AI Core’u kendi framework’leri sanar ve değiştirilmeden çalışır. vRP script’leri için AI Core vrp adını da sağlar (aşağıdaki vRP script’leri bölümüne bak). Menüleri, yazı istemleri, ilerleme çubukları ve giriş pencereleri AI Core’un kendi arayüzüyle çizilir.
Entegrasyon katmanları
AI Core ve ai-* script’leri başka script’lerin sağladığı işlere ihtiyaç duyar. Her kategorinin tek bir arayüzü, desteklenen her script’in bir adaptörü vardır. AI Core yüklü script’i açılışta ve script’ler başlayıp durdukça tanır; admin panelinden seçim değiştirilebilir.
| Kategori | Örnekler |
|---|---|
| Envanter | ai-inventory, ox_inventory, qb-inventory, tgiann-inventory ve diğerleri |
| Araç anahtarı | ai-vehiclekeys, qbx_vehiclekeys ve diğerleri |
| İhbar (polis uyarıları) | ai-policealert ve ihbar script’leri |
| Telefon | tgiann-phone, lb-phone |
| Kıyafet | ai-appearance, tgiann-clothing |
| Ölüm | ai-death, qbx_medical, qb-ambulancejob, esx_ambulancejob, ars_ambulancejob |
| Hava ve saat | ai-weathersync, qb-weathersync, Renewed-Weathersync, cd_easytime |
| Hapishane | ai-prison, qb-prison |
| Radyal menü | ai-radialmenu, qb-radialmenu, ox_lib |
Yerine geçenler
Bazı ai-* script’leri yerine geçtikleri script’in API’sini cevaplar; üçüncü parti script’ler onlarla adaptörsüz çalışır: ai-mysql oxmysql’in (ayrıca mysql-async ve ghmattimysql’in), ai-inventory ox_inventory ve qb-inventory’nin, ai-target ox_target’ın, ai-voice pma-voice’un, ai-chat chat’in, ai-vehicles ve ai-vehiclekeys Qbox araç script’lerinin yerine geçer.
AI Core’un bugün hangi script’lerle entegre olduğunu uyumlu script’ler listesinde görebilirsin.
vRP script’leri
AI Core vrp adını da sağlar; böylece vRP framework’ü için yazılmış script’ler onu bulur ve AI Core’un karakterleri, parası, meslekleri, çeteleri ve envanteri üzerinde çalışır. Hiçbir ayar yoktur: aşağıdaki sürümlerin hepsi aynı anda cevaplanır, AI Core hangisi olduğunu script’in kendisini çağırma biçiminden anlar.
| vRP sürümü | Ne çalışır |
|---|---|
| vRP 1.0 | Proxy / Tunnel ile vRP.* ve vRPclient.* kullanan script’ler: kullanıcılar, para, gruplar ve yetkiler, envanter ve sandıklar, kimlik, açlık ve susuzluk, menüler, yazı istemleri, bildirimler, blip’ler ve marker’lar. |
| vRPex, Zirix, Dunko | Aynısı, artı bu vRP 1 fork’larının eklediği fonksiyonlar (format, hasPermissions, tryBankPayment ve diğerleri). |
| Eski vRP 0.5 çağrı stili | Argümanlarını bir tabloda ve bir callback ile veren çağrılar, örneğin vRP.getUserId({source}). |
| vRP 2 ve vRP 3 | Bir script’in vRP.loadScript ile yüklediği extension’lar. Her biri AI Core’un içinde kendi sandbox’ında çalışır: global’leri başka hiçbir script’e dokunmaz, resource’u durunca kaydettiği her şey kaldırılır. |
vRP script’lerinin menüleri, yazı istemleri ve evet / hayır soruları AI Core’un kendi menüsü ve pencereleriyle çizilir. Bir script vRP’nin ana menüsüne satır eklediğinde oyuncular onu F7 ile açar; tuşu admin panelinin Keybinds bölümünden değiştirebilirsin.
AI Core, çalışan bir sunucuda yedi açık kaynak vRP script’iyle test edildi: vrp_basic_mission, vrp_chests, vrp_blips, self_storages, vrp_drugfarms, vrp_worlditems ve party_system.
vRP script’i kurmak
Orijinal vRP’yi kaldır
Artık vrp resource’un AI Core, bu yüzden orijinali gitmeli. Sunucunda bir vrp klasörü ya da bir vRP veritabanı sürücüsü (vrp_mysql, vrp_oxmysql, vrp_ghmattimysql, vRP-db-drivers) varsa klasörü ve server.cfg içindeki ensure satırını sil. Bunlardan biri durdukça AI Core oyuncu girişlerini reddeder ve silinecek klasörün adını söyler.
Script’i ekle
Script’in klasörünü resources/[standalone]/ içine koy ve server.cfg dosyasına, ensure ai-* satırlarının altına ensure <klasör adı> ekle; her script’te olduğu gibi. Script’i düzenleme: vrp bağımlılığı ve @vrp/lib/utils.lua include’u AI Core’a kendiliğinden ulaşır.
Başlat ve yetkilerini dağıt
Sunucuyu yeniden başlat ve script’in özelliklerini oyunda dene. Sonra admin panelini (F10) aç ve AI Core’un vRP scripts sekmesine gir: Asked permissions, script’in sorduğu her yetki adını listeler. Her birinin kime verileceğini bir sonraki bölümde anlatıldığı gibi belirle.
vRP scripts sekmesi
vRP script’leri “bu oyuncu polis mi?” diye sormaz. Yetki adları (police.service), grup adları (police, vip) ve eşya kimlikleri (edible|tacos) sorar. Admin panelinde AI Core’un bölümündeki vRP scripts sekmesi, bu adların senin sunucunda ne anlama geldiğine karar verir. Her değişiklik anında, yeniden başlatma gerekmeden kaydedilir. Sekmede beş kart vardır:
Built-in rules (hazır kurallar)
Bu üç anahtar, hiçbir kuralın anmadığı her yetki adını cevaplar; bu yüzden birçok script daha tek bir kural eklemeden çalışır:
- Job permissions go to the job: bir mesleğin adıyla başlayan yetki, örneğin
police.service, o mesleğin üyelerine gider. Only while on duty açıksa onlarda yalnızca mesaideyken olur. - admin. permissions go to admins:
admin.ile başlayan yetki, örneğinadmin.tickets, admin yetkisi olan oyunculara gider (ACEai.admin). - player. permissions go to everyone:
player.ile başlayan yetki, örneğinplayer.phone, her oyuncuya gider.
Asked permissions (sorulan yetkiler)
Script’lerinin şimdiye kadar sorduğu her yetki adı, bir arama kutusuyla. Bir adın yanındaki Add rule düğmesine bas; onun için bir kural Permission rules listesinin en üstünde belirir. Yeni bir kural, sen kimin alacağını seçene kadar yetkiyi yalnızca adminlere verir.
Permission rules (yetki kuralları)
Her kural bir satırdır. Permission name alanına yetkiyi (police.service) ya da onunla başlayan her yetkiyi kapsaması için * ile biten bir ad (police.*) yaz. Who has it alanında birini seç:
- Members of a job: mesleği ve Lowest grade değerini seç (o rütbe ve üstündeki her rütbe). Yetki yalnızca mesaideyken geçerli olsun istiyorsan Only on duty seçeneğini aç.
- Members of a gang: çeteyi ve en düşük rütbeyi seç.
- Characters in a group: script’lerin verdiği bir grup adını yaz (bkz. Group names).
- Admins ya da Everyone.
Birden fazla kural aynı yetkiyi anabilir: herhangi birine uyan, yetkiye sahip olur. Bir kural bir yetkiyi andığı anda hazır kurallar o yetki için artık sayılmaz. Panel, meslekte ya da çetede olmayan bir rütbeyi reddeder.
Group names (grup adları)
vRP script’leri grupları adıyla verir ve kontrol eder. Bir mesleğin ya da çetenin kendi adı (police, ballas) satır gerekmeden çalışır. Script’in kullandığı başka bir ad için (Coronel, sheriff) bir satır ekle: adı Group name alanına yaz ve Means alanında ne anlama geldiğini seç:
- A job grade ya da A gang grade: bir script bu grubu verdiğinde karakter o mesleğe ya da çeteye o rütbede girer; bir script grubu kontrol ettiğinde o rütbe ve üstündeki her rütbe için cevap evettir.
- Admins: kontrol, admin yetkisi olan oyuncular için evet cevabını verir. Bir script asla birini admin yapamaz: bu grubu vermek reddedilir.
Satırı olmayan bir ad, karakterle birlikte kaydedilen kendi başına bir grup olarak kalır.
Item names (eşya adları)
Bir script’in kullandığı eşya kimliğini (Name scripts use, örneğin edible|tacos) envanterindeki bir eşyaya (Inventory item, listeden seçilir) bağla. Zaten eşyalarından birinin adı olan bir kimliğe satır gerekmez. Satır yoksa wbody|WEAPON_X silah eşyası, diğer her a|b kimliği de b demektir.
Örnek: bir polis script’i police.service soruyor ama senin polis mesleğinin adı lspd. Adı police.service olan, Members of a job seçili, mesleği lspd, en düşük rütbesi 0 ve Only on duty açık bir yetki kuralı ekle. Artık mesaideki her polis bu yetkiye sahip.
vRP ile çalışmayanlar
- Creative v5. API’si (PascalCase adlar,
@vrp/lib/Utils.lua,@vrp/config/*.lua) farklıdır ve cevaplanmaz. - vRP’nin kendi tablolarına SQL. AI Core kendi verisini tutar; bu yüzden
vrp_users,vrp_user_identities,vrp_user_data,vrp_srv_dataya da benzeri tabloları kendi sorgularıyla okuyan veya yazan bir script hiçbir şey bulamaz. - AI Core’da olmayan vRP modülleri: telefon rehberi, evler, işletmeler, sahip olunan araçlar ve garajlar, yetenekler (aptitude), polis kayıtları ve hapis, dükkânlar, eşya dönüştürücüler, ATM’ler, ses ve telsiz, ilerleme çubukları, ban ve whitelist, ve vRP 1’in görevleri (vRP 2 / 3 görevleri çalışır). Bunları kullanan bir script o kısmını kaybeder.
- Menülerde sol / sağ yok. Değeri ok tuşlarıyla değiştiren seçenekler yalnızca düz seçimi alır.
vRP:playerSpawnher karakter yüklenişinde bir kez tetiklenir, yeniden doğuştan sonra tetiklenmez: yeniden doğuş ölüm script’inin işidir.vrpher zaman başlamış görünür. Birden fazla framework’ü destekleyen ve önce vRP’ye bakan bir script, vRP kodunu kullanır. ESX ya da QBCore kodunu kullanmasını istiyorsan o framework’ü script’in kendi config’inde seç.- vRP 2 / 3 extension’ı AI Core’un içinde çalışır, bu yüzden CPU süresi
resmoniçindeai-corealtında görünür. Hata verirse konsol dosyasıyla birlikte tek bir satır yazar ve AI Core çalışmaya devam eder.
Bir ai-* script’ini değiştirmek
Bir ai-* script’inin yerine geçen ücretli bir script kurarsan (örneğin başka bir envanter), AI Core hangi klasörü silmen gerektiğini söyler ve ikisi birlikte çalıştığı sürece girişleri reddeder; böylece iki script aynı işi yapmaya çalışmaz.
Script eklemek
Yeni bir script’i desteklemek küçük ve tekrarlanabilir bir iş: kategorinin adaptör şablonunu kopyala, çağrılarını doldur, kayıt listesine bir satır ekle. Bunu yapay zekândan isteyebilirsin.