Agency-Minerjob: So sollte ein Job-Skript wirklich funktionieren

Warum Jobs sich meist eintönig anfühlen

Die meisten FiveM-Jobskripte folgen einer monotonen Schleife: Geh zu X, drück E, warte, verkauf bei Y. Spieler machen es einmal, um Geld zu verdienen, spielen es nie als RP und wenden sich dann etwas anderem zu. Agency-Minerjob wurde so entwickelt, dass sich ein einzelner Job durch Fortschritt, soziale Tiefe und variable Erträge über Dutzende Stunden lohnt.

Bedeutungsvoller Kompetenzfortschritt

Bergleute entwickeln sich in etwa 30 Spielstunden vom Anfänger zum Meister. Jede Stufe schaltet neue Abbaustellen, bessere Werkzeuge, seltenere Erzarten und einen schnelleren Abbau frei. Der Fortschritt erhöht nicht nur den Verdienst, sondern schaltet auf jeder Stufe wirklich anderes Gameplay frei.

Umgebungsmechaniken

Die Fördermenge hängt von der Qualität des Standorts, der Tageszeit, dem Wetter und dem Zustand des Werkzeugs ab. Die Goldmine bei Nacht, klarem Wetter und mit einer gepflegten Spitzhacke liefert andere Ergebnisse als die Kohleader bei Regen und mit einem abgenutzten Werkzeug. Neue Spieler erkennen diese Variablen nicht unbedingt, aber erfahrene Bergleute lernen, ihr Vorgehen daran auszurichten. Genau diese sich entwickelnde Meisterschaft hält Jobs langfristig interessant.

Soziale Tiefe

Beim Bergbau können sich Gruppen von 2-6 Spielern zusammentun und gemeinsame XP-Pools sowie Bonusmultiplikatoren nutzen. Größere Gruppen verdienen mehr, sind aber auffälligere Ziele für Überfälle. So entsteht echtes soziales Gameplay, bei dem Koordination zählt und Vertrauen zwischen Spielern zu einer Ingame-Währung wird.

Der Wirtschaftsfaktor

Rohmetalle fließen in Veredelungsketten ein, auf die der Rest der Serverwirtschaft angewiesen ist. Waffenhersteller brauchen Metalle. Bauarbeiter brauchen Baustoffe. Agency-Minerjob ist keine isolierte Arbeitsschleife, sondern eine Zuliefererrolle in einem umfassenderen Wirtschaftssystem. Das macht einen Job für den Server wirklich relevant.

Installation & Einrichtung

Agency-Minerjob benötigt oxmysql für die Fortschrittsdaten der Spieler und die Erfassung der Erzfördermenge. Importiere minerjob.sql, lege den Resource-Ordner ab und füge hinzu ensure agency-minerjob in server.cfgKoordinaten der Abbaustellen, Erzartdefinitionen und Gegenstände der Veredelungsketten sind alle in config.luadefiniert. Die Standardkonfiguration enthält acht Abbaustellen auf der Standardkarte von GTA V.

Erzgegenstände und verarbeitete Materialien müssen in der Gegenstandsregistrierung deines Frameworks vorhanden sein. Die Konfiguration enthält vollständige Gegenstandsdefinitionen für QBCore und ESX. Standalone-Setups übernehmen das Hinzufügen und Entfernen von Gegenständen über Config-Hooks.

Konfigurationsoptionen

Die config.lua bietet umfassende Kontrolle über die Jobmechaniken:

• Qualität der Abbaugebiete, jedes Abbaugebiet hat einen Basis-Ertragsmodifikator. In Gebieten mit höherer Qualität erhältst du pro Aktion mehr Ertrag, benötigst aber möglicherweise eine höhere Skillstufe, um Zugang zu erhalten.
• Schwellenwerte der Skillstufen, lege fest, wie viel XP für jede Stufe benötigt werden und was dadurch freigeschaltet wird (Abbaugebiete, Werkzeuge, Erzsorten).
• Umgebungsmodifikatoren, aktiviere oder deaktiviere Ertragseffekte durch Wetter und Tageszeit und lege den Multiplikatorbereich fest.
• Haltbarkeit von Werkzeugen, legt fest, wie viele Abbauaktionen ein Werkzeug durchhält, bevor es repariert werden muss. Deaktiviere diese Funktion für ein einfacheres Spielerlebnis.
• Gruppenbonus, XP- und Ertragsmultiplikator pro zusätzlichem Gruppenmitglied sowie die maximale Gruppengröße.
• Überfallsystem, aktiviere Hinterhalte durch feindliche NPCs oder Spieler, die ab einer festgelegten Gruppengröße ausgelöst werden.
• Veredelungskette, lege fest, welche Roherze zu welchen Materialien veredelt werden, mit welchem Mengenverhältnis und Zeitaufwand.

Framework-Kompatibilität

Vollständige QBCore- und ESX-Adapter sind im Paket enthalten. Für standalone implementierst du fünf Config-Funktionen: Items geben/entfernen, Geld hinzufügen, Job prüfen (für den Zugang zu Abbaugebieten) und XP speichern. Die Skill-Progression, das Gruppensystem, die Umgebungsmechaniken und die Veredelungskette sind alle framework-agnostisch.

Warum das für Roleplay wichtig ist

Ein Job, der ausschließlich als Geldquelle dient, wird sich immer hohl anfühlen. Agency-Minerjob behandelt den Bergbaujob als Beruf mit echter Tiefe. Ein Charakter, der 30 Stunden lang abbaut, hat wirklich etwas aufgebaut: Wissen über Abbaugebiete, Geschick im Umgang mit Werkzeugen, ein Netzwerk aus Gruppenmitgliedern und Beziehungen zu Veredlern und Käufern. Dieses angesammelte Charakterkapital macht dauerhaftes Job-RP erst möglich.

Besonders das Gruppensystem schafft soziales RP, das bei den meisten Job-Scripts fehlt. Zwei Spieler, die gemeinsam abbauen, verdoppeln nicht einfach nur ihren Ertrag. Sie führen ein Gespräch, bauen Vertrauen auf und entscheiden, ob sie eine dritte Person einladen, die sie noch nicht richtig kennen. Das Überfallrisiko bei größeren Gruppen zwingt sie dazu, abzuwägen, ob es sich lohnt, den Fremden mitzunehmen, wenn sie dadurch zu einem größeren Ziel werden.

Die Integration in die Lieferkette hebt Agency-Minerjob von einem „Mining-Script“ zu einer „Server-Wirtschaftsebene“. Wenn Waffenhersteller, Bauarbeiter und Hersteller von Reparaturkits alle Materialien benötigen, die aus dem Bergbau stammen, bleibt der Bergbaujob dauerhaft relevant. Bergleute grinden nicht allein, sondern versorgen andere Spieler und pflegen Beziehungen zu ihren Käufern.

Häufig gestellte Fragen

Kann ich an benutzerdefinierten Kartenorten aus einem DLC oder MLO Abbaugebiete hinzufügen?

Ja. Abbaugebiete werden in config.lua über Koordinaten und einen Radius definiert. Füge die Koordinaten deines MLO-Innenbereichs mit einem Interior-Flag hinzu, und Agency-Minerjob erkennt den Zugang zum Innenbereich automatisch. Benutzerdefinierte Erzsorten an benutzerdefinierten Orten lassen sich genauso einfach einrichten.

Wie wird die Skill-Progression über Neustarts hinweg gespeichert?

Die Skill-Daten werden in oxmysql gespeichert und sind der Spielerkennung zugeordnet. Die Progression bleibt über Neustarts, Framework-Wechsel und Charakterwechsel hinweg bestehen (bei Mehrcharaktersystemen). Der Fortschritt wird nur zurückgesetzt, wenn du manuell das Wipe-SQL ausführst oder sich die Spielerkennung ändert.

Kann ich die Umgebungsmechaniken für einen einfacheren Server deaktivieren?

Ja. Setze Config.UseEnvironmentalModifiers = false in config.lua. Der Ertrag hängt dann nur von der Skillstufe, der Werkzeugqualität und der Qualität des Abbaugebiets ab. Das System ist einfacher, behält aber weiterhin verschiedene Stufen bei. Du kannst die Umgebungsmechaniken später wieder aktivieren. Der bestehende Fortschritt der Spieler bleibt dabei erhalten.

Ist Agency-Minerjob für Server ausgewogen, bei denen Bergbau die primäre Einkommensquelle oder einer von vielen Jobs ist?

Die Standardkonfiguration geht davon aus, dass Bergbau eine von mehreren Joboptionen ist. Wenn Bergbau deine primäre Einkommensquelle ist, erhöhe die Ertragsraten insgesamt um 40-60 %. Dafür gibt es einen Config.GlobalYieldMultiplier für genau diesen Zweck. Passe nicht die Raten einzelner Abbaugebiete an, sondern verwende den globalen Multiplikator, damit die relativen Werte ausgewogen bleiben.

Voraussetzungen

• FiveM-Server (QBCore, ESX oder standalone)
• oxmysql
• cfx.re-Konto mit gültiger Agency-Minerjob-Lizenz
• Optional: Agency-Repairkit (für die Crafting-Integration)
• Optional: Agency-Blackmarket (für die Anbindung an die Erzverkaufswirtschaft)

Ein Bergbauunternehmen als Geschäft betreiben

Das Gruppensystem und die Fortschrittsverfolgung von Agency-Minerjob ermöglichen es, tatsächliche Bergbauunternehmen als Geschäfte auf dem Server zu betreiben, statt nur einzelne Spieler grinden zu lassen. So sieht der Betrieb eines Bergbauunternehmens in der Praxis aus:

Der Charakter des Unternehmensinhabers stellt Arbeiter ein (andere Spieler), teilt sie je nach Skill-Stufe Bergbaustandorten zu und organisiert den Massenverkauf verarbeiteter Materialien an Waffenbauer, Bauunternehmer oder den Schwarzmarkt. Die Koordination mehrerer Bergleute, die Verwaltung der Werkzeugvorräte (damit alle gutes Werkzeug haben) und der Schutz großer Erzlieferungen vor Überfällen schaffen echte organisatorische Herausforderungen.

Der Gruppenbonus-Multiplikator schafft einen wirtschaftlichen Anreiz zur Zusammenarbeit, der nicht künstlich eingebaut wurde, sondern sich aus den Spielmechaniken ergibt. Fünf koordinierte Bergleute verdienen pro Stunde deutlich mehr als fünf einzelne Bergleute, die dasselbe tun. Das bedeutet, dass sich der Koordinationsaufwand messbar auszahlt. Genau das macht Geschäftsorganisationen nachhaltig: Die Organisationsform muss wirtschaftlich vorteilhafter sein als allein zu arbeiten, sonst machen sich Spieler nicht die Mühe, den Koordinationsaufwand auf sich zu nehmen.