X-SOLUTION
Dokumentation

X-Jobscreator einrichten

Jobs, Ränge, Zonen, Personal und Wirtschaft — komplett im Spiel verwaltet, ohne Config-Dateien und ohne Serverneustart. Diese Anleitung führt dich vom Download bis zum fertig aufgebauten Betrieb.

Voraussetzungen

  • FiveM Server mit aktuellem Artifact
  • es_extended (ESX Legacy) oder qb-core
  • oxmysql
  • Adminzugang über Framework-Gruppe oder Ace-Permission

Optional, wird automatisch erkannt:

  • Target: ox_target oder qb-target
  • Inventar: ox_inventory oder qb-inventory
  • Fraktionskasse: esx_society beziehungsweise management_funds auf QBCore

Installation

  1. Lade x-jobscreator aus dem Cfx.re Portal herunter.
  2. Entpacke den Ordner nach resources/[x-solution]/x-jobscreator.
  3. Trage die Resource in deiner server.cfg ein, nach Framework und Datenbank:
ensure oxmysql
ensure es_extended
ensure x-jobscreator
  1. Server neu starten. Die Tabellen legt das Script beim ersten Start selbst an, vorhandene ESX- und QBCore-Jobs werden dabei eingelesen.
  2. Drücke im Spiel F7. Unter Einstellungen → Systemstatus siehst du, ob Framework, Inventar und Target sauber erkannt wurden.

Möchtest du die Datenbank von Hand aufsetzen, setze Config.Database.autoMigrate = false und importiere sql/schema.sql sowie sql/schema_v2.sql.

Befehle und Tasten

Befehl Standardtaste Wirkung
/jobcreator F7 Admin-Panel öffnen
— F6 Aktionsmenü: Dienst, Rechnungen, Personen, Ausweise, Fahrzeuge
/bewerben — Bewerbung bei einem Betrieb einreichen
/rechnungen — Offene Rechnungen ansehen und bezahlen

Im Panel selbst:

Taste Wirkung
Strg + K Befehlspalette — springt zu jedem Job und jeder Aktion
Strg + Z Letzte Änderung rückgängig machen
Esc Zurück zur Übersicht, dann schließen

Den Befehl änderst du in Config.AdminCommand, die Taste in Config.AdminKeybind.

Erste Schritte

  1. Öffne das Panel mit F7 und wechsle zu Jobs.
  2. Klicke auf Neuer Job. Der Assistent führt dich durch Basisdaten, Ränge und eine Zusammenfassung.
  3. Nach dem Anlegen landest du direkt in der Detailansicht. Lege dort im Reiter Zonen mindestens einen Dienstpunkt an.
  4. Ergänze nach Bedarf Fuhrpark, Lager, Shop, Waffenkammer und Uniformen.
  5. Fertig — der Betrieb ist sofort live, ein Neustart ist nicht nötig.

Schneller geht es über Vorlagen: Sieben fertige Betriebe stehen bereit, inklusive passender Ränge.

Wichtige Einstellungen

Adminzugang

Config.AdminGroups = { 'admin', 'superadmin', 'god' }
Config.AdminCommand = 'jobcreator'
Config.AdminKeybind = 'F7'

Alternativ über Ace-Permissions. Trag dafür in deine server.cfg ein:

add_ace group.admin xjc.admin allow

Anbindungen

Config.Framework = 'auto'
Config.Target    = 'auto'
Config.Inventory = 'auto'

auto prüft beim Start, welche Resources laufen. Nur wenn mehrere gleichzeitig laufen oder die Erkennung danebenliegt, trägst du hier fest ein, was genutzt werden soll — etwa 'ox_target' oder 'qb-inventory'.

Job-Sync

Config.Sync = {
    enabled = true,
    syncOnStart = true,
    ignoreJobs = { 'unemployed', 'off' },
    autoImportGrades = true
}

Importiert Betriebe, die im Framework existieren, aber noch nicht im Jobscreator stehen. Das läuft beim Start automatisch und lässt sich im Panel unter Einstellungen jederzeit erneut anstoßen.

Gehalt

Config.Salary = {
    enabled = true,
    intervalMinutes = 30,
    payFromSociety = true,
    offDutyPay = false,
    notifyPlayer = true
}

Das sind die Standardwerte für neue Betriebe. Jeder Job bekommt im Panel unter Wirtschaft → Lohnmodell sein eigenes Modell und überschreibt diese Werte.

Fraktionskasse

Config.Society = {
    enabled = true,
    defaultBalance = 0,
    taxRate = 0.0
}

Steht payFromSociety auf true, wird nichts ausgezahlt, sobald die Kasse leer ist — der Vorgang landet stattdessen im Log. So merkst du sofort, wenn ein Betrieb sich nicht mehr trägt.

Marker und Blips

Config.Markers = {
    defaultType = 25,
    defaultColor = { r = 79, g = 142, b = 247, a = 160 },
    drawDistance = 30.0,
    interactDistance = 2.5
}

Config.Blips = {
    defaultSprite = 280,
    defaultColor = 3,
    defaultScale = 0.8,
    defaultShortRange = true
}

Das sind Vorgaben für neue Zonen. Jede Zone lässt sich im Panel einzeln überschreiben. Sprite-Nummern findest du in der FiveM-Blip-Liste.

Standard-Berechtigungen

Config.DefaultPermissions = {
    recruit   = false,
    fire      = false,
    promote   = false,
    demote    = false,
    garage    = true,
    stash     = true,
    shop      = true,
    armory    = false,
    cloakroom = true,
    billing   = false,
    society   = false,
    manage    = false
}

Mit diesen Rechten startet jeder neu angelegte Rang. Der höchste Rang eines Jobs bekommt automatisch alle Rechte.

Discord

Config.Discord = {
    enabled = false,
    webhook = '',
    botName = 'X-Jobscreator'
}

Config.SocietyWebhook = ''

Mit enabled = true und einer Webhook-URL landet jede Job-Änderung in deinem Log-Kanal. Config.SocietyWebhook ist optional und nimmt nur Geldbewegungen auf; bleibt er leer, wird der Haupt-Webhook genutzt. Beides lässt sich auch direkt im Panel unter Einstellungen eintragen und testen.

Limits

Config.Limits = {
    maxJobs = 200,
    maxGradesPerJob = 20,
    maxZonesPerJob = 50,
    maxGaragesPerJob = 10,
    maxEmployeesPerJob = 100,
    maxVehiclesPerGarage = 30
}

Obergrenzen gegen Fehlbedienung. maxEmployeesPerJob ist nur der Standard — die tatsächliche Mitarbeiterzahl legst du pro Betrieb im Panel fest.

Jobs bauen

Ränge und Rechte

Jeder Rang hat eine Nummer (0 ist der Einstieg), ein Gehalt und eigene Rechte:

Recht Erlaubt dem Rang
Einstellen Mitarbeiter aufnehmen und Bewerbungen annehmen
Entlassen Mitarbeiter aus dem Betrieb entfernen
Befördern / Degradieren Rang eines Mitarbeiters ändern
Fuhrpark Dienstfahrzeuge ausparken
Lager Gemeinsames Inventar öffnen
Shop Im Job-Shop einkaufen
Waffenkammer Waffen und Ausrüstung entnehmen
Umkleide Dienstkleidung wechseln
Rechnungen Anderen Spielern Beträge in Rechnung stellen
Fraktionskasse Ein- und auszahlen im Rahmen des Budget-Limits
Boss-Panel Vollzugriff auf die Betriebsverwaltung im Spiel

Zusätzlich bekommt jeder Rang ein Budget-Limit: den höchsten Betrag, den er auf einmal aus der Fraktionskasse entnehmen darf. 0 bedeutet unbegrenzt.

Zonen

Zonen sind die Punkte, an denen im Spiel etwas passiert. Die Position setzt du auf drei Wegen:

  • Meine Position übernimmt deine aktuellen Koordinaten samt Blickrichtung.
  • Freecam schließt das Panel, du fliegst zur Stelle und bestätigst dort.
  • Karte setzt den Punkt per Klick; die Höhe solltest du danach kurz prüfen.

Bereits gesetzte Zonen verschiebst du auf der Karte per Drag & Drop — das ist sofort gespeichert und im Spiel aktiv. Strg + Z nimmt das zurück.

Typ Was der Spieler dort tut
duty Ein- und ausstempeln, Grundlage für Dienstzeit und Gehalt
cloakroom Dienstkleidung wechseln
garage Dienstfahrzeuge ausparken
stash Gemeinsames Lager öffnen
shop Items kaufen
armory Waffen und Ausrüstung entnehmen
crafting Items herstellen
frontdesk Bewerbungsformular für Besucher
billing Rechnung an eine Person in der Nähe stellen
boss Boss-Panel für berechtigte Ränge
harvest, weapon_upgrade, teleport Spezialpunkte für eigene Abläufe
custom Löst ein eigenes Event aus

Pro Zone stellst du Radius, Mindest-Rang, Blip und den Interaktionsmodus ein: Bodenmarker mit E, Target-Auge oder beides.

Fuhrpark, Lager und Shops

Eine Garage besteht aus einem Spawnpunkt und einer Fahrzeugliste. Pro Fahrzeug legst du Mindest-Rang, Livery und optional einen Preis aus der Fraktionskasse fest. Ein Limit wie „höchstens zwei Stück in vier Stunden“ verhindert, dass der teure Wagen dauerhaft draußen steht.

Ein Lager ist gemeinsamer Stauraum. Bezeichnung, Slots, Gewicht und Mindest-Rang eintragen — die Anmeldung beim Inventarsystem passiert automatisch.

Shop, Waffenkammer und Werkbank funktionieren gleich: Ausgabepunkt anlegen, Positionen hinzufügen. Beim Hinzufügen durchsuchst du dein Inventarsystem direkt im Panel, statt Item-Namen abzutippen.

Uniformen

Zieh im Spiel die gewünschte Kleidung an, öffne Uniformen → Uniform erstellen und klicke auf Outfit übernehmen. Danach nur noch benennen und den Rangbereich festlegen — die Uniform steht sofort in der Umkleide zur Auswahl.

F6-Menü

Mit F6 öffnet jeder Mitarbeiter das Aktionsmenü seines Jobs — ein schmales Panel am rechten Bildrand, die Spielwelt bleibt sichtbar. Welche Aktionen dort auftauchen, legst du pro Job im Panel unter Einstellungen → F6-Aktionen fest.

Bereich Aktionen
Allgemein Dienst an und aus, Rechnung ausstellen
Personen Handschellen, Durchsuchen, Verarzten, Wiederbeleben
Ausweise Ausweis, Führerschein und Waffenschein prüfen
Fahrzeug Reparieren, Waschen, Aufbrechen, Halter abfragen, Abschleppen

Bedient wird per Maus oder Tastatur: Pfeiltasten und Enter, die Zahlen 1 bis 9 wählen direkt. Aktionen an Personen öffnen eine Liste aller Spieler in der Nähe mit Entfernung — wer außer Reichweite ist, ist ausgegraut. Ausweis-, Lizenz- und Halterabfragen erscheinen als Karte direkt im Menü.

Jede Aktion prüft der Server erneut: die Berechtigung des Jobs und die tatsächliche Entfernung zur Person oder zum Fahrzeug.

  • Rechnungen brauchen zusätzlich die Rang-Berechtigung Rechnungen. Chef-Ränge haben sie immer.
  • Verarzten und Wiederbeleben nutzen esx_ambulancejob oder qb-ambulancejob, falls installiert.
  • Durchsuchen öffnet das Inventar der Person und funktioniert mit ox_inventory sowie aktuellem qb-inventory.
  • Handschellen sind eingebaut: Gefesselte können nicht rennen, springen, zielen oder ein Fahrzeug betreten.

Beim Update von einer älteren Version werden bereits gesetzte Rechte einmalig übernommen.

Personal

Der Bereich Personalbüro bündelt alles rund um die Belegschaft. Den Betrieb wählst du oben rechts.

  • Bewerbungen — Spieler bewerben sich mit /bewerben oder an einem Empfangstresen. Beim Annehmen wählst du den Einstiegsrang; der Spieler bekommt den Job sofort, auch offline.
  • Dienstzeit — Jedes Ein- und Ausstempeln wird mitgeschrieben. Eine Heatmap zeigt nach Wochentag und Uhrzeit, wann wirklich jemand im Dienst ist.
  • Schichtplan — Schichten mit Uhrzeit und Platzzahl anlegen. Deine Spieler tragen sich im Boss-Panel selbst ein.
  • Abmahnungen — Drei Stufen: Hinweis, Verwarnung, schwere Abmahnung. Der Mitarbeiter bekommt eine Nachricht im Spiel.
  • Automatische Beförderung — Regel aus „von Rang“, „auf Rang“ und nötigen Dienststunden. Geprüft wird beim Ausstempeln.

Wirtschaft

Lohnmodelle

Jeder Betrieb hat sein eigenes Modell, einstellbar unter Wirtschaft → Lohnmodell:

  • Fester Zyklus — Alle X Minuten bekommt jeder Eingestempelte sein volles Ranggehalt. Einfach und planbar, belohnt aber auch reines Herumstehen.
  • Nach Dienstzeit — Beim Ausstempeln wird die tatsächliche Zeit abgerechnet. 90 Minuten ergeben bei Faktor 1 anderthalb Ranggehälter. Eine Mindestdauer verhindert Kurzschichten.
  • Kein automatisches Gehalt — Für Betriebe, die sich rein über Rechnungen und Aufträge finanzieren.

Rechnungen

Rechnungen stellen Mitarbeiter über das F6-Menü oder an einer Rechnungs-Zone — an Personen in bis zu fünf Metern Entfernung. Voraussetzung sind die F6-Aktion Rechnungen im Job und die Rang-Berechtigung Rechnungen. Der Empfänger bezahlt mit /rechnungen von seinem Bankkonto, das Geld landet in der Fraktionskasse. Im Panel siehst du alle offenen, bezahlten und stornierten Rechnungen.

Boni

Eine Bonus-Regel zahlt automatisch, wenn jemand eine Schwelle erreicht — etwa zehn Dienststunden pro Woche. Der Betrag ist fest oder ein Prozentsatz vom Ranggehalt und kommt aus der Fraktionskasse. Einzelne Prämien kannst du jederzeit von Hand auszahlen.

Aufträge

Aufträge geben deinen Betrieben ein Ziel. Du legst Titel, Beschreibung, Zielmenge, Belohnung, Mindest-Rang und Abklingzeit fest:

  • Manuell — Der Spieler schließt selbst ab, sobald er fertig ist.
  • Dienststunden — Zählt beim Ausstempeln automatisch hoch.
  • Rechnungen — Zählt hoch, sobald eine gestellte Rechnung bezahlt wurde.

Die Belohnung geht wahlweise als Bargeld, auf die Bank oder in die Fraktionskasse.

Boss-Panel

Wer einen Rang mit Boss-Rechten hat, öffnet an einer boss-Zone die eigene Betriebsverwaltung: Team, Einstellen, Bewerbungen, Kasse, Schichtplan, Aufträge, Bestandsübersichten und Ankündigungen an alle Mitarbeiter im Dienst.

Welche Reiter sichtbar sind, ergibt sich aus den Rechten des Rangs. Das Budget-Limit gilt auch hier — überschreitet eine Auszahlung das Limit, lehnt der Server sie ab. Jede Aktion landet in deinem Log.

Vorlagen, Backups und Transfer

  • Vorlagen — Sieben fertige Betriebe: Polizei, Rettungsdienst, Mechaniker, Taxi, Benny's, Behörde und ein schlanker Zivilbetrieb. Jeden eigenen Job kannst du über Als Vorlage speichern wiederverwendbar machen.
  • Entwürfe — Angefangene Betriebe, die noch nicht live sind. Erst beim Anwenden werden sie wirklich angelegt.
  • Import und Export — Jeder Job lässt sich als JSON sichern oder auf einen anderen Server übertragen.
  • Backups — Sichern alle Jobs, Ränge, Zonen, Garagen und Shops in einem Rutsch. Vor größeren Umbauten ein Klick, der viel Ärger spart.

Andere Scripts anbinden

X-Jobscreator bringt serverseitige Exports mit, die du aus deinen eigenen Scripts heraus nutzen kannst:

local jobs    = exports['x-jobscreator']:GetAllJobs()
local grades  = exports['x-jobscreator']:GetJobGrades('police')
local zones   = exports['x-jobscreator']:GetJobZones('police')
local garages = exports['x-jobscreator']:GetJobZonesByType('police', 'garage')

local employees = exports['x-jobscreator']:GetJobEmployees('police')
local online    = exports['x-jobscreator']:GetOnlineJobEmployees('police')
local count     = exports['x-jobscreator']:GetEmployeeCount('police')

Prüfungen und Schreibzugriff:

if exports['x-jobscreator']:IsJobEnabled('police') then
    -- Betrieb ist aktiv
end

local isEmployee = exports['x-jobscreator']:IsEmployeeOfJob(identifier, 'police')
local grade      = exports['x-jobscreator']:GetEmployeeGrade(identifier, 'police')

exports['x-jobscreator']:SetJobEnabled('police', false)

Alles auf einmal, inklusive Ränge, Zonen, Garagen und Shops:

local data = exports['x-jobscreator']:GetJobFullData('police')

Dienstzeiten aus einem eigenen Duty-System melden:

exports['x-jobscreator']:StartDutySession(identifier, 'police', 'Max Mustermann')
exports['x-jobscreator']:EndDutySession(identifier)

Häufige Fragen

F7 öffnet nichts

Dein Account hat keine Adminrechte. Prüfe Config.AdminGroups oder setze add_ace group.admin xjc.admin allow in die server.cfg. Nach der Änderung neu verbinden.

Meine bestehenden Jobs fehlen

Öffne Einstellungen und klicke auf Jobs mit Framework abgleichen. Das liest alle Betriebe ein, die im Framework existieren, aber noch nicht im Jobscreator stehen.

Eine Zone ist im Spiel nicht da

Drei häufige Gründe: die Zone ist deaktiviert, der Mindest-Rang liegt über deinem eigenen, oder der ganze Job ist deaktiviert. Mit Im Spiel zeigen prüfst du die Position direkt.

Es wird kein Gehalt gezahlt

Prüfe das Lohnmodell des Betriebs. Steht es auf „Nach Dienstzeit“, wird erst beim Ausstempeln abgerechnet. Zahlt der Betrieb aus der Fraktionskasse, muss dort genug Guthaben sein — leere Kassen erzeugen einen Eintrag im Log.

Im F6-Menü fehlen Aktionen

Schalte sie im Job unter Einstellungen → F6-Aktionen frei. Für Rechnungen braucht der Rang zusätzlich die Berechtigung Rechnungen im Reiter Ränge.

Das Boss-Panel öffnet nicht

Es braucht eine Zone vom Typ boss und einen Rang mit Boss-Rechten. Beides prüfst du im Job unter Zonen und Ränge.

Items lassen sich im Shop nicht finden

Die Suche liest dein Inventarsystem aus. Wird nichts gefunden, prüfe unter Einstellungen → Systemstatus, ob das Inventar erkannt wurde. Den Item-Namen kannst du auch von Hand eintragen.

Ich habe versehentlich etwas gelöscht

Strg + Z nimmt die letzten Änderungen zurück. Ist das Panel schon geschlossen, hilft unter Import / Export das letzte Backup. Wer was geändert hat, steht im Log.

Leistung auf vollen Servern

Config.Security.rateLimitMs bremst zu schnelle Panel-Anfragen ab, Config.Markers.drawDistance bestimmt, ab welcher Entfernung Bodenmarker gezeichnet werden. Niedrigere Werte bedeuten weniger Last.

Support

Kommst du nicht weiter, melde dich auf Discord. Halte bitte die Serverkonsole vom Start und deine Resource-Version bereit.

Etwas unklar geblieben?

Schreib uns auf Discord, wir ergänzen die Anleitung.

Discord
X-Jobscreator einrichten — Dokumentation · X-Solution