Installation

Zehn Minuten: zwei Ordner, eine SQL-Datei, acht Items.

Vor der Installation

Du benötigst	Warum
ESX, QBCore oder QBox, aktiv	Bezahlung, Items und nutzbare Gegenstände. Automatisch erkannt
oxmysql, aktiv	Die Bestenlisten
ox_target oder qb-target (optional)	Nur bei gewünschter Target-Interaktion

1. Beide Ordner einfügen

Dein Download enthält zwei Ressourcen. Lege beide in deinem resources-Ordner ab, zum Beispiel in resources/[mic]/:

Ordner	Was es ist
`mic_arcade`	Das Skript und die Spiele
`mic_arcade_props`	Die sieben Automatenmodelle und der Renderer, der das Spiel auf die Bildschirme bringt

2. Startreihenfolge

Starte in der server.cfg unterhalb von oxmysql und deinem Framework zuerst mic_arcade_props und dann mic_arcade, jeweils in einer eigenen ensure-Zeile.

Erfolgreich installiert, wenn du dem Server beitrittst und die festen Automaten an den in der config.lua eingetragenen Koordinaten stehen — standardmäßig ist das eine Reihe aus vier Automaten: Pixel, Race, Tower und Road.

3. Datenbank

Importiere install.sql (im Hauptverzeichnis von mic_arcade) einmalig. Sie erstellt eine Tabelle, mic_arcade_leaderboard, in der der beste Score jedes Charakters pro Spiel gespeichert wird.

Das Skript erstellt diese Tabelle nicht selbstständig. Ohne sie funktionieren die Spiele zwar, aber Highscores werden nicht gespeichert und die Bestenliste bleibt leer.

Erfolgreich installiert, wenn deine Datenbank die Tabelle mic_arcade_leaderboard enthält.

4. Items hinzufügen

Item	Was es macht
`arcade_coin`	Die Spielwährung bei `Config.PaymentType = 'item'` (Standard)
`arcade_alien`	Platziert einen Alien-Automaten
`arcade_brick`	Platziert einen Breakout-Automaten
`arcade_duofight`	Platziert einen DuoFight-Automaten
`arcade_pixel`	Platziert einen Pixel-Automaten
`arcade_race`	Platziert einen Race-Automaten
`arcade_road`	Platziert einen Road-Automaten
`arcade_tower`	Platziert einen Tower-Automaten

Das Skript gibt niemals eigenständig Münzen oder Automaten aus. Verkaufe sie in einem Shop, vergebe sie über Berufe oder gib sie dir über das Admin-Menü.

Die fertigen Definitionen befinden sich in mic_arcade/items/ und die Icons in mic_arcade/items/images/:

Inventar	Definitionen (`mic_arcade/items/`)	Zielort	Icons
ox_inventory	`ox.lua`	`ox_inventory/data/items.lua`	Kopiere `items/images/*.png` nach `ox_inventory/web/images/`
QBCore / qb-inventory	`qbcore.lua`	`qb-core/shared/items.lua`	Kopiere sie nach `qb-inventory/html/images/`
ESX Standard-Inventar	`esx_items.sql`	Einmalig in Datenbank importieren	—

Die Einträge in den beiden .lua-Dateien sind auskommentiert — entferne das führende --, wenn du sie einfügst.

Erfolgreich installiert, wenn du dir jedes Item einmal gibst und alle acht mit ihrem Icon im Inventar erscheinen.

5. Framework und Interaktion

Das Framework erfordert keine manuelle Einstellung: ESX, QBCore oder QBox wird beim Start gefunden. QBox wird über seine QBCore-Kompatibilität erkannt — qbx_core stellt qb-core bereit —, daher muss nichts weiter konfiguriert werden.

Die Interaktion wird über Config.Interaction in der config.lua gesteuert. Standardmäßig ist ox-target eingestellt — in diesem Skript mit Bindestrich. Ändere es auf qb-target, falls du dieses nutzt, oder auf drawtext für eine einfache Drücke E-Einblendung.

6. Erstes Spiel

Gib dir mindestens 100 arcade_coin — jeder Automat außer DuoFight kostet standardmäßig 100 Münzen.
Gehe zu einem der festen Automaten und wähle Play Arcade (oder drücke E bei drawtext).
Starte ein Spiel aus dem Menü des Automaten. Der Price des Automaten wird in Münzen abgezogen.
Drücke ESC, um den Automaten zu verlassen.

Erfolgreich installiert, wenn die Kamera an den Bildschirm heranzoomt, das Spiel läuft und deine Münzen um den Preis verringert wurden.

Probiere dann das Aufstellen aus: Benutze arcade_race, bewege die Vorschau mit deinem Blickfeld, drehe sie mit dem Mausrad und drücke E (ESC oder Rücktaste bricht ab). Schaue den Automaten erneut an, um die Option Pick Up Arcade zu sehen, die nur dir angezeigt wird.

Vor der Servereröffnung

Entscheide dich für die Währung. Config.PaymentType ist standardmäßig auf item mit arcade_coin eingestellt. Wenn du das beibehältst, stelle sicher, dass Spieler Münzen im Spiel erhalten können.
Preise festlegen pro Automat in Config.Arcades.
Feste Automaten platzieren, wo du möchtest, oder auskommentieren und Spieler ihre eigenen aufstellen lassen.
Spieler informieren, dass aufgestellte Automaten temporär sind. Ein aufgestellter Automat bleibt bis zum Neustart der Ressource oder des Servers bestehen; ein vorheriges Aufheben gibt das Item zurück. Siehe Troubleshooting.