Agency-Repairkit: Einfache Fahrzeugreparaturen, die Spieler wirklich nutzen

Das Problem mit Reparaturen vor Ort

Dein Fahrzeug wird mitten in einer Mission beschädigt. Die nächste Werkstatt ist 10 Minuten entfernt. Die Fahrt dorthin bremst den Ablauf der laufenden Aktionssequenz aus. Eine sofortige Selbstreparatur wirkt aber unfair. Agency-Repairkit bietet mit vor Ort einsetzbaren, aber begrenzten Reparaturwerkzeugen einen Mittelweg.

Drei Kit-Stufen

Einfache Kits beheben kleinere Schäden schnell. Fortgeschrittene Kits reparieren mittlere Schäden langsamer. Professionelle Kits beheben schwere Schäden, brauchen dafür aber deutlich länger. Die verschiedenen Stufen geben Spielern je nach Inventar und Situation sinnvolle Wahlmöglichkeiten.

Realistische Animationen

Bei jeder Reparatur wird am beschädigten Fahrzeugbereich eine sichtbare Animation abgespielt. Spieler können das Fahrzeug nicht schnell vom Fahrersitz aus reparieren. Sie müssen aussteigen, zum Schaden gehen und die Reparaturanimation ausführen. So wird verhindert, dass Reparaturen vor Ort im Kampf ausgenutzt werden, und die Aktion fühlt sich verdient an.

Unterbrechungen haben Konsequenzen

Wer während einer Reparatur Schaden erleidet oder getroffen wird, unterbricht sie und verbraucht das Kit. Reparaturen finden außerhalb des Kampfes statt, nicht mittendrin. So werden Verfolgungsjagden nicht zu einem Whack-a-Mole-Spiel, bei dem nichts dauerhaft wirkt.

Integration in die Wirtschaft

Reparaturkits können von Mechaniker-NPCs oder Spielern mit Mechanikerjob über die Metallversorgungskette von Agency-Minerjob hergestellt werden. Die gesamte Fahrzeugwirtschaft, vom Bergbau über das Crafting bis zu Reparaturen vor Ort und in der Werkstatt, wird zu einem vernetzten System. Kits sind keine einmaligen Gegenstände, sondern ein Bestandteil eines größeren Systems.

Installation & Einrichtung

Lade Agency-Repairkit aus deiner Tebex-Bibliothek herunter und verschiebe den Ordner in dein Ressourcenverzeichnis. Füge ensure agency-repairkit in server.cfg. Die Ressource benötigt oxmysql, wenn die Kit-Bestände Neustarts überdauern sollen. Ohne oxmysql sind die Kit-Mengen nur für die jeweilige Sitzung verfügbar und werden beim Neustart des Servers zurückgesetzt.

Kit-Gegenstände müssen in der Item-Liste deines Frameworks registriert werden. Die Konfiguration enthält die richtigen Item-Namen für QBCore und ESX. Bei standalone-Setups wird die Item-Registrierung mit einem einzigen Funktionsaufruf in config.lua.

Konfigurationsoptionen

Die config.lua bietet dir die volle Kontrolle über das Verhalten der Kits:

• Kit-Stufen, definiere beliebig viele Kit-Typen, jeweils mit maximaler Reparaturmenge, Reparaturgeschwindigkeit und Animationsdauer.
• Kampfsperre, lege fest, ob Reparaturen gestartet werden können, während der Spieler als im Kampf markiert ist. Standard: während des Kampfes deaktiviert.
• Schadensschwelle für Unterbrechungen, lege fest, wie viel erlittener Schaden eine laufende Reparatur abbricht. Setze den Wert auf 0, damit jeder Treffer die Reparatur abbricht.
• Animationen je Schadensbereich, für Motorschäden, Karosserieschäden und Reifenschäden werden unterschiedliche Animationen abgespielt.
• Wirtschaftsintegration, aktiviere den Crafting-Event-Hook, damit Metall aus Agency-Minerjob in die Herstellung von Reparaturkits einfließen kann.

Framework-Kompatibilität

Agency-Repairkit enthält integrierte Adapter für QBCore und ESX. Das Framework wird automatisch erkannt. Füge die Ressource einfach hinzu, und sie erkennt, welches Framework du verwendest. Für standalone-Server:

• Implementiere Config.GetItem und Config.RemoveItem um dein Item-System anzubinden.
• Implementiere Config.GetVehicleHealth und Config.SetVehicleHealth für deine Fahrzeugschadenslogik.
• Alles andere, also Animationen, UI und Unterbrechungslogik, funktioniert ohne Änderungen.

Warum das für Roleplay wichtig ist

Fahrzeugschäden sind eine der häufigsten Ursachen für Spannungen im RP. Wenn eine Mission 15 Minuten von der nächsten Werkstatt entfernt schiefläuft, müssen Spieler eine Entscheidung treffen: mit dem beschädigten Auto weiterfahren und den Spielfluss ruinieren, die Mission abbrechen und schnellreisen oder eine praktikable Möglichkeit zur Reparatur vor Ort haben. Reparaturkits bieten eine dritte Option, die verdient wirkt, ohne kostenlos zu sein.

Das abgestufte Kitsystem schafft natürliche Entscheidungen rund um die Inventarökonomie. Nimmst du ein Profi-Kit „für alle Fälle“ mit und zahlst dafür, dass es Platz im Inventar belegt? Oder verlässt du dich auf einfache Kits und akzeptierst, dass schwere Schäden eine Werkstatt erfordern? Solche bedeutsamen Mikroentscheidungen sorgen dafür, dass sich die Inventarverwaltung realistisch und nicht willkürlich anfühlt.

Die Unterbrechungsmechanik im Kampf ist besonders wichtig für Verfolgungsjagden im RP. Ohne sie könnte ein verfolgter Spieler sein Fahrzeug mitten in der Verfolgung vor Ort reparieren, wodurch die Spannung völlig verloren ginge. Mit ihr sind Reparaturen eine Aktivität für die Zeit nach einem Konflikt oder zwischen Szenen und kein Notfallknopf.

Häufig gestellte Fragen

Können Mechaniker Reparaturkits über ihr Menü verkaufen?

Ja. Agency-Repairkit stellt ein serverseitiges Event bereit agency-repairkit:giveKit das jedes Mechaniker-Script aufrufen kann. Übergib die Server-ID des Spielers, die Kit-Stufe und die Menge. Du musst deinem bestehenden Werkstatt-Script nur einen Event-Aufruf in der Verkaufsroutine hinzufügen.

Funktioniert das Kit bei Booten und Flugzeugen?

Ja. Das Schadenssystem verwendet die nativen Eigenschaften der Fahrzeuggesundheit in FiveM, die für alle Fahrzeugtypen gelten. Bei Flugzeugen wird eine vereinfachte Animation verwendet, da Spieler mitten im Flug nicht zu einer bestimmten Schadenszone gehen können. Boote werden an der Anlegestelle repariert. Beide Verhaltensweisen lassen sich konfigurieren.

Kann ich einschränken, welche Kit-Stufen bestimmte Jobs verwenden dürfen?

Der Job-Zugriff auf Kits wird in der Itemdefinition unterstützt. Lege requiredJob = 'mechanic' für einen Kit-Typ fest, und nur Spieler mit diesem Job können ihn verwenden. Das ist nützlich, wenn Profi-Kits ausschließlich Mechanikern vorbehalten und nicht frei käuflich sein sollen.

Wie funktioniert das Kit mit Scripts zum Wiederherstellen von Fahrzeugen?

Agency-Repairkit löst agency-repairkit:onRepairComplete ein Event mit der netId des Fahrzeugs und dem Reparaturwert aus, wenn ein Kit erfolgreich verwendet wurde. Jedes Script, das auf dieses Event lauscht, kann entsprechend reagieren. Dein Script zur Fahrzeugspeicherung kann das Fahrzeug zu Protokollierungszwecken als vor Ort repariert markieren.

Voraussetzungen

• FiveM-Server (QBCore, ESX oder standalone)
• oxmysql (optional, für dauerhaftes Kit-Tracking)
• cfx.re-Konto mit gültiger Agency-Repairkit-Lizenz
• Registrierung der Kit-Items im Framework

Reparaturkits in der Wirtschaft deines Servers ausbalancieren

Die häufigste wirtschaftliche Frage, die Server zu Agency-Repairkit stellen, lautet: Wie selten sollten die Kits sein? Die Antwort hängt von der bestehenden Wirtschafts-Balance deines Servers ab.

Wenn es auf deinem Server aktive Werkstätten mit gutem RP gibt, sollten einfache und fortgeschrittene Kits einigermaßen verfügbar sein. Profi-Kits sollten dagegen selten oder ausschließlich Mechanikern vorbehalten sein. So werden größere Reparaturen weiterhin in Werkstätten durchgeführt, während kleinere Reparaturen vor Ort möglich sind. Dadurch bleibt das Mechaniker-RP relevant.

Wenn dein Server Schwierigkeiten hat, Spieler für Mechaniker-Jobs zu begeistern, solltest du die Verfügbarkeit von Kits für Reparaturen vor Ort verringern und sicherstellen, dass von Mechanikern hergestellte Kits besser sind als frei erhältliche. Der wirtschaftliche Anreiz, einen Spieler-Mechaniker aufzusuchen, muss real und nicht nur erzählerisch sein.

Wenn es auf deinem Server eine starke kriminelle Wirtschaft gibt, schaffen über Agency-Blackmarket festgelegte Kit-Preise oder Kits aus dem Crafting durch Spieler einen Parallelmarkt. Militärische Reparaturkits als Schwarzmarktware sorgen für interessantes Logistik-RP, ohne den zivilen Mechanikermarkt zu untergraben.

Das entscheidende Prinzip: Reparaturen vor Ort sollten sich wie eine nützliche Option anfühlen, nicht wie die beste. Wenn Spieler Werkstätten nie aufsuchen, sind deine Kits zu mächtig oder zu günstig. Passe Reparaturwert und Preis gemeinsam an, nicht einzeln.