Das am meisten ungenutzte Prop in GTA V
GTA V ist gespickt mit Getränkeautomaten, die in Vanilla-FiveM-Servern rein dekorativ sind. Agency-Vending macht jeden einzelnen davon funktional — Spieler gehen hin, interagieren, kaufen Essen oder Getränke zu vernünftigen Preisen und bekommen passende Buffs. Einfach, allgegenwärtig, und die Map fühlt sich dadurch lebendig an, wie es in Vanilla nie passiert.
Bestände, die sich leeren
Jeder Automat hat einen individuellen Bestand, der sich leert, während Spieler Artikel kaufen. Leere Automaten zeigen einen "Ausverkauft"-Zustand, bis sie wieder aufgefüllt werden. Klingt nebensächlich, schafft aber eine neue Jobrolle: Automaten-Routen-Betreiber. Spieler, die Automaten nachfüllen, bekommen einen Anteil der Verkäufe, die aus ihrem Bestand passieren. Plötzlich hat jedes Prop wirtschaftliche Aktivität.
Artikelvielfalt pro Automatentyp
Limo-Automaten verkaufen Getränke mit kleinen Durst-Effekten. Snack-Automaten verkaufen Essen mit Hunger-Effekten. Kaffee-Kioske verkaufen Heißgetränke, die Müdigkeit beseitigen. Agency-Vending erkennt den Automatentyp automatisch am Prop-Modell und bestückt ihn entsprechend. Null Konfiguration für Standardplatzierungen.
Preissignale
Die Preise sind absichtlich günstiger als Restaurant-Essen, aber teurer als zu Hause kochen. Das erzeugt eine sinnvolle wirtschaftliche Hierarchie: zu Hause > Automat > Fast Food > Restaurants. Spieler gravitieren ganz natürlich zur Option, die zu ihrer Situation passt — genau so funktioniert echtes Kaufverhalten.
Admin-Reporting
Server-Admins bekommen eine wöchentliche Zusammenfassung der Automatenaktivität: welche Automaten am meisten einbringen, welche zu selten nachgefüllt werden, welche Stadtteile Bedarfslücken haben. Diese Daten sind Gold wert, um die Map zu balancieren und neue Gameplay-Möglichkeiten zu identifizieren, ohne Spieler mit Umfragen zu nerven.
Installation & Einrichtung
Agency-Vending benötigt oxmysql für das Lager-Tracking pro Automat. Importiere vending.sql, lege den Ressourcenordner auf dem Server ab und füge ensure agency-vending zur server.cfg hinzu. Beim ersten Start scannt die Ressource die Karte nach allen nativen Automaten-Stützpunkten und registriert sie automatisch in der Datenbank.
Konfigurationsoptionen
- Lager pro Automat — Wie viele Einheiten ein Automat hält, bevor er nachgefüllt werden muss. Standard: 50.
- Nachfüllmethode — Automatisches zeitgesteuertes Nachfüllen, spielergesteuertes Nachfüllen oder nur Admin-Nachfüllen.
- Gewinnaufteilung — Prozentsatz des Umsatzes, der an den Spieler geht, der zuletzt einen Automaten aufgefüllt hat.
- Out-of-Stock-Visual — Schalte den "leer"-visuellen Zustand an Automaten-Stützpunkten um.
Framework-Kompatibilität
QBCore- und ESX-Adapter sind gebündelt. Für eigenständige Server implementiere Config.GiveItem(src, item, count) und Config.TakeMoney(src, amount).
Warum das für das Roleplay wichtig ist
Kartendichte ist einer der unterschätzten Faktoren bei der RP-Serverqualität. Wenn Spieler mit mehr Stützpunkten auf der Karte interagieren können — Automaten, Bänke, Mülltonnen, Türen — fühlt sich die Welt bewohnt an, nicht nur theatralisch. Agency-Vending ist einer der einfachsten Gewinne in diese Richtung.
Häufig gestellte Fragen
Kann ich benutzerdefinierte Automaten-Standorte hinzufügen, die keine nativen GTA V-Stützpunkte sind?
Ja. Definiere benutzerdefinierte Automaten in Config.CustomMachines mit Koordinaten, Stützpunktmodell und Item-Liste.
Können Spieler Automaten ausrauben?
Es gibt einen optionalen Raubmechanismus in config.lua. Aktiviere ihn und stelle die Aufbrech-Dauer, Fehlschlagchance und Beute-Reichweite ein.
Voraussetzungen
- FiveM-Server (QBCore, ESX oder eigenständig)
- oxmysql
- cfx.re-Konto mit gültiger Agency-Vending-Lizenz
Die Vending-Wirtschaft erweitern
Die Automaten-Wirtschaft funktioniert am besten, wenn sie Teil eines umfassenderen Essen- und Trinksystems ist, nicht die einzige Option. So kann man sie effektiv schichten:
Heimkochen (über ein Crafting-Script) sollte der günstigste Weg sein, Essen mit den besten Buff-Werten zu bekommen — erfordert aber Zutaten und Zeit. Automaten sind die Komfortstufe: keine Vorbereitung, sofortiger Kauf, moderate Kosten, moderate Buffs. Von Spielern betriebene Restaurants sind die Premium-Stufe: die besten Essen-Buffs, höchste Kosten, erfordert einen Spieler-Koch. NPC-Fastfood liegt zwischen Automaten und Restaurants.
Wenn alle vier Stufen existieren, treffen Spieler natürliche wirtschaftliche Entscheidungen basierend auf ihrer Situation. Ein Spieler mitten in einer Mission nutzt einen Automaten, weil er nicht in einem Restaurant aufhalten kann. Ein Spieler mit Zeit und Geld geht zu einem Spieler-Restaurant für das RP und den Buff.
Vending als Einkommensstrom für Viertelunternehmen
Agency-Vending funktioniert gut als Einkommensstrom für Nachbarschaftsgeschäftsinhaber im Stadt-RP. Ein Ladenbesitzer, dem die "Automatenroute" in seinem Viertel "gehört", hat einen passiven Einkommensmechanismus und einen Grund, sein Territorium zu patrouillieren und zu verteidigen. Diese Eigenverantwortung schafft natürliches Konfliktroleplay — rivalisierende Gruppen, die die Route übernehmen wollen, oder Schutzgelder-Forderungen von lokalen Kriminellen.
Wöchentliche Wirtschaftsberichte für Serveradmins
Server-Admins bekommen eine wöchentliche Zusammenfassung der Automaten-Aktivität: welche Maschinen am meisten verdienen, welche zu wenig nachgefüllt werden, in welchen Stadtteilen Nachfragelücken bestehen. Diese Daten sind Gold für die Ausbalancierung der Karte und das Identifizieren neuer Gameplay-Möglichkeiten, ohne Spieler mit Umfragen zu belästigen.
Diese Wirtschaftsdaten sind besonders wertvoll für Serverbesitzer, die wichtige Entscheidungen über die Kartengestaltung treffen. Wenn eine bestimmte Automatenposition wöchentlich der meistgekaufte Standort ist, zeigt das, wo Spieler tatsächlich Zeit verbringen — nicht wo du dachtest, sie würden Zeit verbringen. Wenn ein MLO-Viertel keine Automatennutzung zeigt, deutet das darauf hin, dass weniger Spieler diesen Bereich besuchen als erwartet, was eine Infra-Überprüfung für das Gebiet auslösen könnte.
Automaten als lebendige Welt-Indikatoren
Leer gewordene Automaten signalisieren dynamisch, wo die Aktionen auf deinem Server stattfinden. In ruhigen Zeiten sind die meisten Automaten voll. Während eines großen Server-Events kann ein bestimmtes Viertel seine Automaten schnell leeren. Diese emergenten Muster sind interessante Server-Daten, die ohne jede zusätzliche Tracking-Infrastruktur entstehen — die Automaten-Wirtschaft funktioniert gleichzeitig als Spielmechanik und als Nutzungsanalytik-Tool.
Die Erfahrung auf dem Spieler-Client
Aus Spielerperspektive ist Agency-Vending eine nahezu unsichtbare Bereicherung. Spieler nähern sich einem Automaten, sehen eine Interaktions-Aufforderung, wählen aus dem Menü und erhalten ihr Item. Es gibt keine komplizierte Mechanik zum Erlernen, keine besonderen Voraussetzungen zu erfüllen. Das ist gewollt — Automaten sollen der Komfortweg für Essen und Trinken sein, nicht eine Herausforderung.
Die "Out of Stock"-Anzeige ist der einzige Moment, in dem die Mechanik für einen Spieler überraschend sein kann. Spieler, die zum ersten Mal einen leeren Automaten sehen, fragen manchmal im OOC-Chat, ob etwas kaputt ist. Kommuniziere beim Server-Launch klar, dass Automaten sich leeren und nachgefüllt werden müssen — eine einmalige Ankündigung im Server-Discord reicht, danach ist das Konzept für neue Spieler durch bestehende Spieler erklärt.
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.