Installation

Note

💬 Besoin d’aide ? Le support, les mises à jour et les changelogs sont sur le Discord de Mic Scripts. Ouvrez un ticket avec votre ID de transaction Tebex et l’erreur console.

Dix minutes. L’étape que beaucoup oublient est fmLib — la ressource ne démarrera pas sans lui.

---

Avant de commencer

Vous avez besoin de	Pourquoi
ESX, QBCore ou QBox	Les callbacks, les notifications et les données des joueurs proviennent du framework
fmLib	Requis. L’argent, les items, les jobs et les clés de véhicules passent par lui. Le guide de la ressource renvoie vers fmLib v2.0.2
oxmysql	Chaque quête, événement et progression de joueur est stocké dans votre base de données
ox_target ou qb-target	Optionnel. ox_target est la valeur par défaut ; basculez sur le texte 3D si vous n’utilisez aucun des deux
screenshot-basic	Optionnel, uniquement pour les captures d’écran sur le nœud webhook

---

1. Mettre le dossier en place

Téléchargez mic_questcreator depuis vos assets accordés Cfx.re et déposez le dossier dans vos ressources, par exemple resources/[mic]/mic_questcreator. Placez également fmLib dans vos ressources s’il n’y figure pas déjà.

---

2. Démarrer le script après ses dépendances

Dans server.cfg, ensure mic_questcreator se place en dessous d’oxmysql, de votre framework (es_extended, qb-core ou qbx_core), de fmLib et de votre ressource de target. Le manifest déclarant fmLib et oxmysql comme dépendances, si l’un d’eux est manquant ou démarre plus tard, FiveM refusera de démarrer le quest creator et indiquera lequel est introuvable.

Cela fonctionne si la console affiche [QuestCreator] FMLIB Initialized successfully. au démarrage de la ressource. Un message rouge CRITICAL ERROR: FMLIB NOT FOUND!, ESX NOT FOUND! ou QBCore NOT FOUND! indique que l’ordre de démarrage est incorrect ou que Config.Framework ne nomme pas le bon framework.

---

3. La base de données

Importez install.sql depuis le dossier de la ressource une seule fois, avec HeidiSQL, phpMyAdmin ou votre outil habituel. La ressource ne crée pas ses tables de manière autonome.

Elle crée huit tables, toutes préfixées par mic_questcreator_ :

Table	Ce qu’elle contient
mic_questcreator_list	Les quêtes
mic_questcreator_locations	L’emplacement de chaque PNJ de quête et son modèle
mic_questcreator_dialogs	Les options de question-réponse et leurs cooldowns
mic_questcreator_personalization	Message d’accueil, titre et sous-titre de chaque quête
mic_questcreator_events	Les événements que vous dessinez dans le node editor
mic_questcreator_progress	L’étape de chaque joueur dans une quête
mic_questcreator_cooldowns	La date/heure à laquelle un joueur peut réutiliser une option
mic_questcreator_unlocks	Quels événements chaque joueur a débloqués

Cela fonctionne si ces huit tables apparaissent dans votre base de données. Supprimer une quête supprime également ses emplacements, dialogues et personnalisations associés.

---

4. Items

Aucun. La ressource n’est livrée avec aucun item propre. Les items qu’une quête donne, prend ou vérifie correspondent à ce que vous saisissez dans les nœuds : ils doivent donc déjà exister dans votre inventaire.

---

5. Framework et target

Ouvrez config.lua et vérifiez deux lignes :

Option	Définir sur
Config.Framework	'esx' (par défaut) ou 'qbcore'. Non détecté automatiquement. Sur QBox, utilisez 'qbcore' — QBox gère les ressources QBCore via sa couche de compatibilité
Config.InteractionType	'ox_target' (par défaut), 'qb-target' ou 'drawtext'

Si vous n’utilisez aucun système de target, choisissez 'drawtext' : les joueurs s’approchent alors du PNJ et appuient sur E.

---

6. Vous attribuer l’éditeur

L’éditeur est verrouillé derrière la permission ACE mic_questcreator.open. Accordez-la dans server.cfg (ou votre fichier de permissions) avec une ligne add_ace : à un individu par son identifiant, par exemple add_ace identifier.discord:VOTRE_ID_DISCORD mic_questcreator.open allow, ou à tout un groupe, par exemple add_ace group.admin mic_questcreator.open allow.

Cela fonctionne si /questcreator ouvre le Quest & Event Creator. Sans la permission, le serveur répondra « You do not have permission to access the Quest Creator. ».

---

7. Premier test

1. Dans l’onglet Events, créez un événement, ouvrez-le dans le node editor, et reliez Start → Notification → Give Money → End. Enregistrez.
2. Dans l’onglet Quests, créez une quête. Ajoutez un emplacement : choisissez un modèle de ped, cliquez sur Set Position, marchez jusqu’à l’endroit voulu, puis confirmez avec E.
3. Ajoutez un dialogue avec une question et une réponse, puis sélectionnez votre événement sous Trigger Event. Enregistrez la quête.

Cela fonctionne si le PNJ se tient là où vous l’avez placé, lui parler ouvre la fenêtre de dialogue, et choisir votre option déclenche la notification et vous verse l’argent.

---

Avant d’ouvrir votre ville

• Seules les personnes de confiance doivent avoir mic_questcreator.open. Quiconque possède cette permission peut créer et supprimer n’importe quelle quête sur le serveur.
• Vérifiez que Config.Framework et Config.InteractionType correspondent à ce que votre serveur fait réellement tourner.
• Prenez une décision concernant /cancelquest. La commande est activée par défaut ; Config.EnableCancelQuest permet de la désactiver.
• Testez une quête avec récompense sur un personnage normal, pas seulement avec votre compte admin, afin de vérifier l’inventaire et les permissions tels que vos joueurs les expérimenteront.