Personnalisation
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
Section intitulée « 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
Section intitulée « config.lua »| 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
Section intitulée « 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" |
Annuler une quête
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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.
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.
Ajouter une langue :
- Copiez
locales/en.luaet nommez la copie selon votre code langue, par exemplelocales/pl.lua. - À 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. - Ajoutez votre fichier à
shared_scriptsdansfxmanifest.lua, avec les autres fichiers de langue et au-dessus deconfig.lua. - Définissez
Config.Localesur votre code, puis faitesrefreshet 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
Section intitulée « 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.
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
Section intitulée « É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.