Zurück zum Blog
Scripts5 Min. Lesezeit

Agency-Seatbelt: Warum ein 20kb-Script das Fahrgefühl am stärksten beeinflusst

Agency-Seatbelt ist winzig, wirkt sich aber enorm auf das Spielerlebnis aus. Darum sind realistische Gurtmechaniken wichtiger, als du denkst.

Agency Scripts

Gründer und leitender Entwickler bei Agency Scripts

Kleine Scripts, große Wirkung

Agency-Seatbelt gehört zu den kleinsten Scripts, die wir anbieten, aber laut Feedback zählt es durchgehend zu den beliebtesten. Daraus lässt sich etwas lernen: RP entsteht durch kleine Mechaniken, die die Welt stimmig wirken lassen, nicht durch riesige Funktionspakete.

Der Realismusgewinn

Wenn Spieler vor dem Losfahren tatsächlich den Sicherheitsgurt anlegen müssen, ändern sich drei Dinge. Verfolgungsjagden werden gefährlicher, weil das Anschnallen während der Flucht Zeit kostet. Polizisten bekommen einen neuen Grund, Strafzettel zu verteilen. Mitfahrer müssen die Folgen der Unachtsamkeit des Fahrers tragen. All das sind kleine RP-Aufhänger, die für mehr Tiefe sorgen, ohne die Spieler zusätzlich zu belasten.

Details bei Animation und Sound

Wir haben mehr Zeit in die Animation zum Anschnallen und Abschnallen gesteckt als in die Kernlogik. Eine zweisekündige Animation, ein dezentes Klickgeräusch und eine gut erkennbare Sicherheitsgurtanzeige auf dem HUD: Genau solche Details vermitteln den Spielern: "Dieser Server nimmt sich selbst ernst." Wenn alles andere unauffällig seinen Zweck erfüllt, fallen diese kleinen Momente besonders auf.

Integration mit Vehicle-Scripts

Agency-Seatbelt lässt sich problemlos in jedes Script für Fahrzeugschäden integrieren, denn wir stellen ein einfaches Client-Event bereit, das andere Scripts abfragen können: `agency-seatbelt:isBuckled`. Dein Abschleppwagen-Script kann Abschleppaufträge von Spielern ablehnen, die gerade durch die Windschutzscheibe geschleudert wurden. Dein Hospital-Script kann realistische Verletzungsmodifikatoren hinzufügen. Das Script ist klein genug, um sich nicht in den Weg zu stellen, aber flexibel genug, um mit anderen Scripts zusammenzuarbeiten.

Kostenlos, wie es sein sollte

Agency-Seatbelt bleibt für immer kostenlos, für 0 €. Eine grundlegende Sicherheitsmechanik sollte nicht hinter einer Paywall stecken. Nutze, forke und ändere das Script, wie du möchtest. Das ist uns egal. Jeder Server, der unsere kostenlosen Scripts nutzt, könnte eines Tages auch unsere Premium-Scripts kaufen, und wir setzen auf langfristige Beziehungen.

Installation & Einrichtung

Agency-Seatbelt ist kostenlos und hat keinerlei Abhängigkeiten. Lade es von GitHub oder über den kostenlosen Tebex-Tarif herunter, lege den Ordner in dein Ressourcenverzeichnis und füge ensure agency-seatbelt in server.cfghinzu. Nach dem nächsten Server-Neustart ist die Ressource sofort einsatzbereit. Keine Datenbank, kein Framework und keine Konfiguration erforderlich.

Wenn du die Tastenbelegung, die Ticketintegration oder das Verhalten der HUD-Anzeige anpassen möchtest, öffne config.lua. Die Standardeinstellungen sind für die meisten Server geeignet. Viele Serverbesitzer nutzen Agency-Seatbelt monatelang, ohne die Konfiguration anzurühren.

Konfigurationsoptionen

Die config.lua enthält die Einstellungen für Interaktion und Folgen:

  • Tastenbelegung für den Sicherheitsgurt, die Taste, mit der Spieler den Gurt anlegen und lösen. Standard: B (wie bei vielen älteren Sicherheitsgurt-Scripts, damit die gewohnte Tastenbelegung erhalten bleibt).
  • Auswurfschwelle, die Fahrzeuggeschwindigkeit, ab der ein nicht angeschnallter Spieler bei einem Aufprall aus dem Fahrzeug geschleudert wird. Standard: 50 km/h.
  • Auswurfkraft, wie weit der Spieler beim Herausschleudern geschleudert wird. Höhere Werte wirken dramatischer, niedrigere realistischer.
  • Schaden beim Herausschleudern , Gesundheit und Rüstung werden entfernt, wenn ein Spieler ohne Sicherheitsgurt aus dem Fahrzeug geschleudert wird. Unabhängig von der Schleuderkraft konfigurierbar.
  • HUD-Anzeige, ob bei nicht angelegtem Gurt in einem Fahrzeug ein kleines Gurtsymbol im HUD erscheint. Erfordert Agency-Hud oder ein Positions-Event für eigene HUDs.
  • Polizeibefehl, aktiviere /checkbelt für die Polizei, um den Gurtstatus der Insassen eines nahegelegenen Fahrzeugs zu prüfen.
  • Durchsetzung für Mitfahrer, ob neben dem Fahrer auch Mitfahrer ohne angelegten Gurt aus dem Fahrzeug geschleudert werden. Standard: aktiviert.

Framework-Kompatibilität

Agency-Seatbelt hat keine Framework-Abhängigkeiten. Die Logik für das Herausschleudern und den Schaden verwendet native Funktionen von FiveM zur Fahrzeug- und Ped-Manipulation, die auf jedem Server identisch funktionieren. Der optionale Polizeibefehl verwendet eine einfache Berechtigungsprüfung. Implementiere Config.IsPolice(src) für jedes eigene Jobsystem oder deaktiviere den Befehl vollständig, wenn du ihn nicht brauchst.

Warum das für Roleplay wichtig ist

Die Designphilosophie hinter Agency-Seatbelt ist, dass kleine mechanische Details zusammen den Charakter eines Servers prägen. Ein Server mit Sicherheitsgurten, Hinsetzen, eigenen Benachrichtigungen und einem ausgefeilten HUD fühlt sich grundlegend anders an als einer ohne, auch wenn Spieler nicht genau sagen können, warum. Sicherheitsgurte sind eines dieser unauffälligen Signale, die sagen: „Auf diesem Server wird auf Details geachtet.“

Am meisten aktiven RP-Wert bietet dieses Script im Bereich der Strafverfolgung. Polizeicharaktere auf Servern mit Agency-Seatbelt erhalten ein neues, dezentes Werkzeug zur Verkehrskontrolle. Eine Verkehrskontrolle, die mit „Mir ist aufgefallen, dass dein Beifahrer nicht angeschnallt war“ beginnt, ist ein besserer RP-Einstieg als ein Vorwand, von dem jeder weiß, dass er erfunden ist. Dieses kleine Detail gibt Beamten einen realistischen Grund, mit Zivilisten zu interagieren, und eröffnet Szenarien, die sonst nicht zustande kämen.

Verfolgungsjagden verändern sich spürbar, wenn Fahrer wissen, dass Zusammenstöße bei hoher Geschwindigkeit echte Folgen haben. Die Abwägung „Riskiere ich einen Unfall, um sie abzuhängen?“ wird interessanter, wenn eine mögliche Folge darin besteht, durch die Windschutzscheibe geschleudert zu werden. Genau diese Spannung macht Verfolgungsjagden zu mehr als einem Geschwindigkeitsvergleich zwischen zwei Fahrzeugen.

Mitfahrer achten stärker auf das Verhalten des Fahrers. Wer weiß, dass er für die rücksichtslosen Entscheidungen des Fahrers mit Konsequenzen rechnen muss, bittet ihn, langsamer zu fahren, diskutiert über die Route oder steigt lieber aus, statt die Fahrt zu riskieren. Diese kleinen RP-Momente gäbe es ohne das durch den Sicherheitsgurt geschaffene Konsequenzsystem einfach nicht.

Häufig gestellte Fragen

Funktioniert das Herausschleudern bei allen Fahrzeugtypen?

Das Herausschleudern funktioniert bei Autos, Lkw und Vans. Bei Motorrädern und Fahrrädern kommt eine separate, verringerte Schleuderkraft zum Einsatz, da sich die Physik anders verhält. Bei Hubschraubern und Flugzeugen sind Gurtprüfungen standardmäßig deaktiviert, da das Herausschleudern aus Luftfahrzeugen eher zu Trolling als zu RP führt. Wenn dein Server spezielle Anforderungen an Luftfahrt-RP hat, kannst du Prüfungen für Luftfahrzeuge in config.lua aktivieren.

Können wir für Verstöße gegen die Gurtpflicht Bußgelder verhängen?

Ja. Agency-Seatbelt löst ein serverseitiges Event aus agency-seatbelt:violation mit Spieler-ID und Fahrzeug-Netzwerk-ID, wenn eine Polizeikontrolle einen nicht angeschnallten Insassen feststellt. Dein Polizei- oder Bußgeldscript hört auf dieses Event und verhängt ein Bußgeld über das System, das dein Server verwendet. Das Gurtscript übernimmt die Erkennung, dein Bußgeldscript die wirtschaftlichen Folgen.

Beeinflusst die Herausschleuder-Mechanik Deathscreen-Scripts?

Agency-Seatbelt löst agency-seatbelt:onEjection vor der Schadensverursachung aus. Deathscreen-Scripts, die auf Gesundheitsänderungen hören, erfassen den Schaden automatisch. Für eine engere Integration, etwa eigene Verletzungstypen oder Szenendaten zu Straftaten, kannst du direkt auf das Herausschleuder-Event hören und dort deine Logik ergänzen.

Kann das Herausschleudern in bestimmten Bereichen deaktiviert werden, etwa auf Rennstrecken?

Ja. Verwende exports['agency-seatbelt']:DisableInZone(coords, radius) aus jedem Serverscript heraus. Das Herausschleudern wird für alle Spieler innerhalb dieses Radius unterdrückt. Rufe den Befehl beim Einrichten eines Events auf und entferne die Zone anschließend wieder. So verhinderst du, dass die Gurtmechanik Rennveranstaltungen oder andere Szenarien stört, bei denen Fahrzeugunfälle erwartet werden und keine Folgen haben sollen.

Voraussetzungen

  • FiveM-Server (beliebiges Framework oder standalone)
  • Kostenlos, keine Tebex-Lizenz erforderlich
  • Keine Datenbankabhängigkeit
  • Keine Abhängigkeiten von externen Resources

Das passende Script

Fertig für deinen Server, Updates inklusive.

Bereit loszulegen?

Hol dir die Scripts in unserem Shop, oder komm auf den Discord für Support, Updates und einen Blick auf das, was kommt.