Installation

Zehn Minuten. Der Schritt, der am häufigsten vergessen wird, ist fmLib — die Ressource startet ohne fmLib nicht.

Vorbereitung

Du benötigst	Warum
ESX, QBCore oder QBox	Callbacks, Benachrichtigungen und Spielerdaten stammen vom Framework
fmLib	Erforderlich. Geld, Items, Jobs und Fahrzeugschlüssel laufen darüber. Die Skriptanleitung verweist auf fmLib v2.0.2
oxmysql	Jede Quest, jedes Event und der Fortschritt jedes Spielers werden in deiner Datenbank gespeichert
ox_target oder qb-target	Optional. `ox_target` ist der Standard; wechsle auf 3D-Text, falls du kein Target-System nutzt
screenshot-basic	Optional, nur für Screenshots am Webhook-Node benötigt

1. Ordner ablegen

Lade mic_questcreator aus deinen Cfx.re Granted Assets herunter und lege den Ordner in deinen Ressourcen ab, z. B. unter resources/[mic]/mic_questcreator. Platziere fmLib ebenfalls in deinen Ressourcen, falls noch nicht vorhanden.

2. Nach den Abhängigkeiten starten

In der server.cfg gehört ensure mic_questcreator unter oxmysql, dein Framework (es_extended, qb-core oder qbx_core), fmLib und deine Target-Ressource. Das Manifest deklariert fmLib und oxmysql als Abhängigkeiten: Fehlt eine der beiden oder startet später, verweigert FiveM den Start des Quest Creators mit Angabe der fehlenden Ressource.

Es hat funktioniert, wenn die Konsole beim Start [QuestCreator] FMLIB Initialized successfully. ausgibt. Ein rotes CRITICAL ERROR: FMLIB NOT FOUND!, ESX NOT FOUND! oder QBCore NOT FOUND! bedeutet, dass die Startreihenfolge fehlerhaft ist oder in Config.Framework das falsche Framework angegeben wurde.

3. Die Datenbank

Importiere install.sql aus dem Ressourcenordner einmalig über HeidiSQL, phpMyAdmin oder dein bevorzugtes Datenbanktool. Die Ressource legt ihre Tabellen nicht automatisch an.

Es werden acht Tabellen angelegt, die alle mit mic_questcreator_ beginnen:

Tabelle	Inhalt
`mic_questcreator_list`	Die Quests
`mic_questcreator_locations`	Standorte der Quest-NPCs und deren Modell
`mic_questcreator_dialogs`	Frage-Antwort-Optionen und deren Cooldowns
`mic_questcreator_personalization`	Begrüßungsnachricht, Titel und Untertitel jeder Quest
`mic_questcreator_events`	Die im Node-Editor erstellten Events
`mic_questcreator_progress`	Aktueller Quest-Fortschritt der einzelnen Spieler
`mic_questcreator_cooldowns`	Zeitpunkte, ab wann ein Spieler eine Dialogoption wieder nutzen darf
`mic_questcreator_unlocks`	Welche Events ein Spieler freigeschaltet hat

Es hat funktioniert, wenn diese acht Tabellen in deiner Datenbank existieren. Das Löschen einer Quest entfernt automatisch auch die zugehörigen Standorte, Dialoge und Personalisierungen.

4. Items

Keine. Die Ressource bringt keine eigenen Items mit. Die Items, die eine Quest vergibt, abzieht oder voraussetzt, sind genau diejenigen, die du in den Nodes einträgst — sie müssen daher bereits in deinem Inventar existieren.

5. Framework und Target

Öffne config.lua und überprüfe zwei Zeilen:

Option	Wert auf
`Config.Framework`	`'esx'` (Standard) oder `'qbcore'`. Wird nicht automatisch erkannt. Nutze bei QBox `'qbcore'` — QBox betreibt QBCore-Ressourcen über seinen Kompatibilitätslayer
`Config.InteractionType`	`'ox_target'` (Standard), `'qb-target'` oder `'drawtext'`

Wenn du kein Target-System nutzt, wähle 'drawtext': Spieler gehen dann direkt zum NPC und drücken E.

6. Berechtigung für den Editor erteilen

Der Editor ist durch die ACE-Permission mic_questcreator.open abgesichert. Vergib sie in der server.cfg (oder deiner Rechte-Datei) per add_ace: An einen einzelnen Spieler über Identifier, z. B. add_ace identifier.discord:DEINE_DISCORD_ID mic_questcreator.open allow, oder an eine Gruppe wie add_ace group.admin mic_questcreator.open allow.

Es hat funktioniert, wenn /questcreator den Quest & Event Creator öffnet. Ohne Berechtigung antwortet der Server mit „You do not have permission to access the Quest Creator.“.

7. Erster Test

Erstelle im Tab Events ein neues Event, öffne es im Node-Editor und verbinde Start → Notification → Give Money → End. Speichere ab.
Erstelle im Tab Quests eine neue Quest. Füge einen Standort hinzu: Wähle ein Ped-Modell, klicke auf Set Position, laufe an die gewünschte Stelle und bestätige mit E.
Füge einen Dialog mit Frage und Antwort hinzu und wähle dein Event unter Trigger Event aus. Speichere die Quest.

Es hat funktioniert, wenn der NPC an der gewählten Stelle steht, das Ansprechen das Dialogfenster öffnet und die Auswahl deiner Option die Benachrichtigung anzeigt sowie das Geld auszahlt.

Vor der Eröffnung deines Servers

Nur berechtigte Personen sollten mic_questcreator.open haben. Jeder mit dieser Permission kann alle Quests auf dem Server erstellen und löschen.
Prüfe, ob Config.Framework und Config.InteractionType exakt zu deinem Server passen.
Entscheide über /cancelquest. Standardmäßig aktiv; Config.EnableCancelQuest schaltet den Befehl ab.
Teste Quests mit Belohnungen auf einem normalen Spieler-Charakter, nicht nur als Admin, um Berechtigungen und Inventar unter realen Bedingungen zu prüfen.