Aller au contenu

Installation

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


Vous avez besoin dePourquoi
ESX, QBCore ou QBoxLes callbacks, les notifications et les données des joueurs proviennent du framework
fmLibRequis. 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
oxmysqlChaque quête, événement et progression de joueur est stocké dans votre base de données
ox_target ou qb-targetOptionnel. ox_target est la valeur par défaut ; basculez sur le texte 3D si vous n’utilisez aucun des deux
screenshot-basicOptionnel, uniquement pour les captures d’écran sur le nœud webhook

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à.


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.


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_ :

TableCe qu’elle contient
mic_questcreator_listLes quêtes
mic_questcreator_locationsL’emplacement de chaque PNJ de quête et son modèle
mic_questcreator_dialogsLes options de question-réponse et leurs cooldowns
mic_questcreator_personalizationMessage d’accueil, titre et sous-titre de chaque quête
mic_questcreator_eventsLes événements que vous dessinez dans le node editor
mic_questcreator_progressL’étape de chaque joueur dans une quête
mic_questcreator_cooldownsLa date/heure à laquelle un joueur peut réutiliser une option
mic_questcreator_unlocksQuels é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.


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.


Ouvrez config.lua et vérifiez deux lignes :

OptionDé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.


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. ».


  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.


  • 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.