ai-core
Framework. Oyuncular ve karakterler, karakter ekranı, para, meslekler ve çeteler, yetkiler, admin paneli ve ESX, QBCore, Qbox ve vRP köprüsü.
ai-core, AI Core’un kendisidir: diğer her script’in üzerine kurulduğu framework. Kimin oynadığını, hangi karakteri seçtiğini, ne kadar parası olduğunu, hangi mesleklere ve çetelere üye olduğunu ve kimin admin olduğunu bilir. Her script için admin panelini barındırır ve ESX, QBCore, Qbox ve vRP script’lerinin değiştirilmeden çalışmasını sağlar.
Bu sayfa bir genel bakıştır. Admin paneli ayrıca Admin paneli sayfasında anlatılıyor.
Oyuncular ve karakterler
- Hesaplar. Bir oyuncu FiveM hesabıyla (
fivem:identifier’ı) tanınır. Hesabı olmadan bağlanan reddedilir. License ve Discord id’leri de onu okuyan script’ler için yanında saklanır. - Hesap başına birden çok karakter (varsayılan 3 slot). Sen kapatmadıkça oyuncular karakter silebilir.
- Karakter ekranı. Oyuncunun karakterleri şehrin gerçek bir sahnesinde, her biri kendi kıyafetiyle durur; kamera seçilene doğru süzülür. Sunucu adın, alt başlığın ve sloganın ekranda görünür.
- Karakter oluşturma ad ve soyad, doğum tarihi (varsayılan en düşük yaş 18), cinsiyet ve uyruk sorar. Yeni karakter sonra kıyafet oluşturucudan (ai-appearance ya da başka bir kıyafet script’i) geçer.
- Nerede doğacağı. Yeni karakter First spawn (İlk doğuş) noktasında doğar. İstersen karakter seçildikten sonra son konumu ve belirlediğin yerleri gösteren bir liste açılır.
- Kayıt. Para ve üyelikler anında kaydedilir. Konum, zırh ve diğer küçük değişiklikler her 5 dakikada bir (panel), çıkışta, resource durduğunda ve txAdmin kapanırken kaydedilir.
- PvP. Oyuncuların birbirine zarar verip veremeyeceğine tek bir anahtar karar verir (varsayılan açık); adminler bunu oyunda
/togglepvpile değiştirir.
Para
- Varsayılan hesaplar Cash (başlangıçta 500), Bank (5000), Dirty money ve Crypto. Hesapları panelde (Money accounts) ekler, yeniden adlandırır ya da kaldırırsın; her birinin bir başlangıç miktarı ve sıfırın altına düşüp düşemeyeceği vardır.
- Mesleklerin ve çetelerin de kendi hesapları vardır (şirket parası).
- Her değişiklik bir hesap defteri satırıyla yazılır: kim, ne kadar, sebep.
Meslekler ve çeteler
- Karakter başına birden çok meslek (varsayılan 3, Several jobs per character kapalıysa bir) ve tek bir aktif çeteyle birden çok çete (varsayılan 2).
- Mesai. Bir karakter en fazla bir meslekte mesaide olur. Maaş sadece mesaideki meslekten gelir. Keep duty after rejoining (Yeniden girişte mesaiyi koru) açık değilse oyuncular girdikten sonra mesai dışında başlar.
- Maaş. Her 15 dakikada bir (panel) mesaideki oyunculara kademelerinin maaşı banka hesaplarına yatar; ödemeyi server yapar ya da, istersen, mesleğin kendi hesabı.
- Prime time. Yoğun saatlerin (varsayılan 18:00 ile 01:00) dışında maaşlar yarıya düşer. Saatler, kesinti ve anahtar paneldedir; bir mesleğin kendi saatleri olabilir.
- Meslekler ve çetelerin kendisi (kademeler, maaşlar, patron kademeleri) panelin Jobs ve Gangs sekmelerindeki kayıtlardır.
Yetkiler
- Adminler ACE
ai.adminyetkisine sahip oyunculardır. Tarifinpermission.cfgdosyası bunugroup.admingrubuna verir; bir oyuncuyuadd_principal identifier.fivem:<id> group.adminile eklersin. Yeni bir sunucuda karşılama kartı tam satırı gösterir. - AI Core’un lib’iyle yazılan komutlar yetkiyi server’da kontrol eder: herkes, adminler ya da belirli ACE’ler ve gruplar. Panelin Commands sekmesi her komutu kimin kullanabileceğiyle listeler.
- Meslek ve çete yetkileri. ai-core üyelikleri ACE principal’larına yansıtır:
ai.job.<name>veai.job.<name>.<grade>(oyuncunun kademesine kadar her kademe), çeteler için de aynısı. Böyleceadd_ace ai.job.police command.mdt allowher polise bir komut verir.
Admin paneli
ai-core oyun içi paneli (F10 ya da /aiadmin) kendisi ve her ai-* script’i için barındırır. Kendi bölümleri:
| Bölüm | Ne ayarlanır |
|---|---|
| General | Sunucu adı, alt başlık, slogan ve arka plan; karakter slotları, silme, en düşük yaş; kayıt aralığı; AI Core’un hangi envanter, anahtar, polis ihbarı, kıyafet, yakıt, kapı kilidi, garaj, bildirim, fatura, banka, MDT ve sağlık script’ini kullandığı (Automatic çalışan ilk script’i seçer); istem ya da hedef etkileşimi; PvP; güncelleme kontrolleri; gereksiz bir script çalışırken oyuncuları reddetme; kurulum rehberi. |
| Spawn points | İlk doğuş noktası ve oyuncuların seçebileceği yerler. |
| Character screen | Karakter ekranının arkasındaki sahne: kamera, saat ve hava, karakterlerin durduğu noktalar. |
| Job and gang rules | Kaç meslek ve çete, yeniden girişte mesai, maaş, prime time. |
| Jobs, Gangs | Kademeleri, maaşları ve patron kademeleriyle her meslek ve çete. |
| Money accounts | Para türleri ve yeni bir karakterin neyle başladığı. |
| Keybinds | Her script’in tuşları: herkes için varsayılan tuş ve HUD’ın onu ipucu olarak gösterip göstermediği. |
| Commands | Sunucudaki her komut, argümanları ve kimin kullanabileceği. |
| Other panels | Diğer script’lerin ayar ekranları, gösterge panelinden açılır. |
| vRP scripts | vRP script’lerinin istediği yetkileri, grupları ve eşyaları kimin alacağı. |
| Logs | Konsol, Discord, Fivemanage ve FiveM Stats, seviyeler, webhook’lar. |
Ayrıca GitHub deposu olan her script’i güncellemeler için kontrol eder (script başına 6 saatte bir) ve gösterge panelinde kurmaya değer ücretsiz script’ler önerir.
Köprü (ESX, QBCore, Qbox, vRP)
ai-core es_extended, qb-core, qbx_core ve vrp adlarını sağlar (provide) ve onların export’larını, core nesnelerini ve event’lerini cevaplar. Bu framework’ler için yazılmış script’ler AI Core’u kendi framework’leri olarak görür: ESX.GetPlayerFromId, QBCore.Functions.GetPlayer, exports.qbx_core:GetPlayer, vRP 1, 2 ve 3 çağrılarının hepsi AI Core’un oyuncuları, parası ve meslekleri üzerinde çalışır.
Framework arayüz resource’larını da AI Core’un kendi menüleri ve kartlarıyla çizer: esx_context, esx_textui, esx_notify, esx_progressbar, esx_menu_default, esx_menu_dialog, esx_menu_list, qb-menu, qb-input ve progressbar. Bu resource’ları kaldır: ai-core onların adlarını cevaplar. Bkz. Uyumluluk.
Katmanlar: her script türü için tek bir yer
Eşyalar, araç anahtarları, polis ihbarları, kıyafet, ölümler ve diriltmeler, hapishane, yakıt, kapı kilitleri, garajlar, saat ve hava, faturalar, bankacılık, telefonlar, radyal menü, HUD ve bildirimler hep ai-core üzerinden geçer. Bir script ai-core’dan bir şey ister ("bu eşyayı ver"), ai-core da o iş için çalıştırdığın script’i çağırır. Neredeyse her ai-* script’ini bir üçüncü parti script’le değiştirebilmenin ve aynı iş için iki script aynı anda çalıştığında ai-core’un bunu konsolda sana söylemesinin sebebi budur.
Kurulum
AI Core txAdmin tarifi kurar. Elle: klasörü resources/[ai]/ içine koy ve server.cfg dosyasına ensure ai-mysql satırından sonra, diğer her ai-* script’inden önce ensure ai-core ekle. OneSync ve veritabanı gerektirir:
add_convar_permission ai-core read mysql_connection_stringTabloları (ai_core_users, ai_core_characters, ai_core_accounts, ai_core_transactions, ai_core_character_jobs, ai_core_character_gangs, ai_core_bills, ai_core_vrp_data) ilk açılışta oluşturulur. Yanına es_extended, qb-core ya da qbx_core kurma. set resources_useSystemChat false satırını koru.
Komutlar
| Komut | Argümanlar | Kim | Ne yapar |
|---|---|---|---|
/aiadmin | yok | adminler | Admin panelini açar. |
/togglepvp | yok | adminler | Oyuncudan oyuncuya hasarı açar ya da kapatır (panel ayarını kaydeder). |
aicore_switch | [id] | adminler | Bir oyuncuyu (varsayılan: sen) karakter ekranına geri gönderir. |
aicore_job | <job> <grade> [id] | adminler | Bir kademede meslek verir. |
aicore_duty | <job | off> [id] | adminler | Bir oyuncuyu bir meslekte mesaiye alır ya da mesaiden çıkarır. |
aicore_money | <account> <amount> [id] | adminler | Bir hesaba ekler (negatif miktar düşer). |
aicore_gang | <gang> <grade> [id] | adminler | Bir kademede çete verir. |
aicore_db | [slow] | adminler | Server konsolunda her resource’un veritabanı istatistikleri; slow son yavaş sorguları listeler. |
aicore_alert | [high] | adminler | Aktif ihbar script’i üzerinden bulunduğun konuma test polis ihbarı gönderir. |
aicore_* komutları test araçlarıdır: server konsolunda cevap verirler. Alışık olunan QB / ESX admin komutları (setjob, givemoney...) ai-admin ile gelir.
Tuşlar
| Varsayılan tuş | Ne yapar | GTA ayarlarındaki adı |
|---|---|---|
| F10 | Admin panelini açar (sadece adminler) | Open the admin panel |
Bilinen sınırlar
- Oyuncuların bağlı bir FiveM hesabı (
fivem:identifier’ı) olmalı; olmayan oyuncular giremez. - Yerine geçen script’i aynı anda çalışan bir script (ai-inventory yanında tgiann-inventory), Refuse players while both run (İkisi çalışırken oyuncuları reddet) açıksa (varsayılan) ikisi çalıştığı sürece herkesi dışarıda tutar. Konsol silinecek klasörün adını verir.