Konfiguration

mic_boosting ist in zwei Schichten aufgebaut. Eine kurze config.lua regelt die wenigen grundlegenden Dinge — Framework, wie sich das Tablet öffnet, wer Admin ist, die Sprache. Alles, was das Gameplay betrifft, liegt in der Datenbank und wird live im Admin-Panel (/boostingconfig) ohne Server-Neustart bearbeitet.

Welche Datei wofür zuständig ist

Wo	Was geregelt wird	Offen?
`config.lua`	Framework, Tablet-Item/-Befehl, Admin-Rechte, Sprache, Interaktionssystem, Polizeijobs, Test-Fixierungen	Ja
`shared/prices.lua`	Startwerte für sechs Wirtschaftseinstellungen — wird nur beim allerersten Start eingelesen (siehe unten)	Ja
`locales/*.lua`	Alle Benachrichtigungen und Tablet-Texte, eine Datei pro Sprache; `locales/locale.lua` ist der Loader	Ja
`bridge/server_bridge.lua`	Framework, Geld, Items, nutzbares Item, Polizeizählung, Admin-Prüfung, Fahrzeug in die Garage übergeben	Ja
`bridge/client_bridge.lua`	Benachrichtigungen, Texteinblendung, Target-Interaktionen, Polizei-Dispatch-Alarm	Ja
`items/`	Item-Definitionen für ox_inventory, QBCore und ESX sowie die sieben Item-Bilder	Ja
`ui/`	Das Tablet selbst (HTML, CSS, JS)	Escrow
`client/`, `server/`	Spiellogik und Backend des Admin-Panels	Escrow
Admin-Panel (`/boostingconfig`)	Orte, Übergaben, Klassen, Autos, Wachen, Minispiele, Werkzeug-Shop, Progression, Wirtschaft	Im Spiel

Die offenen Dateien entsprechen den in escrow_ignore der fxmanifest.lua gelisteten: config.lua, locales/, shared/ und bridge/.

config.lua

Framework und Sprache

Option	Funktion	Standard
`Config.Framework`	`'auto'` prüft auf `qb-core`, danach `es_extended`, andernfalls Standalone. QBox wird über die QBCore-Kompatibilität erkannt. Oder erzwinge `'qbcore'` (auch für QBox), `'esx'`, `'standalone'`	`'auto'`
`Config.CoreResource`	In der Datei vorhanden, wird in dieser Version jedoch nicht ausgewertet: Die Erkennung prüft stets auf Ressourcen mit den Namen `qb-core` und `es_extended`	`''`
`Config.Locale`	Sprache für Benachrichtigungen und das Tablet. Greift bei fehlenden Schlüsseln auf Englisch zurück	`'en'`

Tablet öffnen

Option	Funktion	Standard
`Config.TabletOpenMode`	`'item'`, `'command'` oder `'both'`	`'item'`
`Config.TabletItem`	Das nutzbare Item zum Öffnen	`mic_boosting_tablet`
`Config.TabletCommand`	Der Befehl zum Öffnen im Modus `command` oder `both`	`boosting`

Admin-Rechte

Option	Funktion	Standard
`Config.AdminCommand`	Befehl zum Öffnen des Admin-Panels	`boostingconfig`
`Config.AdminGroups`	Ränge, die als Admin gelten. ESX vergleicht die Gruppe des Spielers; QBCore prüft `HasPermission` für jeden Namen	`admin`, `superadmin`, `god`
`Config.AdminAce`	Eine ACE-Berechtigung, die ebenfalls Admin-Rechte gewährt. Einzige Option bei Standalone. `false` schaltet dies ab	`command`

Dieselbe Prüfung entscheidet darüber, wer den Admin-Tab im Tablet sieht. Mehr dazu unter ⌨️ Befehle & Berechtigungen.

Interaktion und Polizei

Option	Funktion	Standard
`Config.InteractionSystem`	Wie die Lockpick-Einblendung am Wagen erscheint: `'ox_target'`, `'qb_target'` oder `'drawtext'` (Taste E)	`'ox_target'`
`Config.PoliceJobs`	Berufsbezeichnungen, die für das Minimum aktiver Polizisten jeder Klasse gezählt werden	`police`, `sheriff`, `lspd`, `bcso`

Mit ox_target bietet das Fahrzeug Spielern mit einem EMP-Störsender im Inventar zusätzlich die Option EMP Jammer an. In den anderen Modi wird der Jammer ebenfalls genutzt — automatisch zu Beginn des Knackens.

Tests

Option	Funktion	Standard
`Config.ForceDropoffId`	Leitet jeden Auftrag zu diesem Übergabepunkt	`nil` (zufällig)
`Config.ForceLocationId`	Lässt jeden Auftrag an diesem Abholort spawnen	`nil` (zufällig)
`Locations.BlipRadius`	Radius des Suchkreises auf der Karte um das Zielfahrzeug in Metern	`150.0`

shared/prices.lua — nur beim ersten Start

Diese Datei hinterlegt beim allerersten Start der Ressource sechs wirtschaftliche Basiswerte in der Datenbank (sofern die Einstellungstabelle leer ist). Danach bewirkt eine Bearbeitung der Datei nichts mehr — passe sie stattdessen im Settings-Tab des Admin-Panels an.

Prices.Tools in derselben Datei ist nicht das Sortiment des Werkzeug-Shops: Dieser bezieht seinen Katalog aus dem Market-Tab des Admin-Panels.

Das Admin-Panel

/boostingconfig öffnet das Panel im Tab Locations. Hänge einen Tab-Namen an, um direkt dorthin zu springen: locations, dropoffs, classes, vehicles, setups, progression, minigames, market oder settings — zum Beispiel /boostingconfig classes.

Tab	Was du dort verwaltest
Locations	Abholorte: Fahrzeugposition und vier Wachenpositionen pro Ort, erlaubte Klassen und Wachen-Setup pro Klasse. Teleportieren, sortieren, bearbeiten, löschen oder direkt in der Welt platzieren
Drop-Offs	Orte für die Fahrzeugabgabe. Neu in der Welt platzieren, teleportieren, löschen
Classes	Alle Klasseneinstellungen (Tabelle unten)
Vehicles	Der Fahrzeugpool, aus dem die Ziele der jeweiligen Klasse gezogen werden
NPC Setups	Benannte Wachen-Ausrüstungen samt Waffen
Progression	Herausforderungen, Meilensteine, Errungenschaften und Perks
Minigames	Jedes Minispiel, Schwierigkeitseinstellungen, Ein/Aus und zugewiesene Klassen
Market	Der Werkzeug-Shop: Items und Buffs, Preis, Währung (MB oder Bargeld), Wert, Mindestklasse, aktiv/inaktiv
Settings	Wirtschaft, Heat, der Tools-Tab und die Markierung am Übergabepunkt

In der Welt platzieren. Neue Orte und Übergabepunkte werden als Ghost-Modell gesetzt: E bestätigt, das Mausrad dreht, Rücktaste bricht ab. Ein Abholort erfordert zuerst das Auto, dann vier Wachen und schließlich einen Namen.

Classes

Sechs Klassen sind vorkonfiguriert: D, C, B, A, S und S+.

Einstellung	Funktion
Name, Mindestlevel	Angezeigter Name und erforderliches Level (D 0, C 3, B 6, A 10, S 15, S+ 20)
XP-Bereich, Auszahlung	Belohnung für ein abgeliefertes Auto, zufällig zwischen den beiden Werten gewählt
Zeitlimit	Minuten bis zur Abgabe
Cooldown	Wartezeit in Sekunden, bis derselbe Spieler einen weiteren Auftrag annehmen darf
Queue min / max	Zeitspanne, bis die Warteschlange einen Vertrag zuteilt
Tägliche Limits	Verträge pro Spieler und pro Crew pro Tag (0 = unbegrenzt)
Max. Lockpick-Versuche	Fehlversuche, bevor das Schloss blockiert
Polizeialarm	Legt fest, ob die Polizei bei dieser Klasse einen Dispatch-Alarm erhält
Heat-Zuwachs	Hinzugefügte Heat pro Auftrag
Min. Polizisten online	Erforderliche Polizisten im Dienst für Beitritt/Annahme. Standardwert: 2 für jede Klasse
Fahndungssterne	Fahndungslevel für den Dieb, sobald der Wagen geknackt ist (D 1 … S+ 5)

Settings

Einstellung	Funktion	Standardwert
VIN Scratch Multiplier	Die VIN-Scratch-Gebühr beträgt 35 % der Auszahlung × diesen Wert, bezahlt in MB	`4.0`
XP per Level	Benötigte XP für das nächste Level = Level × dieser Wert	`500`
Heat Decay per Minute	Jede Minute abgebaute Heat bei online befindlichen Spielern	`2`
Max Heat	Bei diesem Wert werden Verträge verweigert, bis die Heat abkühlt	`100`
Hide Locked Items	Blendet Shop-Items aus, die über der aktuellen Klasse des Spielers liegen	Aus
Dropoff marker	Ein/Aus, Markertyp, Farbe (RGBA) und Größe	Ein, Typ 2, rot
Queue Fee, Crypto Rate	Im Panel sichtbar. In dieser Version ist die Warteschlange kostenlos und Abgaben zahlen den vollen MB-Betrag aus	`0`, `0.10`

Neu anfangen

Der Befehl boostingseed in der Server-Konsole leert die Konfigurationstabellen und stellt die Werkseinstellungen wieder her. Spielerdaten — Profile, Level, MB, Crews, Verträge, Markteinträge — bleiben davon unberührt.

Sprachen

Elf Sprachen liegen in locales/ bereit: en, es, fr, pt (brasilianisch), de, tr, it, nl, pl, cs, ru. Setze Config.Locale auf einen dieser Codes. Fehlende Übersetzungsschlüssel fallen automatisch auf Englisch zurück.

So fügst du eine Sprache hinzu:

Kopiere locales/en.lua nach locales/<code>.lua und passe das Sprachkürzel am Kopf der Tabelle an.
Übersetze die Einträge beider Bereiche: script (Benachrichtigungen — behalte %s und %d bei) und ui (Tablet — behalte {name}-Platzhalter bei). date.intl_locale steuert das Datumsformat auf dem Sperrbildschirm.
Ergänze die Datei in den shared_scripts der fxmanifest.lua nach locales/en.lua und führe refresh aus.
Setze Config.Locale auf das neue Kürzel.

Die Bridge

Beide Bridge-Dateien sind offen zugänglich und dienen der Anbindung benutzerdefinierter Frameworks, Inventare, Benachrichtigungen oder Dispatch-Systeme.

bridge/server_bridge.lua

Funktion	Zweck
Framework-Erkennung	Wählt `qbcore`, `esx` oder `standalone` und gibt dies in der Konsole aus
`GetPlayerIdentifier`	citizenid bei QBCore, identifier bei ESX, `license:` bei Standalone
`GetPlayerJob`, `GetPoliceCount`	Berufsbezeichnungen und Anzahl der Spieler in Berufen aus `Config.PoliceJobs`
`AddMoney`, `RemoveMoney`	Bargeldbelohnungen und -käufe über das Konto `money`
`AddItem`, `RemoveItem`, `HasItem`	Bevorzugt ox_inventory falls aktiv, andernfalls das Framework
`RegisterUsableItem`	Macht das Tablet-Item benutzbar (ESX und QBCore; ohne Funktion bei Standalone)
`GiveVehicle`	Stellt VIN-gekratzte Autos in die Garage: `owned_vehicles` bei ESX, `player_vehicles` in `pillboxgarage` bei QBCore
`IsAdmin`	Prüft ACE, danach `Config.AdminGroups`
`Notify`	Framework-Benachrichtigung serverseitig senden

bridge/client_bridge.lua

Funktion	Zweck
`Notify`	QBCore- oder ESX-Benachrichtigung, nativer Feed bei Standalone
`ShowTextUI`, `HideTextUI`	Einblendung im Modus `drawtext`. Kommentierte Beispiele für okokTextUI und cd_drawtextui
`ClientHasItem`	Clientseitige Item-Prüfung für die EMP-Option am Zielfahrzeug
`AddEntityInteraction`, `RemoveEntityInteraction`	Target-Interaktionen für ox_target / qb-target / drawtext am Fahrzeug
`PoliceDispatch`	Läuft auf dem Client jedes Polizisten bei Alarmierung. Standard: Benachrichtigung und 60 Sekunden blinkender Blip. Kommentierte Beispiele für cd_dispatch und ps-dispatch

Die meisten für Spieler sichtbaren Meldungen stammen direkt aus dem Tablet als interne Toasts und laufen nicht über das Framework.