ai-inventory
Ekwipunek z siatką, rozmiarami przedmiotów, szybkimi slotami, przedmiotami na ziemi, schowkami, bagażnikami i schowkami na rękawiczki, sklepami, wytwarzaniem i bronią. Odpowiada na API ox_inventory i qb-inventory.
ai-inventory to ekwipunek z siatką: każdy przedmiot zajmuje określoną liczbę komórek (telefon 1x1, karabin 4x2) i można go obracać podczas przeciągania. Przechowuje przedmioty gracza, ziemię, schowki, bagażniki i schowki na rękawiczki pojazdów, sklepy i stoły rzemieślnicze oraz broń jako przedmioty.
Co robi w grze
- Siatka. Każdy ekwipunek ma tę samą liczbę kolumn; różnią się tylko wiersze i limit wagi. Przedmioty mają rozmiar w komórkach i wagę; ekwipunek odrzuca to, co się nie mieści lub jest za ciężkie.
- Ekran (F2): ubrania postaci w dwóch kolumnach wokół postaci, pięć szybkich slotów, siatka gracza i drugi ekwipunek (ziemia, bagażnik, schowek, sklep, stół) po prawej. Kliknięcie elementu ubrania zdejmuje go lub zakłada z powrotem.
- Szybkie sloty. Pięć osobnych slotów (nie komórek siatki). Klawisze od 1 do 5 ich używają; TAB pokazuje je jako pasek na dole.
- Używanie przedmiotów. Podwójne kliknięcie lub menu przedmiotu. Jedzenie i picie odtwarzają animację, uzupełniają głód i pragnienie (ai-hud) i są zużywane. Serwer sprawdza, czy przedmiot nadal jest po animacji.
- Daj, upuść, podziel. Menu przedmiotu daje go najbliższemu graczowi, upuszcza na ziemię lub dzieli stos.
- Przedmioty na ziemi. Upuszczone przedmioty leżą w torbie na ziemi. Upuszczenie obok własnej torby dodaje do niej. Torby znikają po kilku minutach bez dotykania.
- Bagażniki i schowki na rękawiczki. F2 z tyłu pojazdu otwiera jego bagażnik (gdy jest odblokowany); w pojeździe jego schowek na rękawiczki. Bagażnik posiadanego pojazdu zostaje z pojazdem bez względu na tablicę; bagażnik każdego innego pojazdu jest tymczasowy.
- Schowki. Przechowywanie w stałych miejscach, wspólne lub osobne dla każdej postaci, otwarte dla wszystkich albo dla niektórych prac i gangów.
- Sklepy. Miejsca z produktami i cenami, blipem na mapie i opcjonalnym NPC, płatne z gotówki, potem z banku (zgodnie z ustawieniem).
- Stoły rzemieślnicze. Przepisy, które w kilka sekund zamieniają materiały w przedmioty.
- Broń. Broń to przedmioty z numerem seryjnym. Amunicja jest przedmiotem; R przeładowuje z niej. Dodatki (latarka, tłumik...) to przedmioty zakładane na trzymaną broń. Koło broni GTA jest domyślnie wyłączone: broń pochodzi z szybkich slotów.
- Rzadkości. Przedmioty mogą należeć do rzadkości, której kolor barwi ich pole.
- Broń z innych źródeł. Broń niewydana przez ai-inventory jest graczowi zabierana.
Instalacja
Instaluje go przepis txAdmin AI Core. Ręcznie: włóż folder do resources/[ai]/ i dodaj ensure ai-inventory do server.cfg po ensure ai-core. Wymaga ai-core i bazy danych:
add_convar_permission ai-inventory read mysql_connection_stringTabela ai_inventory_inventories jest tworzona przy pierwszym starcie. Obrazki przedmiotów trafiają do folderu dist/web/images zasobu (obrazki z ox_inventory są dołączone).
Usuń ox_inventory i qb-inventory: ai-inventory odpowiada na ich nazwy.
Ustawienia w panelu
Otwórz panel administratora (F10) i wybierz Inventory.
Zakładka Items
Każdy przedmiot, który istnieje w grze. Każdy przedmiot to jeden rekord; jego klucz (water, lockpick) to nazwa przedmiotu używana przez skrypty. Skrypt zawiera 242 przedmioty (wzięte z list ox_inventory).
Item: nazwa widoczna dla graczy i rodzaj przedmiotu.
| Ustawienie | Co zmienia | Wartości | Domyślnie dla nowego przedmiotu |
|---|---|---|---|
| Name | Nazwa widoczna dla graczy. | do 48 znaków | |
| Description | Linia pod nazwą. | do 240 znaków | |
| Kind | Item, Weapon (trzymana po użyciu), Ammo (przeładowuje trzymaną broń), Attachment (zakładany na trzymaną broń). | Item / Weapon / Ammo / Attachment | Item |
| Rarity | Barwi pole przedmiotu kolorem rzadkości (zakładka Rarities). Puste: zwykłe pole. | rzadkość | brak |
| Picture | Nazwa pliku w folderze obrazków (water.png) lub pełny link https. Puste pokazuje ikonę. | do 200 znaków | |
| Other names | Nazwy, których inne skrypty używają dla tego przedmiotu (na przykład pistol_ammo), aby nadal działały. | do 30 nazw |
Size and weight: ile komórek zajmuje przedmiot i ile waży.
| Ustawienie | Co zmienia | Wartości | Domyślnie |
|---|---|---|---|
| Width | Komórki od lewej do prawej. Gracze mogą obrócić przedmiot podczas przeciągania. | od 1 do 8 komórek | 1 |
| Height | Komórki od góry do dołu. | od 1 do 8 komórek | 1 |
| Weight | Gramy na sztukę (1000 g = 1 kg). | od 0 do 1 000 000 g | 100 |
| Stack size | Najwięcej sztuk w jednym stosie. 1 sprawia, że każda sztuka jest osobna, dla przedmiotów z własnymi danymi. | od 1 do 100 000 | 10 |
Using: co się dzieje, gdy gracz używa przedmiotu.
| Ustawienie | Co zmienia | Wartości | Domyślnie |
|---|---|---|---|
| Can be used | Wył.: użycie nic nie robi, chyba że jakiś skrypt obsługuje ten przedmiot. | wł. / wył. | wył. |
| Used up per use | Sztuki usuwane przy każdym użyciu. 0 go zachowuje. | od 0 do 1000 | 0 |
| Close the inventory | Zamyka ekran ekwipunku po użyciu przedmiotu. | wł. / wył. | wył. |
| Animation | Odtwarzana podczas używania. | None / Eat / Drink / Bandage / Put on armour | None |
| Use time | Jak długo trwa animacja, zanim przedmiot zadziała. | od 0 do 60 000 ms | |
| Hunger | Dodawane do głodu gracza po użyciu (minus obniża). Wymaga HUD-a, który śledzi potrzeby. | od -100 do 100 | |
| Thirst | Dodawane do pragnienia. | od -100 do 100 | |
| Stress | Dodawane do stresu. | od -100 do 100 |
Weapon: tylko dla broni i dodatków.
| Ustawienie | Co zmienia | Wartości | Domyślnie |
|---|---|---|---|
| Ammo item | Nazwa przedmiotu, którym broń się ładuje (na przykład ammo-9). | nazwa przedmiotu | |
| Thrown | Granaty i podobne: liczba w stosie to amunicja. | wł. / wył. | wył. |
| Attachment hashes | Nazwy komponentów GTA, którymi może być ten dodatek (COMPONENT_AT_PI_FLSH); używana jest pierwsza, którą przyjmuje trzymana broń. | do 20 nazw |
Usunięcie przedmiotu: gracze, którzy go mają, zachowują stos, którego nikt nie może użyć.
Zakładka Rarities
Grupy kolorów, do których należą przedmioty. Dołączone: Common, Uncommon, Rare, Epic, Legendary, Medical, Special.
| Ustawienie | Co zmienia | Wartości |
|---|---|---|
| Name | Nazwa rzadkości. | do 32 znaków |
| Colour | Barwi pole każdego przedmiotu tej rzadkości. | kolor |
Usunięcie rzadkości: jej przedmioty tracą kolor.
Zakładka Shops
Miejsca, w których gracze kupują przedmioty. Skrypt zawiera 45 sklepów (24/7, LTD, Rob's Liquor, sklepy z narzędziami, Ammu-Nation i inne oraz sklepy służbowe dla policji i EMS).
Shop: gdzie jest sklep i kto może w nim kupować.
| Ustawienie | Co zmienia | Wartości | Domyślnie dla nowego sklepu |
|---|---|---|---|
| Shop name | Nazwa widoczna dla graczy. | do 48 znaków | |
| Place | Stań tam, gdzie gracze mają go otwierać, i użyj swojej pozycji. | punkt | |
| Reach | Jak blisko musi być gracz, aby go otworzyć. | od 0,5 do 30 m | 2 |
| Jobs | Mogą z niego korzystać tylko członkowie tych prac. Zostaw prace i gangi puste, aby był dostępny dla wszystkich. | nazwy prac | puste |
| Gangs | Członkowie tych gangów też mogą z niego korzystać. | nazwy gangów | puste |
| Only on duty | Członkowie pracy muszą być na służbie w tej pracy. | wł. / wył. | wył. |
| Map blip | Pokazuje sklep na mapie. | wł. / wył. | wł. |
| Blip look | Obrazek, kolor i rozmiar blipa (gdy blip jest włączony). | sprite, kolor, rozmiar | |
| Paid from | Konta pieniężne sprawdzane po kolei. | do 5 kont | cash, bank |
Products: przedmioty, które sprzedaje sklep, i ich cena za sztukę. Do 100 wierszy, każdy to Item i Price (od 0 do 100 000 000 $).
NPC: sprzedawca stojący w sklepie. Model (puste, aby go nie było, widoczny z 50 m), What it does (animacja bezczynności), Where it stands (miejsce na podłodze i kierunek; bez tego stoi w punkcie sklepu).
Zakładka Stashes
Przechowywanie w stałych miejscach. Dołączone: jedna Police Locker.
| Ustawienie | Co zmienia | Wartości | Domyślnie dla nowego schowka |
|---|---|---|---|
| Stash name | Nazwa widoczna dla graczy. | do 48 znaków | |
| Place | Gdzie gracze go otwierają. | punkt | |
| Reach | Jak blisko musi być gracz. | od 0,5 do 30 m | 1.5 |
| Jobs, Gangs, Only on duty | Kto może go otworzyć (jak dla sklepów). | wszyscy | |
| One per character | Wł.: każda postać ma własną zawartość. Wył.: wszyscy, którzy mogą go otworzyć, dzielą jeden. | wł. / wył. | wył. |
| Rows | Wiersze komórek; szerokość to ustawienie Columns. | od 1 do 50 | 6 |
| Weight limit | Gramy. 0 oznacza brak limitu. | od 0 do 10 000 000 g | 100 000 |
Usunięcie schowka: przedmioty w nim zapisane zostają w bazie danych.
Zakładka Crafting
Stoły, przy których gracze zamieniają materiały w przedmioty. Dołączony: jeden Workbench.
Bench: Bench name, Place, Reach (domyślnie 1,5 m), Jobs, Gangs, Only on duty, jak dla sklepów.
Recipes: do 50 wierszy.
| Ustawienie | Co zmienia | Wartości | Domyślnie dla nowego wiersza |
|---|---|---|---|
| Makes | Wytwarzany przedmiot. | nazwa przedmiotu | lockpick |
| Amount | Ile sztuk powstaje. | od 1 do 1000 | 1 |
| Time | Ile to trwa. | od 0 do 600 s | 5 |
| Materials | Co zużywa, jako item:count oddzielone przecinkami: scrapmetal:3, paperbag:1. | do 400 znaków | scrapmetal:3 |
Zakładka Settings
Jak duże są ekwipunki.
| Karta | Ustawienie | Co zmienia | Wartości | Domyślnie |
|---|---|---|---|---|
| Grid | Columns | Komórki w wierszu w każdym ekwipunku. Przedmioty, które się już nie mieszczą, przechodzą do wolnych komórek; zbyt pełny ekwipunek dostaje dodatkowe wiersze. | od 6 do 14 | 8 |
| Grid | No GTA weapon wheel | Koło broni GTA i zmiana broni kółkiem myszy pozostają wyłączone: broń jest brana z szybkich slotów (1-5). | wł. / wył. | wł. |
| Player inventory | Rows | Ile postać może unieść, w wierszach. | od 1 do 50 | 20 |
| Player inventory | Weight limit | Gramy; 0 = bez limitu. | od 0 do 10 000 000 g | 40 000 |
| Ground | Rows | Rozmiar torby na ziemi. | od 1 do 50 | 6 |
| Ground | Weight limit | Gramy; 0 = bez limitu. | od 0 do 10 000 000 g | 1 000 000 |
| Ground | Disappears after | Przedmioty na ziemi znikają, gdy nikt ich nie dotykał przez ten czas. | od 1 do 240 min | 15 |
| Ground | Bags per player | Ile toreb jedna postać może mieć na ziemi jednocześnie. | od 1 do 100 | 10 |
| Trunk | Rows | Bagażnik każdego pojazdu. | od 1 do 50 | 5 |
| Trunk | Weight limit | Gramy; 0 = bez limitu. | od 0 do 10 000 000 g | 80 000 |
| Glovebox | Rows | Schowek na rękawiczki każdego pojazdu. | od 1 do 50 | 2 |
| Glovebox | Weight limit | Gramy; 0 = bez limitu. | od 0 do 10 000 000 g | 10 000 |
Zmiana kolumn, wierszy lub wagi od razu trafia do otwartych ekranów.
Komendy
Brak własnych. Administratorzy dają i zabierają przedmioty narzędziami przedmiotów z ai-admin.
Klawisze
| Domyślny klawisz | Co robi | Nazwa w ustawieniach GTA |
|---|---|---|
| F2 | Otwiera ekwipunek (z ziemią, bagażnikiem lub schowkiem na rękawiczki obok) lub go zamyka | Open the inventory |
| TAB | Pokazuje lub ukrywa pasek szybkich slotów | Show / hide the quick slots bar |
| od 1 do 5 | Używa przedmiotu z danego szybkiego slotu | Use the item in quick slot 1 (to 5) |
| R | Przeładowuje trzymaną broń z przedmiotu amunicji | Reload the weapon |
Na ekranie: przeciągnij, aby przenieść, obróć przedmiot podczas przeciągania, kliknij dwukrotnie, aby użyć, kliknij prawym przyciskiem, aby otworzyć menu przedmiotu, Escape lub F2, aby zamknąć.
Współpraca z innymi skryptami
- Zastępuje ox_inventory (
provide, API ox_inventory 2.44) i qb-inventory (provide, API 2.0): ich eksporty odpowiadają, więc skrypty ox i QB dają, zabierają i sprawdzają przedmioty tutaj. Na co odpowiada, a na co nie, opisuje strona dla deweloperów. - Warstwa ekwipunku AI Core. Każdy skrypt
ai-*i most ESX / QB dają i zabierają przedmioty przez AI Core, który wywołuje ai-inventory. - Możesz go zastąpić. AI Core ma adaptery do innych ekwipunków (tgiann-inventory, codem-inventory, core_inventory, origen_inventory, jaksam_inventory i inne), każdy z własnymi ograniczeniami. Obsługiwany ekwipunek sprawia, że ai-inventory jest niepotrzebny: AI Core poinformuje cię w konsoli, aby go usunąć. Zobacz Zgodność.
Znane ograniczenia
- Jedno użycie naraz na gracza.
- Nowa torba na ziemi jest ograniczona do jednej na sekundę na gracza, do Bags per player z panelu i do 50 na obszar mapy. Wyniki wytwarzania i zrzuty ze skryptów pomijają te limity.
- Przedmiotów nie można upuszczać z wnętrza pojazdu.
- Hooki ox_inventory,
RegisterShopw kształcie ox i konfiskata nie są obsługiwane (sklepy pochodzą z panelu lub z własnegoRegisterShopai-inventory).
ai-appearance dla deweloperów
Eksporty klienta ai-appearance, kształt stroju służbowego i zdarzenia, których używa z ekranem postaci AI Core.
ai-inventory dla deweloperów
Eksporty serwera i klienta ai-inventory, przedmioty do użycia, sklepy skryptów, zdarzenie usedItem oraz API ox_inventory i qb-inventory, na które odpowiada.