Personnalisation

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.

Presque tout ce qui concerne une quête — qui la donne, ce qu’il dit, ce qui se passe ensuite — se configure dans l’éditeur et s’enregistre dans votre base de données. Les fichiers servent pour la poignée de paramètres identiques pour chaque quête.

---

Quel fichier décide de quoi

Fichier	Ce qu’il décide	Ouvert ?
config.lua	Framework, langue, interaction avec les PNJ, couleur des dialogues, /cancelquest, captures d’écran	Oui
bridge/bridge_server.lua	Argent, items, données de joueur, callbacks et vérification des permissions	Oui
bridge/bridge_client.lua	Notifications, textes d’aide, données de joueur et réanimation du joueur	Oui
locales/*.lua	L’ensemble des textes : éditeur, fenêtre de dialogue, notifications, logs webhook	Oui
install.sql	Les huit tables, importées une seule fois	Oui
web/	L’éditeur, la fenêtre de dialogue, le mini-jeu et la barre de progression (HTML, CSS, JS)	Lisible
client/, server/	Le moteur de quêtes	Sous escrow
client/game_data/*.lua	Les listes alimentant les sélecteurs de l’éditeur : peds, véhicules, bones, animations, particules, sons, effets d’écran	Sous escrow

---

config.lua

Général

Option	Ce qu’elle fait	Par défaut
Config.Framework	Quel framework cibler : 'esx' ou 'qbcore'. Non détecté automatiquement. Sur QBox, utilisez 'qbcore' — QBox fait tourner les ressources QBCore via sa couche de compatibilité	'esx'
Config.Locale	La langue de l’éditeur, de la fenêtre de dialogue et des notifications. Voir Langues	'en'
Config.Debug	Présent dans le fichier ; cette version n’affiche rien de plus avec	true

Parler aux donneurs de quêtes

Option	Ce qu’elle fait	Par défaut
Config.InteractionType	'ox_target', 'qb-target' ou 'drawtext' (texte 3D et une touche)	'ox_target'
Config.InteractionDistance	Distance en mètres à laquelle un joueur doit se trouver pour parler à un PNJ	2.5
Config.InteractionKey	La touche de contrôle utilisée avec 'drawtext', et par le nœud Interact in Area. 38 correspond à E	38
Config.ThemeColor	Couleur d’accentuation de la fenêtre de dialogue : blue, pink, yellow, red, green, purple, orange, cyan, white ou black	"purple"

Note

Les véhicules de quête n’ont d’option target qu’avec ox_target. Avec qb-target ou 'drawtext', les interactions « Search for Keys » et « Break In » d’un véhicule de quête s’affichent sous forme de texte 3D.

Annuler une quête

Option	Ce qu’elle fait	Par défaut
Config.EnableCancelQuest	Enregistre une commande permettant au joueur d’abandonner sa quête active	true
Config.CancelQuestCommand	Nom de la commande, sans le slash	"cancelquest"

L’annulation efface la progression enregistrée du joueur pour cette quête et supprime ce qu’elle avait fait apparaître.

Captures d’écran

Option	Ce qu’elle fait	Par défaut
Config.ScreenshotBasic	Permet au nœud Send Webhook de joindre une capture d’écran lorsque sa case est cochée. Requiert screenshot-basic en fonction	true

---

Commandes et permissions

Commande	Qui peut l’utiliser	Ce qu’elle fait
/questcreator	Quiconque possède l’ACE mic_questcreator.open	Ouvre le Quest & Event Creator
/cancelquest	Tout joueur, tant que Config.EnableCancelQuest est actif	Abandonne la quête active. Renommable via Config.CancelQuestCommand

La même permission protège tout ce que l’éditeur sauvegarde, supprime, importe et exporte — la vérification se fait côté serveur, et pas seulement à l’ouverture du menu. Accordez-la avec une ligne add_ace à un identifiant ou un groupe ; la vérification elle-même réside dans Bridge.Server.IsPlayerAllowed dans bridge/bridge_server.lua si vous préférez la relier à votre propre système d’administration.

---

Langues

Treize fichiers sont fournis dans locales/ : en, es, fr, de, it, pt, ru, ja, ko, zh-CN, ar, nl et cs. Définissez Config.Locale sur le nom du fichier sans .lua.

Attention

Le tchèque est inclus mais non chargé. locales/cs.lua ne figure pas dans la liste shared_scripts de fxmanifest.lua. Pour l’utiliser, ajoutez locales/cs.lua à cette liste aux côtés des autres fichiers de langue, réglez Config.Locale = 'cs', puis faites refresh et redémarrez la ressource.

Ajouter une langue :

1. Copiez locales/en.lua et nommez la copie selon votre code langue, par exemple locales/pl.lua.
2. À l’intérieur, changez le nom de table 'en' pour votre code, et traduisez le texte sur la droite de chaque ligne. Ne modifiez pas les clés à gauche ni les %s.
3. Ajoutez votre fichier à shared_scripts dans fxmanifest.lua, avec les autres fichiers de langue et au-dessus de config.lua.
4. Définissez Config.Locale sur votre code, puis faites refresh et redémarrez.

Une clé manquante dans votre fichier s’affichera en jeu sous la forme Translation [xx][key] does not exist, vous indiquant exactement quelle ligne ajouter.

Ce que disent les PNJ, les titres de quêtes et les messages de notification ne se trouvent pas dans les fichiers de langue — vous les saisissez directement dans l’éditeur, dans la langue de votre choix.

---

Le bridge

Deux fichiers ouverts se situent entre le moteur de quêtes et le reste de votre serveur.

bridge/bridge_server.lua

Fonction	À quoi elle sert
Bridge.Server.Initialize	Récupère fmLib et l’objet ESX ou QBCore au démarrage de la ressource
Bridge.Server.RegisterServerCallback	Enregistre les callbacks via ESX ou QBCore
Bridge.Server.GetPlayer, GetPlayerParams	Un joueur via fmLib, ainsi que son identifiant, son nom et son job
Bridge.Server.GetMoney, AddMoney, RemoveMoney	L’argent, via fmLib
Bridge.Server.GetItem, AddItem, RemoveItem	Les items, via fmLib, quel que soit l’inventaire avec lequel fmLib dialogue
Bridge.Server.IsPlayerAllowed	Qui peut ouvrir et utiliser l’éditeur. Vérifie l’ACE mic_questcreator.open

bridge/bridge_client.lua

Fonction	À quoi elle sert
Bridge.Client.ShowNotification	Chaque notification. Remplacez le corps pour utiliser votre propre ressource de notification
Bridge.Client.ShowHelpNotification	Le texte d’aide en haut à gauche
Bridge.Client.GetPlayerData, IsPlayerLoaded	Données du joueur, utilisées par les vérifications Has Job et Is Night/Day
Bridge.Client.TriggerServerCallback	Callbacks via ESX ou QBCore
Bridge.Client.RevivePlayer	Utilisé par le gestionnaire de mort. Déclenche esx_ambulancejob:revive sur ESX ou hospital:client:Revive sur QBCore, puis réanime nativement si toujours mort

Vous utilisez un autre script d’ambulance ? Modifiez l’événement dans Bridge.Client.RevivePlayer pour celui écouté par votre script. Une autre ressource de notifications ? Modifiez Bridge.Client.ShowNotification. Conservez les noms de fonctions — le moteur les appelle par leur nom.

---

Exports

Deux exports client permettent à une autre ressource d’emprunter le mini-jeu et la barre de progression du quest creator.

Export	Arguments	Ce qu’il fait
StartMinigame	difficulty (1–5), speed (1–5), rounds, callback	Ouvre le mini-jeu façon crochetage. Le callback reçoit true ou false
StartProgressBar	duration en millisecondes, label	Affiche la barre de progression intégrée

Appelez-les sur mic_questcreator depuis un script client.

---

Événements communautaires et exportation

Community Events dans l’éditeur liste les événements partagés par d’autres serveurs ; importez-en un et il sera ajouté à vos événements comme n’importe quel autre. La liste est téléchargée depuis GitHub ; votre serveur a donc besoin d’un accès internet sortant pour l’alimenter.

Export Event demande un nom, une description et un auteur, puis écrit l’événement dans un fichier JSON à l’intérieur du dossier de la ressource, dans exports/. Ce dossier n’est pas fourni avec la ressource — créez au préalable un dossier vide nommé exports dans mic_questcreator, sinon le fichier atterrira à la racine de la ressource sous le nom export_<name>.json.