ai-inventory
Raster-Inventar mit Item-Größen, Schnellplätzen, Drops auf dem Boden, Lagern, Kofferräumen und Handschuhfächern, Shops, Crafting und Waffen. Beantwortet die APIs von ox_inventory und qb-inventory.
ai-inventory ist ein Raster-Inventar: Jedes Item belegt eine Anzahl von Zellen (ein Telefon 1x1, ein Gewehr 4x2) und kann beim Ziehen gedreht werden. Es enthält die Items des Spielers, den Boden, Lager, Kofferräume und Handschuhfächer von Fahrzeugen, Shops und Werkbänke sowie Waffen als Items.
Was es im Spiel macht
- Das Raster. Jedes Inventar hat dieselbe Anzahl von Spalten; nur die Zeilen und das Gewichtslimit unterscheiden sich. Items haben eine Größe in Zellen und ein Gewicht; das Inventar lehnt ab, was nicht passt oder zu schwer ist.
- Der Bildschirm (F2): die Kleidung des Charakters in zwei Spalten um den Charakter herum, die fünf Schnellplätze, das Raster des Spielers und rechts das zweite Inventar (Boden, Kofferraum, Lager, Shop, Werkbank). Ein Klick auf ein Kleidungsstück zieht es aus oder wieder an.
- Schnellplätze. Fünf eigene Plätze (keine Rasterzellen). Die Tasten 1 bis 5 benutzen sie; TAB zeigt sie als Leiste unten an.
- Items benutzen. Doppelklick oder das Item-Menü. Essen und Trinken spielen eine Animation ab, füllen Hunger und Durst (ai-hud) und werden verbraucht. Der Server prüft nach der Animation, ob das Item noch da ist.
- Geben, ablegen, teilen. Das Item-Menü gibt an den nächsten Spieler, legt auf den Boden ab oder teilt einen Stapel.
- Drops auf dem Boden. Abgelegte Items liegen in einer Tasche auf dem Boden. Ablegen neben deiner eigenen Tasche fügt sie dieser hinzu. Taschen verschwinden nach einigen unberührten Minuten.
- Kofferräume und Handschuhfächer. F2 am Heck eines Fahrzeugs öffnet seinen Kofferraum (wenn aufgeschlossen); im Fahrzeug sein Handschuhfach. Der Kofferraum eines Fahrzeugs im Besitz bleibt beim Fahrzeug, egal welches Kennzeichen es trägt; der Kofferraum jedes anderen Fahrzeugs ist vorübergehend.
- Lager. Stauraum an festen Orten, gemeinsam oder einer pro Charakter, offen für alle oder für bestimmte Jobs und Gangs.
- Shops. Orte mit Produkten und Preisen, einem Karten-Blip und einem optionalen NPC, bezahlt mit Bargeld, dann Bank (je nach Einstellung).
- Werkbänke. Rezepte, die Materialien in einigen Sekunden in Items verwandeln.
- Waffen. Waffen sind Items mit einer Seriennummer. Munition ist ein Item; R lädt daraus nach. Aufsätze (Taschenlampe, Schalldämpfer...) sind Items, die an die gehaltene Waffe kommen. Das Waffenrad von GTA ist standardmäßig aus: Waffen kommen aus den Schnellplätzen.
- Seltenheiten. Items können zu einer Seltenheit gehören, deren Farbe ihre Box färbt.
- Waffen von anderswo. Eine Waffe, die nicht von ai-inventory vergeben wurde, wird dem Spieler abgenommen.
Installation
Das txAdmin-Rezept von AI Core installiert es. Von Hand: Lege den Ordner in resources/[ai]/ und füge ensure ai-inventory in der server.cfg nach ensure ai-core ein. Es braucht ai-core und die Datenbank:
add_convar_permission ai-inventory read mysql_connection_stringDie Tabelle ai_inventory_inventories wird beim ersten Start angelegt. Item-Bilder kommen in den Ordner dist/web/images der Ressource (die Bilder von ox_inventory werden mitgeliefert).
Entferne ox_inventory und qb-inventory: ai-inventory beantwortet ihre Namen.
Panel-Einstellungen
Öffne das Admin-Panel (F10) und wähle Inventory.
Tab Items
Jedes Item, das im Spiel existiert. Jedes Item ist ein Datensatz; sein Schlüssel (water, lockpick) ist der Item-Name, den Skripte nutzen. Das Skript kommt mit 242 Items (aus den Listen von ox_inventory übernommen).
Item: der Name, den Spieler sehen, und welche Art von Item es ist.
| Einstellung | Was sie ändert | Werte | Standard für ein neues Item |
|---|---|---|---|
| Name | Der Name, den Spieler sehen. | bis zu 48 Zeichen | |
| Description | Eine Zeile unter dem Namen. | bis zu 240 Zeichen | |
| Kind | Item, Weapon (wird beim Benutzen gehalten), Ammo (lädt die gehaltene Waffe nach), Attachment (kommt an die gehaltene Waffe). | Item / Weapon / Ammo / Attachment | Item |
| Rarity | Färbt die Box des Items mit der Farbe einer Seltenheit (Tab Rarities). Leer: eine einfache Box. | eine Seltenheit | keine |
| Picture | Dateiname im Bilderordner (water.png) oder ein vollständiger https-Link. Leer zeigt ein Symbol. | bis zu 200 Zeichen | |
| Other names | Namen, die andere Skripte für dieses Item nutzen (zum Beispiel pistol_ammo), damit sie weiter funktionieren. | bis zu 30 Namen |
Size and weight (Größe und Gewicht): wie viele Zellen das Item belegt und wie schwer es ist.
| Einstellung | Was sie ändert | Werte | Standard |
|---|---|---|---|
| Width | Zellen von links nach rechts. Spieler können ein Item beim Ziehen drehen. | 1 bis 8 Zellen | 1 |
| Height | Zellen von oben nach unten. | 1 bis 8 Zellen | 1 |
| Weight | Gramm pro Einheit (1000 g = 1 kg). | 0 bis 1.000.000 g | 100 |
| Stack size | Höchstzahl an Einheiten in einem Stapel. 1 macht jede Einheit einzeln, für Items mit eigenen Daten. | 1 bis 100.000 | 10 |
Using (Benutzen): was passiert, wenn ein Spieler das Item benutzt.
| Einstellung | Was sie ändert | Werte | Standard |
|---|---|---|---|
| Can be used | Aus: Benutzen tut nichts, es sei denn, ein Skript behandelt dieses Item. | an / aus | aus |
| Used up per use | Einheiten, die bei jeder Benutzung entfernt werden. 0 behält es. | 0 bis 1000 | 0 |
| Close the inventory | Schließt den Inventarbildschirm, wenn das Item benutzt wird. | an / aus | aus |
| Animation | Wird beim Benutzen abgespielt. | None / Eat / Drink / Bandage / Put on armour | None |
| Use time | Wie lange die Animation läuft, bevor das Item wirkt. | 0 bis 60.000 ms | |
| Hunger | Wird beim Benutzen zum Hunger des Spielers addiert (ein Minus senkt ihn). Braucht ein HUD, das Bedürfnisse verfolgt. | -100 bis 100 | |
| Thirst | Wird zum Durst addiert. | -100 bis 100 | |
| Stress | Wird zum Stress addiert. | -100 bis 100 |
Weapon (Waffe): nur für Waffen und Aufsätze.
| Einstellung | Was sie ändert | Werte | Standard |
|---|---|---|---|
| Ammo item | Item-Name, den die Waffe lädt (zum Beispiel ammo-9). | ein Item-Name | |
| Thrown | Granaten und Ähnliches: Die Stapelanzahl ist die Munition. | an / aus | aus |
| Attachment hashes | GTA-Komponentennamen, die dieser Aufsatz sein kann (COMPONENT_AT_PI_FLSH); der erste, den die gehaltene Waffe annimmt, wird genutzt. | bis zu 20 Namen |
Ein Item löschen: Spieler, die es haben, behalten einen Stapel, den niemand benutzen kann.
Tab Rarities
Farbgruppen, zu denen Items gehören. Mitgeliefert: Common, Uncommon, Rare, Epic, Legendary, Medical, Special.
| Einstellung | Was sie ändert | Werte |
|---|---|---|
| Name | Der Name der Seltenheit. | bis zu 32 Zeichen |
| Colour | Die Box jedes Items dieser Seltenheit wird damit gefärbt. | eine Farbe |
Eine Seltenheit löschen: Ihre Items verlieren ihre Farbe.
Tab Shops
Orte, an denen Spieler Items kaufen. Das Skript kommt mit 45 Shops (24/7, LTD, Rob's Liquor, Baumärkte, Ammu-Nation und andere, dazu Job-Shops für Polizei und EMS).
Shop: wo der Shop ist und wer dort kaufen darf.
| Einstellung | Was sie ändert | Werte | Standard für einen neuen Shop |
|---|---|---|---|
| Shop name | Der Name, den Spieler sehen. | bis zu 48 Zeichen | |
| Place | Stell dich dorthin, wo Spieler ihn öffnen sollen, und nutze deine Position. | ein Punkt | |
| Reach | Wie nah ein Spieler sein muss, um ihn zu öffnen. | 0.5 bis 30 m | 2 |
| Jobs | Nur Mitglieder dieser Jobs können ihn nutzen. Lass Jobs und Gangs leer für alle. | Job-Namen | leer |
| Gangs | Mitglieder dieser Gangs können ihn ebenfalls nutzen. | Gang-Namen | leer |
| Only on duty | Job-Mitglieder müssen in diesem Job im Dienst sein. | an / aus | aus |
| Map blip | Zeigt den Shop auf der Karte. | an / aus | an |
| Blip look | Bild, Farbe und Größe des Blips (wenn der Blip an ist). | Sprite, Farbe, Größe | |
| Paid from | Geldkonten, die der Reihe nach versucht werden. | bis zu 5 Konten | cash, bank |
Products (Produkte): Items, die der Shop verkauft, und ihr Preis pro Einheit. Bis zu 100 Zeilen, jede mit Item und Price (0 bis 100.000.000 $).
NPC: ein Verkäufer, der am Shop steht. Model (leer für keinen, sichtbar innerhalb von 50 m), What it does (eine Leerlaufanimation), Where it stands (Bodenstelle und Blickrichtung; ohne sie steht er auf dem Punkt des Shops).
Tab Stashes
Stauraum an festen Orten. Mitgeliefert: ein Police Locker.
| Einstellung | Was sie ändert | Werte | Standard für ein neues Lager |
|---|---|---|---|
| Stash name | Der Name, den Spieler sehen. | bis zu 48 Zeichen | |
| Place | Wo Spieler es öffnen. | ein Punkt | |
| Reach | Wie nah ein Spieler sein muss. | 0.5 bis 30 m | 1.5 |
| Jobs, Gangs, Only on duty | Wer es öffnen darf (wie bei Shops). | alle | |
| One per character | An: Jeder Charakter hat seinen eigenen Inhalt. Aus: Alle, die es öffnen dürfen, teilen sich einen. | an / aus | aus |
| Rows | Zeilen von Zellen; die Breite ist die Einstellung Columns. | 1 bis 50 | 6 |
| Weight limit | Gramm. 0 bedeutet kein Limit. | 0 bis 10.000.000 g | 100.000 |
Ein Lager löschen: Die darin gelagerten Items bleiben in der Datenbank.
Tab Crafting
Werkbänke, an denen Spieler Materialien in Items verwandeln. Mitgeliefert: eine Workbench.
Bench (Werkbank): Bench name, Place, Reach (Standard 1.5 m), Jobs, Gangs, Only on duty, wie bei Shops.
Recipes (Rezepte): bis zu 50 Zeilen.
| Einstellung | Was sie ändert | Werte | Standard für eine neue Zeile |
|---|---|---|---|
| Makes | Das hergestellte Item. | ein Item-Name | lockpick |
| Amount | Wie viele hergestellt werden. | 1 bis 1000 | 1 |
| Time | Wie lange es dauert. | 0 bis 600 s | 5 |
| Materials | Was es verbraucht, als item:count, durch Kommas getrennt: scrapmetal:3, paperbag:1. | bis zu 400 Zeichen | scrapmetal:3 |
Tab Settings
Wie groß die Inventare sind.
| Karte | Einstellung | Was sie ändert | Werte | Standard |
|---|---|---|---|---|
| Grid | Columns | Zellen pro Zeile in jedem Inventar. Items, die nicht mehr passen, wandern in freie Zellen; ein Inventar, das dafür zu voll ist, bekommt zusätzliche Zeilen. | 6 bis 14 | 8 |
| Grid | No GTA weapon wheel | Das Waffenrad von GTA und der Waffenwechsel mit dem Mausrad bleiben aus: Waffen werden aus den Schnellplätzen (1-5) genommen. | an / aus | an |
| Player inventory | Rows | Was ein Charakter tragen kann, in Zeilen. | 1 bis 50 | 20 |
| Player inventory | Weight limit | Gramm; 0 = kein Limit. | 0 bis 10.000.000 g | 40.000 |
| Ground | Rows | Größe einer Tasche auf dem Boden. | 1 bis 50 | 6 |
| Ground | Weight limit | Gramm; 0 = kein Limit. | 0 bis 10.000.000 g | 1.000.000 |
| Ground | Disappears after | Items auf dem Boden verschwinden, wenn sie so lange niemand berührt hat. | 1 bis 240 min | 15 |
| Ground | Bags per player | Wie viele Taschen ein Charakter gleichzeitig auf dem Boden haben darf. | 1 bis 100 | 10 |
| Trunk | Rows | Der Kofferraum jedes Fahrzeugs. | 1 bis 50 | 5 |
| Trunk | Weight limit | Gramm; 0 = kein Limit. | 0 bis 10.000.000 g | 80.000 |
| Glovebox | Rows | Das Handschuhfach jedes Fahrzeugs. | 1 bis 50 | 2 |
| Glovebox | Weight limit | Gramm; 0 = kein Limit. | 0 bis 10.000.000 g | 10.000 |
Eine Änderung von Spalten, Zeilen oder Gewicht erreicht offene Bildschirme sofort.
Befehle
Keine eigenen. Admins geben und nehmen Items mit den Item-Werkzeugen von ai-admin.
Tastenbelegungen
| Standardtaste | Was sie macht | Name in den GTA-Einstellungen |
|---|---|---|
| F2 | Öffnet das Inventar (mit dem Boden, Kofferraum oder Handschuhfach neben dir) oder schließt es | Open the inventory |
| TAB | Zeigt oder verbirgt die Schnellleiste | Show / hide the quick slots bar |
| 1 bis 5 | Benutzt das Item in diesem Schnellplatz | Use the item in quick slot 1 (to 5) |
| R | Lädt die gehaltene Waffe aus einem Munitions-Item nach | Reload the weapon |
Im Bildschirm: Ziehen zum Bewegen, das Item beim Ziehen drehen, Doppelklick zum Benutzen, Rechtsklick für das Item-Menü, Escape oder F2 zum Schließen.
Zusammenspiel mit anderen Skripten
- Ersetzt ox_inventory (
provide, API von ox_inventory 2.44) und qb-inventory (provide, API 2.0): Ihre Exports antworten, sodass ox- und QB-Skripte hier Items geben, nehmen und prüfen. Was beantwortet wird und was nicht, steht auf der Entwicklerseite. - Der Inventar-Layer von AI Core. Jedes
ai-*-Skript und die ESX- / QB-Brücke geben und nehmen Items über AI Core, das ai-inventory aufruft. - Du kannst es ersetzen. AI Core hat Adapter für andere Inventare (tgiann-inventory, codem-inventory, core_inventory, origen_inventory, jaksam_inventory und mehr), jedes mit eigenen Grenzen. Ein unterstütztes Inventar macht ai-inventory unnötig: AI Core sagt dir in der Konsole, dass du es entfernen sollst. Siehe Kompatibilität.
Bekannte Grenzen
- Eine Benutzung gleichzeitig pro Spieler.
- Eine neue Tasche auf dem Boden ist auf eine pro Sekunde pro Spieler, die Panel-Einstellung Bags per player und 50 pro Kartenbereich begrenzt. Crafting-Ergebnisse und Drops von Skripten umgehen diese Grenzen.
- Items können nicht aus einem Fahrzeug heraus abgelegt werden.
- Die Hooks von ox_inventory,
RegisterShopin der Form von ox und Beschlagnahme werden nicht beantwortet (Shops kommen aus dem Panel oder aus dem eigenenRegisterShopvon ai-inventory).
ai-appearance für Entwickler
Die Client-Exports von ai-appearance, die Struktur der Job-Outfits und die Events, die es mit dem Charakterbildschirm von AI Core nutzt.
ai-inventory für Entwickler
Die Server- und Client-Exports von ai-inventory, benutzbare Items, Skript-Shops, das Event usedItem und die APIs von ox_inventory und qb-inventory, die es beantwortet.