Anpassung

Was jedes Item bewirkt, wird im Menü zusammengestellt und in der Datenbank gespeichert. Die Dateien regeln den Rest: den Befehl, Tastenbelegungen, Darstellung und die Kommunikation mit deinem Framework.

Welche Datei was bestimmt

Datei	Was sie bestimmt	Offen?
`config.lua`	Sprache, Befehl, Abbruchtaste, Interaktion mit platzierten Props, Bildpfad, Fortschrittsbalken	Ja
`bridge/client_bridge.lua`	Benachrichtigungen, Leben, Rüstung, Stress, Hunger und Durst, Item-Anzahl, Jobs, Target, Progressbar	Ja
`bridge/server_bridge.lua`	Framework-Erkennung, benutzbare Items, Items geben/nehmen, Jobs, Benachrichtigungen, Itemliste	Ja
`locales/*.lua`	Alle Texte, im Spiel und im Menü	Ja
`data/*.lua`	Die Listen hinter den Auswahlmenüs	Ja
`html/`	Das Menü (HTML, CSS, JS)	Lesbar
`client/`, `server/`	Item-Logik	Verschlüsselt (Escrow)

config.lua

Option	Was sie macht	Standard
`Config.Locale`	Sprache des Menüs und der Nachrichten. Siehe Sprachen	`'en'`
`Config.Command`	Befehl zum Öffnen und Schließen des Menüs	`'itemcreator'`
`Config.CommandDescription`	Name dieses Befehls in FiveMs Tastenbelegung, wo eine Taste zugewiesen werden kann. Standardmäßig keine belegt	`'Open Item Creator Menu'`
`Config.CancelKey`	Standardtaste zum Abbrechen von Aktionen, die durch ein Item gestartet wurden. Siehe unten	`'X'`
`Config.Interaction`	Wie ein platziertes Prop aufgehoben wird: `'drawtext'`, `'ox_target'` oder `'qb-target'`. Bei beiden Target-Werten nutzt die Bridge das laufende System (`ox_target`/`qb-target`)	`'drawtext'`
`Config.ImageInventoryPath`	Pfad zu den Itembildern als `<path><item name>.png`	`'nui://ox_inventory/web/images/'`
`Config.ProgressBar`	`'custom'` für die integrierte Leiste, `'ox_lib'` für ox_lib. Läuft ox_lib nicht, wird automatisch die integrierte Leiste genutzt	`'custom'`

Kein ox_inventory im Einsatz? Setze Config.ImageInventoryPath auf den Bilderordner deines Inventars, z. B. nui://qb-inventory/html/images/.

Tasten und Befehle

Befehl	Standardtaste	Was er bewirkt
`/itemcreator`	keine	Öffnet oder schließt das Menü. Erfordert ACE-Permission `mic_itemcreator.open`
`/cancelitemanim`	`Config.CancelKey` (X)	Stoppt Animation, Szenario oder Gehstil, setzt Geschwindigkeit zurück, beendet Superkräfte und entfernt ein angeheftetes Prop

Beim Positionieren eines Attach Prop gelten diese Tasten. Jede Taste ist in FiveMs Tastenbelegung unter einem „Placement:“-Namen gelistet, sodass Spieler sie anpassen können:

Taste	Funktion
← → ↑ ↓	Prop nach links, rechts, vor, zurück bewegen
Bild auf / Bild ab	Nach oben oder unten bewegen
Numpad 4 / 6	Gieren (Yaw)
Numpad 8 / 5	Nicken (Pitch)
Numpad 7 / 9	Rollen (Roll)
X	Animation in der Vorschau abspielen
E	Bestätigen
Rücktaste	Abbrechen

Die Datenlisten

Alles, was im Menü aus einer Liste ausgewählt werden kann, stammt aus data/. Du kannst jede Datei erweitern:

Datei	Inhalt
`data/animations.lua`	Animationen
`data/scenarios.lua`	Szenarien
`data/walkingstyles.lua`	Gehstile
`data/bones.lua`	Bones, an denen ein Prop angeheftet werden kann
`data/particles.lua`	Partikeleffekte
`data/screeneffects.lua`	Bildschirmeffekte
`data/sounds.lua`	Sounds
`data/cars.lua`	Fahrzeuge nach Label und Modell
`data/peds.lua`	Ped-Modelle
`data/clothing.lua`	Animationen beim Anziehen von Kleidungsstücken oder Props

Behalte das Format vorhandener Einträge bei. Das Menü liest diese Dateien beim Öffnen ein; nach Änderungen starte die Ressource neu.

Sprachen

Neun Dateien sind in locales/ enthalten:

`Config.Locale`	Sprache
`en`	Englisch
`es`	Spanisch
`de`	Deutsch
`fr`	Französisch
`it`	Italienisch
`pt`	Portugiesisch
`ru`	Russisch
`ch-zn`	Chinesisch
`jp`	Japanisch

Der Kommentar in config.lua nennt auch tr und ch; keine von beiden existiert. Verwende die obigen Codes.

Dieselbe Datei übersetzt die Ingame-Nachrichten und das Menü, es gibt also nur einen einzigen Ort für Anpassungen.

Neue Sprache hinzufügen:

Kopiere locales/en.lua in eine neue Datei, z. B. locales/pl.lua.
Ändere darin Locales['en'] zu deinem Sprachcode und übersetze den Text auf der rechten Seite. Behalte Schlüssel und alle %s exakt bei.
Füge die Datei in fxmanifest.lua unter shared_scripts oberhalb von locales/lib.lua hinzu.
Setze Config.Locale auf deinen Code, führe refresh aus und starte neu.

Ein fehlender Schlüssel erzeugt in der Konsole Translation key "…" not found und zeigt den Schlüssel direkt im UI an.

Die Bridge

Zwei offene Dateien in bridge/. Ändere keine Funktionsnamen — der Rest der Ressource ruft sie namentlich auf.

bridge/server_bridge.lua

Funktion	Verwendungszweck
(Erkennung)	Nutzt ESX, wenn `es_extended` läuft, andernfalls QBCore, wenn `qb-core` läuft. QBox wird über seine QBCore-Kompatibilität als `qb-core` erkannt
`Bridge.RegisterUsableItem`	Registriert jedes konfigurierte Item als benutzbar bei deinem Framework
`Bridge.AddItem`, `Bridge.RemoveItem`, `Bridge.GetItemCount`	Items: Bundles, Aufheben, benötigte Items, Remove on Use
`Bridge.GetPlayerJob`, `Bridge.GetPlayerJobGrade`	Job-Einschränkung
`Bridge.Notify`	Serverseitige Benachrichtigungen
`Bridge.GetAllItems`	Itemliste im Menü: aus ox_inventory, dann ESX-registrierte Items, dann QBCores Shared Items

bridge/client_bridge.lua

Funktion	Verwendungszweck
`Bridge.Notify`	Jede Benachrichtigung. Fällt ohne Framework auf den GTA-Feed zurück
`Bridge.AddHealth`, `Bridge.AddArmor`	Leben/Rüstung
`Bridge.AddFoodThirst`	Essen/Trinken: `esx_status` unter ESX; unter QBCore die Events `consumables:server:addHunger` und `addThirst`
`Bridge.AddStress`	Stress: `esx_status` unter ESX; `consumables:server:addStress` unter QBCore
`Bridge.GetItemCount`	Always Attached Prop: Anzahl aus ox_inventory, falls aktiv, andernfalls Spielerdaten
`Bridge.AddTargetEntity`	Aufhebe-Option an platzierten Props für ox_target oder qb-target
`Bridge.ProgressBar`	Fortschrittsbalken: ox_lib oder integriert. Enthält eine markierte Stelle mit Beispiel zum Hinzufügen weiterer Progressbar-Ressourcen

Dein HUD nutzt andere Events für Hunger, Durst oder Stress? Passe sie in Bridge.AddFoodThirst und Bridge.AddStress an. Anderes Benachrichtigungssystem? Ersetze den Inhalt von Bridge.Notify. Anderes Framework oder Inventar? Implementiere die entsprechenden Funktionen in beiden Dateien.

Community-Netzwerk

Network im Menü zeigt Item-Konfigurationen, die andere Serverbetreiber geteilt haben. Import fragt ab, welches deiner eigenen Items diese Konfiguration erhalten soll, und öffnet sie anschließend zur Anpassung und zum Speichern. Um ein eigenes Item zu teilen, exportiere es aus deiner Itemliste mit einem öffentlichen Namen, einer Beschreibung und einem Autorennamen — es wird sofort für alle Server im Netzwerk sichtbar.

Die Liste wird von GitHub bezogen; dein Server benötigt daher ausgehenden Internetzugriff, um die Einträge zu laden.