Agency-Blackmarket: Eine Untergrundwirtschaft gestalten, ohne den Server zu gefährden

Warum die meisten Blackmarket-Scripts scheitern

Ein schlecht entwickeltes Blackmarket-Script ist der schnellste Weg, die Wirtschaft eines Servers zu ruinieren. Zu günstig und jeder wird kriminell. Zu teuer und niemand nutzt es. Zu sicher und es gibt kein Risiko. Zu riskant und die Spieler verlieren die Lust. Agency-Blackmarket wurde mit dem Fokus auf eine ausgewogene Wirtschaft entwickelt, die Feature-Liste kam an zweiter Stelle.

Dynamische Preise nach Nachfrage

Die Preise jedes Artikels ändern sich je nachdem, wie viele Spieler ihn in letzter Zeit gekauft haben. Angebot und Nachfrage regeln sich automatisch: Wenn der ganze Server AR-15s kauft, verdoppelt sich der Preis innerhalb weniger Stunden. Sinkt die Nachfrage, normalisieren sich die Preise langsam. So entstehen natürliche Marktrhythmen statt fester Einkaufslisten.

Die Risikoseite

Bei jedem Besuch des Schwarzmarkts besteht eine konfigurierbare Chance auf einen Polizeieinsatz, einen Hinterhalt oder eine Begegnung mit einem rivalisierenden NPC. Das Risiko steigt mit der Größe des Einkaufs. Clevere Spieler lernen, große Einkäufe auf mehrere Besuche aufzuteilen. Weniger vorsichtige Spieler werden erwischt und verlieren ihre Beute. Diese Spannung hält illegales RP interessant.

Admin-Werkzeuge

Jede Transaktion wird mit Spieler-ID, Artikel, Preis und Zeitstempel protokolliert. Admins sehen die Schattenwirtschaft des Servers auf einen Blick, können Mindestpreise festlegen oder bestimmte Artikel vorübergehend deaktivieren. Dank dieser Werkzeuge vertrauen professionelle RP-Communities unseren Scripts für ihre zentrale Wirtschaft. Wir verkaufen nicht nur Funktionen, sondern liefern auch die Verwaltungsebene, mit der sie sich im großen Maßstab betreiben lassen.

Integration mit deinen Jobs

Agency-Blackmarket stellt Events bereit, auf die Agency-Minerjob, Agency-Admin und deine Cop-Scripts reagieren können. Das Zusammenspiel im Ökosystem verstärkt sich: Jedes einzelne Script ist für sich nützlich, aber gemeinsam erzeugen sie systemisches, emergentes Verhalten, das du nicht manuell skripten könntest.

Installation & Einrichtung

Agency-Blackmarket benötigt oxmysql für die Transaktionsprotokollierung und das Speichern dynamischer Preise. Importiere blackmarket.sql, lege den Resource-Ordner ab und füge hinzu ensure agency-blackmarket in server.cfg. Die Standortkoordinaten werden definiert in config.luaDas Resource enthält sechs Standardkoordinaten für den Schwarzmarkt auf der Standardkarte von GTA V, die du durch deine eigenen MLO-Positionen ersetzen kannst.

Die zum Verkauf angebotenen Gegenstände müssen im Item-Register deines Frameworks vorhanden sein. Die Config enthält eine Standardliste mit Gegenständen. Du kannst Gegenstände ganz einfach über eine Config-Tabelle hinzufügen oder entfernen.

Konfigurationsoptionen

Die config.lua gibt dir die volle Kontrolle über Wirtschaft und Risikoeinstellungen:

• Item-Katalog, definiere jeden Gegenstand, seinen Basispreis, Mindestpreis, Höchstpreis und Nachfrageelastizitätsfaktor.
• Nachfragezeitraum, wie viele Stunden Kaufhistorie der Preisalgorithmus berücksichtigt. Standard: 6 Stunden.
• Risikoereignisse, konfiguriere die Wahrscheinlichkeit für einen Polizeieinsatz, einen Hinterhalt und das Auftauchen rivalisierender NPCs basierend auf dem Kaufbetrag.
• Standortrotation, Schwarzmarktstandorte können nach einem Zeitplan rotieren. So bleiben Spieler auf Informationen innerhalb der Spielwelt angewiesen, um den aktuellen Standort zu finden.
• Preisüberschreibung durch Admins, Admins mit höheren Berechtigungen können während wirtschaftlicher Ereignisse vorübergehend Mindest- oder Höchstpreise für einzelne Gegenstände festlegen.
• Aufbewahrungsdauer des Transaktionsprotokolls, wie viele Tage der Kaufverlauf gespeichert wird. Standard: 30 Tage.

Framework-Kompatibilität

QBCore- und ESX-Adapter sind im Paket enthalten. Für standalone musst du vier Config-Funktionen implementieren: Gegenstand geben, Geld abziehen, Polizeialarm auslösen und optional den zugriffsbasierten Jobfilter. Die Preisberechnung, das Risikoereignissystem, die Standortverwaltung und die Admin-Tools sind vollständig frameworkunabhängig.

Warum das für Roleplay wichtig ist

Eine illegale Wirtschaft, die zu sicher funktioniert, verkommt zu einem gewöhnlichen Einkaufsbummel. Das Risikosystem von Agency-Blackmarket wurde speziell dafür entwickelt, dass sich jeder bedeutende Kauf wie eine Entscheidung anfühlt, nicht wie eine Transaktion. Wer zehn Minuten damit verbringt, einen großen Waffenkauf zu planen, den Standort auszukundschaften, den richtigen Zeitpunkt für die Annäherung abzupassen und zu entscheiden, ob Verstärkung mitkommen soll, sorgt für besseres RP als jemand, der einfach ein Menü öffnet und auf „Kaufen“ klickt.

Die dynamische Preisgestaltung schafft auf natürliche Weise Knappheit, ganz ohne Eingreifen der Admins. Wenn sich der ganze Server für einen geplanten Konflikt bewaffnet, signalisiert der Preisanstieg bei Waffen diese Entwicklung allen, die den Markt prüfen. Gewiefte kriminelle Charaktere lernen, vor dem Nachfrageanstieg einzukaufen. Dieses dynamische Verhalten in der Wirtschaft sorgt für strategische Tiefe, die fest vorgegebene Preise in Menüs niemals bieten können.

Das Admin-Transaktionsdashboard zeigt, wie eine verantwortungsvolle Verwaltung der RP-Wirtschaft aussieht. Wenn die illegale Wirtschaft eines Servers undurchsichtig ist, können Admins nicht erkennen, ob alles im Gleichgewicht oder aus dem Ruder gelaufen ist, bis sich Spieler beschweren. Mit vollständiger Einsicht in die Transaktionen siehst du in Echtzeit, ob ein Spieler oder eine Gruppe unverhältnismäßig viel kauft, und kannst eingreifen, bevor das Ungleichgewicht das kriminelle Ökosystem des Servers ruiniert.

Häufig gestellte Fragen

Kann ich festlegen, dass bestimmte Gegenstände nur für bestimmte kriminelle Organisationen zugänglich sind?

Ja. Jeder Gegenstand im Katalog unterstützt ein optionales requiredFlag Feld. Spieler, bei denen diese Kennzeichnung gesetzt ist, verwaltet über Agency-Admin oder dein eigenes System, können den Gegenstand sehen und kaufen. Für alle anderen wird er ausgegraut und mit dem Hinweis „restricted“ angezeigt. So entsteht ein Schwarzmarkt mit mehreren Stufen, auf dem kriminelle Rollen mit höherem Rang Zugang zu besserem Inventar haben.

Wie funktioniert der Hinterhalt?

Wenn ein Hinterhalt ausgelöst wird, erscheint eine Gruppe feindlicher NPCs am Schwarzmarktstandort und greift den Spieler sofort an. Anzahl und Ausrüstung der NPCs richten sich nach dem Kaufbetrag, der das Ereignis ausgelöst hat. Spieler, die den Hinterhalt überleben, behalten ihren Einkauf. Wer nicht überlebt, verliert ihn an das Beutesystem. Das ist bewusst hart gehalten, das Risiko muss real sein.

Kann ich die Preisdaten zur externen Analyse exportieren?

Das Transaktionsprotokoll in oxmysql kann direkt abgefragt werden. Außerdem stellen wir einen serverseitigen Export exports['agency-blackmarket']:GetPriceHistory(item, hours) bereit, der eine Tabelle mit Preis-Snapshots zurückgibt. Verbinde ihn mit einem beliebigen externen Dashboard-Tool, wenn du den Verlauf der illegalen Wirtschaft deines Servers als Diagramm darstellen möchtest.

Wie verhindere ich, dass ein Spieler das Nachfragesystem manipuliert, um Preise zu beeinflussen?

Lege fest Config.PerPlayerDemandCap = true und Config.MaxPlayerDemandWeight = 0.3. Damit wird begrenzt, wie stark die Kaufhistorie eines einzelnen Spielers den globalen Preis beeinflussen kann. Ein Käufer kann die Nachfrage weiterhin manipulieren, aber um Preise deutlich zu bewegen, ist eine anhaltende Abstimmung zwischen mehreren Spielern nötig.

Voraussetzungen

• FiveM-Server (QBCore, ESX oder standalone)
• oxmysql
• cfx.re-Konto mit gültiger Agency-Blackmarket-Lizenz
• Optional: Agency-Admin (für ein integriertes Dashboard zur Transaktionsüberwachung)

Saisonale Wirtschaftsevents über die Admin-Preiskontrollen

Die Admin-Preistools von Agency-Blackmarket eröffnen neue Möglichkeiten für ereignisgesteuerte Wirtschaftssysteme. Einige Muster, die sich bewährt haben:

Wettrüsten-Event: Senke die Waffenpreise für 48 Stunden um 30 % und kündige das Event im Spiel über Nachrichtenmeldungen von NPCs an. So entsteht ein kurzes Zeitfenster mit erhöhter krimineller Aktivität, auf die sich die Polizei einstellen kann. Das Zeitfenster schließt sich, bevor die Wirtschaft aus dem Gleichgewicht gerät.

Versorgungsschock: Deaktiviere vorübergehend eine Warengruppe, zum Beispiel eine Woche lang alle Sprengstoffe. Die Knappheit führt zu Hamsterkäufen, Schwarzhandel zwischen Spielern und RP rund um den Mangel. Stelle die Verfügbarkeit wieder her und beobachte, wie sich der Markt normalisiert.

Einführung neuer Schmuggelware: Führe einen neuen Gegenstand zu einem hohen Preis und mit langsamem Nachfragerückgang ein. Frühe Käufer zahlen einen Aufpreis. Sobald andere Spieler davon erfahren, steigt die Nachfrage und die Preise schnellen in die Höhe, bevor sie sich wieder normalisieren. Anhand des Preisverlaufs kannst du nachvollziehen, wie deine Community den neuen Gegenstand angenommen hat.

Für solche Wirtschaftsevents musst du keine individuelle Logik programmieren, es sind Änderungen an der Admin-Konfiguration. Genau darum geht es: Server-Admins, die nicht entwickeln, können mit dem Admin-Panel von Agency-Blackmarket wirtschaftlich interessante Events durchführen.