Das Feldreparatur-Problem
Dein Fahrzeug wird mitten in einer Mission beschädigt. Die Werkstatt ist 10 Minuten entfernt. Diese Fahrt abzusitzen killt das Tempo jeder Actionsequenz, in der du gerade warst. Aber sofortige Selbstreparatur fühlt sich unfair an. Agency-Repairkit findet den Mittelweg mit brauchbaren, aber begrenzten Feldreparatur-Werkzeugen.
Drei Kit-Stufen
Basic-Kits beheben kleine Schäden schnell. Advanced-Kits beheben mittlere Schäden etwas langsamer. Professional-Kits packen schwere Schäden an, brauchen aber deutlich länger zum Anwenden. Die Abstufung gibt Spielern echte Entscheidungen basierend auf ihrem Inventar und der Situation, in der sie gerade sind.
Integrität der Animation
Jede Reparatur läuft über eine sichtbare Animation an der beschädigten Stelle des Fahrzeugs. Spieler können nicht einfach vom Fahrersitz aus schnell reparieren — sie müssen aussteigen, zur Schadensstelle gehen und sich auf die Reparaturanimation einlassen. Das verhindert Feldreparatur-Missbrauch im Kampf und lässt die Aktion verdient wirken.
Unterbrechung zählt
Wenn du während einer Reparatur Schaden nimmst oder getroffen wirst, wird sie unterbrochen und das Kit verbraucht. Reparaturen passieren außerhalb des Kampfs, nicht mittendrin. Das schützt Verfolgungsjagden davor, zu einem Whack-a-Mole zu verkommen, bei dem nichts hält.
Wirtschafts-Integration
Repairkits können von Mechaniker-NPCs oder Spieler-Mechanikern über die Metall-Lieferkette von Agency-Minerjob hergestellt werden. Die gesamte Fahrzeugwirtschaft — Bergbau, Herstellung, Feldreparaturen, Werkstattreparaturen — wird zu einem vernetzten Gewebe. Kits sind kein Einmalartikel, sondern ein Knoten in einem größeren System.
Installation & Einrichtung
Lade Agency-Repairkit aus deiner Tebex-Bibliothek herunter und lege den Ordner in dein Ressourcenverzeichnis. Füge ensure agency-repairkit zur server.cfg hinzu. Die Ressource benötigt oxmysql, wenn du persistentes Kit-Tracking über Neustarts hinweg willst; ohne oxmysql sind Kit-Mengen nur für die Sitzung gültig.
Konfigurationsoptionen
- Kit-Stufen — Definiere beliebig viele Kit-Typen, jeder mit maximalem Reparaturbetrag, Reparaturgeschwindigkeit und Animationsdauer.
- Kampfsperre — Ob Reparaturen während des Kampfes initiiert werden können. Standard: im Kampf deaktiviert.
- Unterbrechungsschadensschwelle — Wie viel eingehender Schaden eine aktive Reparatur abbricht.
- Animation pro Schadenszone — Verschiedene Animationen für Motor-, Karosserie- und Reifenschäden.
Framework-Kompatibilität
Agency-Repairkit wird mit eingebauten Adaptern für QBCore und ESX geliefert. Die Framework-Erkennung ist automatisch. Für eigenständige Server: Implementiere Config.GetItem, Config.RemoveItem, Config.GetVehicleHealth und Config.SetVehicleHealth.
Warum das für das Roleplay wichtig ist
Fahrzeugschäden sind eine der häufigsten Quellen für RP-Reibung. Wenn eine Mission 15 Minuten vom nächsten Mechaniker entfernt schiefläuft, haben Spieler die Wahl: das Auto schleppen und das Tempo ruinieren, oder eine sinnvolle Feldreparatur durchführen. Reparatur-Kits bieten einen dritten Weg, der verdient wirkt ohne kostenlos zu sein.
Das gestufte Kit-System schafft natürliche Inventarökonomieentscheidungen. Trägst du ein professionelles Kit für alle Fälle mit dem Trageaufwand? Oder verlässt du dich auf Basis-Kits und akzeptierst, dass schwere Schäden eine Werkstatt erfordern?
Häufig gestellte Fragen
Können Mechaniker Reparatur-Kits aus ihrem Menü verkaufen?
Ja. Agency-Repairkit exportiert ein serverseitiges Event agency-repairkit:giveKit, das jedes Mechanikerscript aufrufen kann. Übergib die Spieler-Server-ID, Kit-Stufe und Menge.
Funktioniert das Kit bei Booten und Flugzeugen?
Ja. Das Schadenssystem verwendet FiveMs native Fahrzeug-Health-Eigenschaften, die für alle Fahrzeugtypen gelten.
Voraussetzungen
- FiveM-Server (QBCore, ESX oder eigenständig)
- oxmysql (optional, für persistentes Kit-Tracking)
- cfx.re-Konto mit gültiger Agency-Repairkit-Lizenz
Reparatur-Kits in deiner Server-Wirtschaft ausbalancieren
Die wirtschaftliche Frage, die Server am häufigsten über Agency-Repairkit stellen, lautet: Wie selten sollten die Kits sein? Die Antwort hängt von der bestehenden Wirtschaftsbalance deines Servers ab.
Wenn dein Server aktive Mechaniker-Shops mit gutem Roleplay hat, mache Basis- und fortgeschrittene Kits vernünftigerweise verfügbar, aber professionelle Kits selten oder nur für Mechaniker zugänglich. Dadurch werden größere Reparaturen wieder in die Shops getrieben und das Mechaniker-RP bleibt lebensfähig.
Wenn dein Server Schwierigkeiten hat, Spieler bei Mechaniker-Jobs zu engagieren, reduziere die Verfügbarkeit von Feld-Kits und stelle sicher, dass von Mechanikern hergestellte Kits besser sind als kommerziell erhältliche. Der wirtschaftliche Anreiz, einen Spieler-Mechaniker zu besuchen, muss real sein, nicht nur narrativ.
Der Schlüsselprinzip: Feldreparatur sollte sich wie eine nützliche Option anfühlen, nicht wie die optimale. Wenn Spieler Mechaniker-Shops nie besuchen, sind deine Kits zu leistungsstark oder zu billig. Passe Ertrag und Preis gemeinsam an, nicht eines von beidem allein.
Ausrüstungsintegration
Agency-Repairkit funktioniert besonders gut, wenn es mit anderen Agency-Scripts kombiniert wird. Mit Agency-Minerjob können die Metalle, die Bergarbeiter abbauen und raffinieren, direkt in die Reparatur-Kit-Herstellung fließen, wodurch eine vollständige Wirtschaftskette vom Rohstoff bis zur Feldreparatur entsteht. Mit Agency-Blackmarket können hochwertige professionelle Reparatur-Kits als begehrte Schwarzmarkt-Items existieren — teuer, aber für gut ausgestattete Kriminelle unverzichtbar.
Technische Implementierungsdetails
Das Reparatur-Kit-System verwendet FiveMs native Fahrzeuggesundheitseigenschaften für alle Schadensberechnungen. Jedes Fahrzeug hat separate Gesundheitswerte für Motor, Karosserie und jedes Rad — Agency-Repairkit liest und modifiziert diese Werte granular, was bedeutet, dass du einen beschädigten Motor reparieren kannst, ohne gleichzeitig Karosserieschäden zu beheben.
Die Unterbrechungslogik verwendet FiveMs native Schadensdetektions-Events. Wenn ein Spieler während einer Reparatur Schaden nimmt, der über dem konfigurierten Schwellenwert liegt, bricht das Script die Animation ab, löst den Verbrauchs-Event aus (der das Kit aus dem Inventar entfernt) und gibt Steuerung an den Spieler zurück. Diese Sequenz ist zuverlässig auch bei lag-kompensierter Server-Umgebungen, da der Schadenscheck auf dem Client läuft.
Animations-Synchronisierung zwischen Spielern wird über den Netzwerk-Sync-Event von FiveM gehandhabt. Andere Spieler in der Nähe sehen die Reparatur-Animation korrekt abgespielt, was die Glaubwürdigkeit der Aktion in der Multiplayer-Umgebung aufrechterhält.
Balancierung in der Server-Wirtschaft
Die wichtigste wirtschaftliche Entscheidung bei Agency-Repairkit ist das Verhältnis zwischen Feldkit-Verfügbarkeit und Mechaniker-Shop-Attraktivität. Wenn Feldkits zu günstig und häufig sind, besuchen Spieler nie Mechaniker. Wenn sie zu selten und teuer sind, fühlt sich Fahrzeugschaden frustrierend statt herausfordernd an. Das richtige Gleichgewicht liegt bei: Feldkits für kleinere Schäden zugänglich, professionelle Kits selten genug, dass schwere Schäden eine Werkstatt lohnen.
Für Server mit aktiven Spieler-Mechanikern empfehlen wir: Mache den besten Kit-Typ nur durch Mechaniker-Crafting erhältlich, nicht durch Shops oder Schwarzmarkt. Das schafft einen natürlichen Anreiz, einen Spieler-Mechaniker für ernste Ausrüstungsaufrüstungen aufzusuchen. Der Mechaniker hat eine Dienst, die anderen Spieler brauchen, was stabile Kundennachfrage und echtes Wirtschaftsroleplay generiert.
Zusammenfassung
Agency Scripts baut seine gesamte Produktlinie nach denselben Grundprinzipien: Framework-agnostische Architektur, schlanke Performance-Eigenschaften, klar dokumentierte Konfiguration und eine API, die echte Composability zwischen den Scripts ermöglicht. Kein Script ist eine Insel — jedes ist so gebaut, dass es gut allein und noch besser als Teil des Ökosystems funktioniert.
Für Fragen zur Installation, Konfiguration oder Kompatibilität ist der Agency Scripts Discord der schnellste Weg zur Hilfe. Die Community dort ist aktiv und hilfsbereit, und das Core-Team ist regelmäßig präsent. Für kritische Probleme steht auch ein direktes Support-Ticket-System auf der Tebex-Produktseite zur Verfügung.
Updates für alle Agency-Scripts werden über Tebex-Benachrichtigungen kommuniziert. Active-Business-Abonnenten erhalten neue Scripts automatisch ohne zusätzlichen Kauf. Changelog-Details erscheinen im #changelog-Kanal des Discords, damit du Updates bewerten kannst, bevor du sie auf einem Produktionsserver installierst.