ai-inventory
Eşya boyutlu grid envanter, hızlı slotlar, yere atılan eşyalar, depolar, bagajlar ve torpidolar, dükkânlar, üretim ve silahlar. ox_inventory ve qb-inventory API’lerini cevaplar.
ai-inventory bir grid envanterdir: her eşya belli sayıda hücre kaplar (telefon 1x1, tüfek 4x2) ve sürüklerken döndürülebilir. Oyuncunun eşyalarını, yeri, depoları, araç bagajlarını ve torpidolarını, dükkânları ve üretim tezgâhlarını ve eşya olarak silahları tutar.
Oyunda ne yapar
- Grid. Her envanterin sütun sayısı aynıdır; sadece satırlar ve ağırlık sınırı farklıdır. Eşyaların hücre cinsinden bir boyutu ve bir ağırlığı vardır; envanter sığmayanı ya da çok ağır olanı reddeder.
- Ekran (F2): karakterin etrafında iki sütunda kıyafetleri, beş hızlı slot, oyuncunun grid’i ve sağda ikinci envanter (yer, bagaj, depo, dükkân, tezgâh). Bir kıyafet parçasına tıklamak onu çıkarır ya da geri giydirir.
- Hızlı slotlar. Kendilerine ait beş slot (grid hücresi değil). 1 ile 5 tuşları onları kullanır; TAB onları altta bir çubuk olarak gösterir.
- Eşya kullanmak. Çift tık ya da eşya menüsü. Yiyecek ve içecek bir animasyon oynatır, açlık ve susuzluğu doldurur (ai-hud) ve tükenir. Server, animasyondan sonra eşyanın hâlâ orada olduğunu kontrol eder.
- Ver, yere at, böl. Eşya menüsü en yakın oyuncuya verir, yere atar ya da bir yığını böler.
- Yere atılan eşyalar. Atılan eşyalar yerde bir torbada durur. Kendi torbanın yanına atmak ona ekler. Torbalar birkaç dakika dokunulmayınca kaybolur.
- Bagajlar ve torpidolar. Bir aracın arkasında F2 bagajını açar (kilitli değilse); aracın içinde torpidosunu. Sahipli bir aracın bagajı, hangi plakayı takarsa taksın araçla kalır; diğer her aracın bagajı geçicidir.
- Depolar. Sabit yerlerde, ortak ya da karakter başına bir tane, herkese ya da bazı mesleklere ve çetelere açık depolama.
- Dükkânlar. Ürünleri ve fiyatları, harita blip’i ve isteğe bağlı bir NPC’si olan yerler; ödeme (ayarlandığı gibi) önce nakitten sonra bankadan.
- Üretim tezgâhları. Malzemeleri birkaç saniyede eşyaya dönüştüren tarifler.
- Silahlar. Silahlar seri numaralı eşyalardır. Mermi bir eşyadır; R ondan şarjör doldurur. Aksesuarlar (fener, susturucu...) eldeki silaha takılan eşyalardır. GTA’nın silah çarkı varsayılan olarak kapalıdır: silahlar hızlı slotlardan gelir.
- Nadirlikler. Eşyalar, rengi kutularını boyayan bir nadirliğe ait olabilir.
- Başka yerden gelen silahlar. ai-inventory’nin vermediği bir silah oyuncudan alınır.
Kurulum
AI Core txAdmin tarifi kurar. Elle: klasörü resources/[ai]/ içine koy ve server.cfg dosyasına ensure ai-core satırından sonra ensure ai-inventory ekle. ai-core ve veritabanı gerektirir:
add_convar_permission ai-inventory read mysql_connection_stringai_inventory_inventories tablosu ilk açılışta oluşturulur. Eşya resimleri resource’un dist/web/images klasörüne gider (ox_inventory resimleri onunla birlikte gelir).
ox_inventory’yi ve qb-inventory’yi kaldır: ai-inventory onların adlarını cevaplar.
Panel ayarları
Admin panelini (F10) aç ve Inventory’yi seç.
Items sekmesi
Oyunda var olan her eşya. Her eşya bir kayıttır; anahtarı (water, lockpick) script’lerin kullandığı eşya adıdır. Script 242 eşyayla gelir (ox_inventory’nin listelerinden alınmış).
Item (Eşya): oyuncuların gördüğü ad ve eşyanın türü.
| Ayar | Neyi değiştirir | Değerler | Yeni eşya için varsayılan |
|---|---|---|---|
| Name | Oyuncuların gördüğü ad. | en fazla 48 karakter | |
| Description | Adın altındaki bir satır. | en fazla 240 karakter | |
| Kind | Item (eşya), Weapon (kullanınca ele alınır), Ammo (eldeki silahı doldurur), Attachment (eldeki silaha takılır). | Item / Weapon / Ammo / Attachment | Item |
| Rarity | Eşyanın kutusunu bir nadirliğin rengiyle boyar (Rarities sekmesi). Boş: düz bir kutu. | bir nadirlik | yok |
| Picture | Resimler klasöründeki dosya adı (water.png) ya da tam bir https bağlantısı. Boş bir simge gösterir. | en fazla 200 karakter | |
| Other names | Diğer script’lerin bu eşya için kullandığı adlar (örneğin pistol_ammo), böylece onlar da çalışmaya devam eder. | en fazla 30 ad |
Size and weight (Boyut ve ağırlık): eşyanın kaç hücre kapladığı ve ne kadar ağır olduğu.
| Ayar | Neyi değiştirir | Değerler | Varsayılan |
|---|---|---|---|
| Width | Soldan sağa hücreler. Oyuncular bir eşyayı sürüklerken döndürebilir. | 1 ile 8 hücre | 1 |
| Height | Yukarıdan aşağıya hücreler. | 1 ile 8 hücre | 1 |
| Weight | Birim başına gram (1000 g = 1 kg). | 0 ile 1,000,000 g | 100 |
| Stack size | Bir yığındaki en fazla birim. 1, kendi verisi olan eşyalar için her birimi ayrı yapar. | 1 ile 100,000 | 10 |
Using (Kullanım): bir oyuncu eşyayı kullandığında ne olduğu.
| Ayar | Neyi değiştirir | Değerler | Varsayılan |
|---|---|---|---|
| Can be used | Kapalı: bir script bu eşyayı işlemedikçe kullanmak hiçbir şey yapmaz. | açık / kapalı | kapalı |
| Used up per use | Her kullanımda düşülen birim. 0 eşyayı tutar. | 0 ile 1000 | 0 |
| Close the inventory | Eşya kullanılınca envanter ekranını kapatır. | açık / kapalı | kapalı |
| Animation | Kullanırken oynatılır. | None / Eat / Drink / Bandage / Put on armour | None |
| Use time | Eşya etki etmeden önce animasyonun ne kadar oynadığı. | 0 ile 60,000 ms | |
| Hunger | Kullanınca oyuncunun açlığına eklenir (eksi düşürür). İhtiyaçları takip eden bir HUD gerektirir. | -100 ile 100 | |
| Thirst | Susuzluğa eklenir. | -100 ile 100 | |
| Stress | Strese eklenir. | -100 ile 100 |
Weapon (Silah): sadece silahlar ve aksesuarlar için.
| Ayar | Neyi değiştirir | Değerler | Varsayılan |
|---|---|---|---|
| Ammo item | Silahın doldurduğu eşya adı (örneğin ammo-9). | bir eşya adı | |
| Thrown | El bombaları ve benzerleri: yığın sayısı mermidir. | açık / kapalı | kapalı |
| Attachment hashes | Bu aksesuarın olabileceği GTA component adları (COMPONENT_AT_PI_FLSH); eldeki silahın aldığı ilki kullanılır. | en fazla 20 ad |
Bir eşyayı silmek: ona sahip oyuncular kimsenin kullanamadığı bir yığın tutmaya devam eder.
Rarities sekmesi
Eşyaların ait olduğu renk grupları. Gelenler: Common, Uncommon, Rare, Epic, Legendary, Medical, Special.
| Ayar | Neyi değiştirir | Değerler |
|---|---|---|
| Name | Nadirliğin adı. | en fazla 32 karakter |
| Colour | Bu nadirlikteki her eşyanın kutusu bununla boyanır. | bir renk |
Bir nadirliği silmek: eşyaları renklerini kaybeder.
Shops sekmesi
Oyuncuların eşya satın aldığı yerler. Script 45 dükkânla gelir (24/7, LTD, Rob's Liquor, hırdavatçılar, Ammu-Nation ve diğerleri, artı polis ve EMS için meslek dükkânları).
Shop (Dükkân): dükkânın nerede olduğu ve orada kimin alışveriş yapabileceği.
| Ayar | Neyi değiştirir | Değerler | Yeni dükkân için varsayılan |
|---|---|---|---|
| Shop name | Oyuncuların gördüğü ad. | en fazla 48 karakter | |
| Place | Oyuncuların onu açması gereken yerde dur ve konumunu kullan. | bir nokta | |
| Reach | Bir oyuncunun onu açmak için ne kadar yakın olması gerektiği. | 0.5 ile 30 m | 2 |
| Jobs | Sadece bu mesleklerin üyeleri kullanabilir. Herkes için meslekleri ve çeteleri boş bırak. | meslek adları | boş |
| Gangs | Bu çetelerin üyeleri de kullanabilir. | çete adları | boş |
| Only on duty | Meslek üyeleri o meslekte mesaide olmalı. | açık / kapalı | kapalı |
| Map blip | Dükkânı haritada gösterir. | açık / kapalı | açık |
| Blip look | Blip’in resmi, rengi ve boyutu (blip açıkken). | sprite, renk, boyut | |
| Paid from | Sırayla denenen para hesapları. | en fazla 5 hesap | cash, bank |
Products (Ürünler): dükkânın sattığı eşyalar ve birim fiyatları. En fazla 100 satır, her biri Item ve Price (0 ile 100,000,000 $).
NPC: dükkânda duran bir tezgâhtar. Model (hiç olmaması için boş, 50 m içinde görünür), What it does (bir bekleme animasyonu), Where it stands (zemindeki nokta ve yön; verilmezse dükkânın noktasında durur).
Stashes sekmesi
Sabit yerlerde depolama. Gelen: bir Police Locker.
| Ayar | Neyi değiştirir | Değerler | Yeni depo için varsayılan |
|---|---|---|---|
| Stash name | Oyuncuların gördüğü ad. | en fazla 48 karakter | |
| Place | Oyuncuların onu açtığı yer. | bir nokta | |
| Reach | Bir oyuncunun ne kadar yakın olması gerektiği. | 0.5 ile 30 m | 1.5 |
| Jobs, Gangs, Only on duty | Kimin açabileceği (dükkânlardaki gibi). | herkes | |
| One per character | Açık: her karakterin kendi içeriği olur. Kapalı: açabilen herkes tek bir depoyu paylaşır. | açık / kapalı | kapalı |
| Rows | Hücre satırları; genişlik Columns ayarıdır. | 1 ile 50 | 6 |
| Weight limit | Gram. 0 sınır yok demektir. | 0 ile 10,000,000 g | 100,000 |
Bir depoyu silmek: içinde saklanan eşyalar veritabanında kalır.
Crafting sekmesi
Oyuncuların malzemeleri eşyaya dönüştürdüğü tezgâhlar. Gelen: bir Workbench.
Bench (Tezgâh): dükkânlardaki gibi Bench name, Place, Reach (varsayılan 1.5 m), Jobs, Gangs, Only on duty.
Recipes (Tarifler): en fazla 50 satır.
| Ayar | Neyi değiştirir | Değerler | Yeni satır için varsayılan |
|---|---|---|---|
| Makes | Yapılan eşya. | bir eşya adı | lockpick |
| Amount | Kaç tane yapıldığı. | 1 ile 1000 | 1 |
| Time | Ne kadar sürdüğü. | 0 ile 600 sn | 5 |
| Materials | Ne kullandığı, virgülle ayrılmış item:count olarak: scrapmetal:3, paperbag:1. | en fazla 400 karakter | scrapmetal:3 |
Settings sekmesi
Envanterlerin ne kadar büyük olduğu.
| Kart | Ayar | Neyi değiştirir | Değerler | Varsayılan |
|---|---|---|---|---|
| Grid | Columns | Her envanterde satır başına hücre. Artık sığmayan eşyalar boş hücrelere taşınır; buna yer kalmayacak kadar dolu bir envanter ek satırlar alır. | 6 ile 14 | 8 |
| Grid | No GTA weapon wheel | GTA’nın silah çarkı ve fare tekerleğiyle silah değiştirme kapalı kalır: silahlar hızlı slotlardan (1-5) alınır. | açık / kapalı | açık |
| Player inventory | Rows | Bir karakterin taşıyabileceği, satır cinsinden. | 1 ile 50 | 20 |
| Player inventory | Weight limit | Gram; 0 = sınır yok. | 0 ile 10,000,000 g | 40,000 |
| Ground | Rows | Yerdeki bir torbanın boyutu. | 1 ile 50 | 6 |
| Ground | Weight limit | Gram; 0 = sınır yok. | 0 ile 10,000,000 g | 1,000,000 |
| Ground | Disappears after | Yerdeki eşyalar bu kadar süre kimse dokunmayınca kaybolur. | 1 ile 240 dk | 15 |
| Ground | Bags per player | Bir karakterin aynı anda yerde kaç torbası olabileceği. | 1 ile 100 | 10 |
| Trunk | Rows | Her aracın bagajı. | 1 ile 50 | 5 |
| Trunk | Weight limit | Gram; 0 = sınır yok. | 0 ile 10,000,000 g | 80,000 |
| Glovebox | Rows | Her aracın torpidosu. | 1 ile 50 | 2 |
| Glovebox | Weight limit | Gram; 0 = sınır yok. | 0 ile 10,000,000 g | 10,000 |
Sütun, satır ya da ağırlık değişikliği açık ekranlara anında ulaşır.
Komutlar
Kendine ait yok. Adminler eşyaları ai-admin’in eşya araçlarıyla verir ve alır.
Tuşlar
| Varsayılan tuş | Ne yapar | GTA ayarlarındaki adı |
|---|---|---|
| F2 | Envanteri açar (yanındaki yer, bagaj ya da torpidoyla) ya da kapatır | Open the inventory |
| TAB | Hızlı slot çubuğunu gösterir ya da gizler | Show / hide the quick slots bar |
| 1 ile 5 | O hızlı slottaki eşyayı kullanır | Use the item in quick slot 1 (to 5) |
| R | Eldeki silahı bir mermi eşyasından doldurur | Reload the weapon |
Ekranda: taşımak için sürükle, sürüklerken eşyayı döndür, kullanmak için çift tıkla, eşya menüsü için sağ tıkla, kapatmak için Escape ya da F2.
Diğer script’lerle çalışır
- ox_inventory’nin (
provide, ox_inventory 2.44 API) ve qb-inventory’nin (provide, 2.0 API) yerine geçer: export’ları cevap verir, böylece ox ve QB script’leri eşyaları burada verir, alır ve kontrol eder. Neyin cevaplanıp neyin cevaplanmadığı için geliştirici sayfasına bak. - AI Core’un envanter katmanı. Her
ai-*script’i ve ESX / QB köprüsü eşyaları ai-inventory’yi çağıran AI Core üzerinden verir ve alır. - Onu değiştirebilirsin. AI Core’un diğer envanterler için adaptörleri var (tgiann-inventory, codem-inventory, core_inventory, origen_inventory, jaksam_inventory ve dahası), her birinin kendi sınırları var. Desteklenen bir envanter ai-inventory’yi gereksiz kılar: AI Core konsolda onu kaldırmanı söyler. Bkz. Uyumluluk.
Bilinen sınırlar
- Oyuncu başına aynı anda tek kullanım.
- Yeni bir yer torbası oyuncu başına saniyede bir, panelin Bags per player değeri ve harita bölgesi başına 50 ile sınırlıdır. Üretim sonuçları ve script’lerin yere bıraktıkları bu sınırlara takılmaz.
- Araç içinden eşya yere atılamaz.
- ox_inventory’nin hook’ları, ox’un şeklindeki
RegisterShopve el koyma cevaplanmaz (dükkânlar panelden ya da ai-inventory’nin kendiRegisterShop’undan gelir).
Geliştiriciler için ai-appearance
ai-appearance’ın client export’ları, meslek kıyafeti şekli ve AI Core’un karakter ekranıyla kullandığı event’ler.
Geliştiriciler için ai-inventory
ai-inventory’nin server ve client export’ları, kullanılabilir eşyalar, script dükkânları, usedItem event’i ve cevapladığı ox_inventory ile qb-inventory API’leri.