Installation
Dix minutes. L’étape que beaucoup oublient est fmLib — la ressource ne démarrera pas sans lui.
Avant de commencer
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulé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
Section intitulée « 7. Premier test »- Dans l’onglet Events, créez un événement, ouvrez-le dans le node editor, et reliez Start → Notification → Give Money → End. Enregistrez.
- 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.
- 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
Section intitulée « 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.FrameworketConfig.InteractionTypecorrespondent à ce que votre serveur fait réellement tourner. - Prenez une décision concernant
/cancelquest. La commande est activée par défaut ;Config.EnableCancelQuestpermet 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.