Agency-Vending: Verkaufsautomaten, die wirklich Teil eurer Wirtschaft sind

Das am wenigsten genutzte Prop in GTA V

GTA V ist voller Verkaufsautomaten, die auf FiveM-Servern im Basisspiel rein dekorativ sind. Agency-Vending macht sie alle funktional. Spieler gehen hin, interagieren mit ihnen, kaufen Essen oder Getränke zu angemessenen Preisen und erhalten passende Buffs. Einfach, überall zu finden und es lässt die Karte lebendiger wirken als im Basisspiel.

Warenbestand, der zur Neige geht

Jeder Automat hat einen eigenen Warenbestand, der beim Kauf von Items abnimmt. Leere Automaten zeigen den Status „ausverkauft“ an, bis sie wieder aufgefüllt werden. Das wirkt nebensächlich, schafft aber eine neue Jobrolle: Betreiber einer Automatenroute. Spieler, die Automaten auffüllen, erhalten einen Anteil an den Verkäufen aus ihrem Bestand. Plötzlich bringt jedes Prop wirtschaftliche Aktivität mit sich.

Item-Auswahl je nach Automatentyp

Getränkeautomaten verkaufen Getränke mit geringem Durststillungseffekt. Snackautomaten verkaufen Essen mit Hungerstillungseffekt. Kaffeestände verkaufen Heißgetränke, die Müdigkeit vertreiben. Agency-Vending erkennt den Maschinentyp automatisch anhand des Prop-Modells und bestückt die Maschine passend. Für Standardplatzierungen ist keine Konfiguration nötig.

Preissignale

Die Preise sind bewusst günstiger als Restaurantessen, aber teurer als selbst gekochtes Essen. So entsteht eine sinnvolle wirtschaftliche Hierarchie: Zuhause > Automaten > Fast Food > Restaurants. Spieler entscheiden sich ganz natürlich für die Option, die zu ihrer Situation passt, genau wie beim echten Kaufverhalten.

Admin-Berichte

Serveradmins erhalten wöchentlich eine Zusammenfassung der Automatenaktivität: welche Maschinen am meisten einnehmen, welche zu selten aufgefüllt werden und in welchen Vierteln es Versorgungslücken gibt. Diese Daten sind Gold wert, um die Karte auszubalancieren und neue Gameplay-Möglichkeiten zu entdecken, ohne Spieler mit Umfragen zu belästigen.

Installation & Einrichtung

Agency-Vending benötigt oxmysql, um den Bestand pro Maschine zu verfolgen. Importiere vending.sqlund lege die Ressource auf deinem Server ab. Füge dann ensure agency-vending in server.cfghinzu. Beim ersten Start durchsucht die Ressource die Karte nach allen nativen Automaten-Props und trägt sie automatisch in die Datenbank ein. Für die standardmäßige Platzierung der Automaten müssen keine Koordinaten manuell eingetragen werden.

Die von den Maschinen ausgegebenen Items müssen im Item-Register deines Frameworks vorhanden sein. Die Konfiguration enthält standardmäßige Namen für Essen und Getränke für QBCore und ESX. Benutzerdefinierte Item-Namen lassen sich für jeden Maschinentyp mit einer einzigen Zeile ändern.

Konfigurationsoptionen

Die config.lua deckt sowohl das Maschinenverhalten als auch die wirtschaftlichen Einstellungen ab:

• Bestand pro Maschine, wie viele Einheiten jede Maschine enthält, bevor sie aufgefüllt werden muss. Standard: 50.
• Auffüllmethode, automatisches zeitgesteuertes Auffüllen (einfach), von Spielern durchgeführtes Auffüllen (Wirtschaftsrolle) oder Auffüllen nur durch Admins.
• Anforderung für den Auffülljob, beschränke das Auffüllen optional auf Spieler mit einem Liefer- oder Verkäuferjob.
• Gewinnbeteiligung, der Prozentsatz der Verkaufseinnahmen, der an den Spieler geht, der die Maschine zuletzt aufgefüllt hat.
• Überschreibungen des Maschinentyps, lege manuell eine andere Item-Liste für bestimmte Automaten-Prop-Modelle fest.
• Effektdauer, wie lange Essen- und Getränkebuffs anhalten. Pro Item-Typ konfigurierbar.
• Anzeige bei leerem Bestand, aktiviere oder deaktiviere den visuellen Zustand „leer“ für Automaten-Props.

Framework-Kompatibilität

QBCore- und ESX-Adapter sind enthalten. Für standalone implementiere Config.GiveItem(src, item, count) und Config.TakeMoney(src, amount). Das Scannen der Maschinen, die Bestandsverwaltung, die Auffüllökonomie und die Admin-Berichte sind alle framework-unabhängig.

Warum das für Roleplay wichtig ist

Die Kartendichte ist einer der unterschätzten Faktoren für die Qualität eines RP-Servers. Wenn Spieler mit mehr bereits vorhandenen Props auf der Karte interagieren können, mit Maschinen, Bänken, Müllcontainern und Türen, wirkt die Welt bewohnt statt inszeniert. Agency-Vending ist eine der einfachsten Möglichkeiten, das zu erreichen: Jeder Automaten-Prop wird ohne zusätzlichen Aufwand für das Serverteam zu einem interaktiven wirtschaftlichen Knotenpunkt.

Die Rolle als Betreiber einer Automatenroute ist wohl das interessanteste emergente Gameplay, das dieses Script ermöglicht. Ein Charakter, der seinen Lebensunterhalt damit verdient, Maschinen aufzufüllen, Routen zu verwalten und zu verfolgen, in welchen Vierteln die Automaten häufig leer werden, das ist eine alltägliche, aber legitime RP-Rolle, die manchen Spielern wirklich Spaß macht. Nicht jeder Charakter muss kriminell oder Polizist sein.

Die Admin-Berichte sind ein praktisches Werkzeug, um die Gesundheit der Serverwirtschaft zu überwachen. Wenn eine bestimmte Maschine ständig leer ist (hohe Nachfrage), während eine andere immer voll ist (geringe Besucherzahl), sind das konkrete Anhaltspunkte für die Platzierung benutzerdefinierter Laden-NPCs oder die Anpassung der Spielerspawnpunkte. Die Automatendaten zeigen dir, wo deine Spieler tatsächlich Zeit verbringen.

Häufig gestellte Fragen

Kann ich benutzerdefinierte Maschinenstandorte hinzufügen, die keine nativen GTA-V-Props sind?

Ja. Definiere benutzerdefinierte Automaten in Config.CustomMachines mit Koordinaten, Prop-Modell und Gegenstandsliste. So fügst du Automaten in benutzerdefinierten MLO-Innenräumen hinzu, die der native Prop-Scanner nicht erreichen kann.

Können Spieler Automaten ausrauben?

In config.lua gibt es eine optionale Raubmechanik. Aktiviere sie und lege die Dauer zum Aufhebeln, die Fehlchance und die Beutemenge fest. Bei erfolgreichen Raubüberfällen erhalten Spieler einen Teil des aktuellen Lagerbestands als Gegenstände, und der Automat wird als beschädigt markiert, bis er wieder aufgefüllt wird. So gibt es eine kriminelle Einsatzmöglichkeit, ohne die Wirtschaft aus dem Gleichgewicht zu bringen, die Beute pro Automat ist absichtlich gering.

Wie funktioniert die Gewinnaufteilung, wenn mehrere Spieler denselben Automaten auffüllen?

Der Spieler, der den Automaten zuletzt aufgefüllt hat, erhält die Gewinnbeteiligung, bis der Automat leer ist und erneut aufgefüllt wird. Es gibt keine Aufteilung zwischen mehreren Spielern, die Automaten auffüllen. Wer zuletzt aufgefüllt hat, erhält die Einnahmen des nächsten Zyklus. So bleibt die Abrechnung einfach, und es entsteht ein natürlicher Wettbewerb zwischen Spielern, die Lieferouten betreiben.

Funktioniert das nur serverseitig, also ohne Client-Ressource?

Nein. Das Scannen der Automaten und die Interaktionsoberfläche laufen clientseitig. Agency-Vending verwendet Server- und Client-Skripte. Der Server verwaltet den Lagerbestand und die Wirtschaftstransaktionen, der Client übernimmt die Prop-Erkennung, die Darstellung der Oberfläche und die Auslöser für die Nähe zum Spieler.

Voraussetzungen

• FiveM-Server (QBCore, ESX oder standalone)
• oxmysql
• cfx.re-Konto mit gültiger Agency-Vending-Lizenz
• Optional: ox_lib (für UI-Komponenten, mit Ersatzlösung, falls nicht vorhanden)

Die Automatenwirtschaft erweitern

Die Automatenwirtschaft funktioniert am besten als Teil eines umfassenderen Systems für Essen und Getränke, statt als einzige Option. So kannst du sie wirkungsvoll ergänzen:

Selbst kochen (über ein Crafting-Skript) sollte die günstigste Möglichkeit sein, Essen mit den besten Buff-Werten zu erhalten, erfordert aber Zutaten und Zeit. Automaten sind die bequeme Option: keine Vorbereitung, sofortiger Kauf, moderate Kosten, moderate Buffs. Von Spielern betriebene Restaurants sind die Premium-Option: die besten Essens-Buffs, die höchsten Kosten, und ein Spieler muss als Koch arbeiten. Fast-Food-NPCs liegen zwischen Automaten und Restaurants.

Wenn alle vier Stufen vorhanden sind, treffen Spieler je nach Situation auf natürliche Weise wirtschaftliche Entscheidungen. Ein Spieler mitten in einer Mission nutzt einen Automaten, weil er nicht in einem Restaurant anhalten kann. Ein Spieler mit Zeit und Geld geht wegen des RP und der Buffs in ein von Spielern betriebenes Restaurant. Durch diese Abstufung entstehen sinnvolle Entscheidungen innerhalb der Wirtschaft, statt dass eine Option alle anderen dominiert.

Agency-Vending eignet sich auch gut als Einnahmequelle für Ladenbesitzer in Stadt-RP. Ein Ladenbesitzer, der in seinem Viertel „die Automatenroute besitzt“, hat eine passive Einnahmequelle und einen Grund, sein Gebiet zu patrouillieren und zu verteidigen.