[Mod] Questlog [1.19.4 – 1.21.1]

Questlog est un mod pensé avant tout pour les créateurs de modpacks, de cartes et d’aventures personnalisées. Il ajoute à Minecraft un véritable journal de quêtes présenté comme un petit livre ou une checklist, avec des objectifs qui peuvent apparaître au bon moment, suivre automatiquement la progression du joueur, afficher des notifications et distribuer des récompenses.

Son intérêt ne vient pas d’une campagne déjà prête. Au contraire, Questlog n’ajoute aucune quête par défaut : le mod fournit le système, l’interface et tous les outils nécessaires pour construire ses propres objectifs. C’est donc surtout une base destinée aux modpacks qui veulent guider le joueur, raconter une histoire ou expliquer des mécaniques sans passer par un grand arbre de quêtes.

Le projet assume d’ailleurs une approche différente de FTB Quests. Là où ce dernier convient bien aux longues progressions composées de nombreuses petites tâches, Questlog cherche davantage à transmettre une information au bon moment et à mettre en avant des objectifs plus importants. Les deux systèmes peuvent d’ailleurs cohabiter dans un même modpack.

Comment se présente Questlog en jeu ?

Côté joueur, Questlog reste volontairement simple. Le journal affiche une liste verticale de quêtes avec leur nom, leur icône et leur état. Un clic permet d’ouvrir les détails d’une quête et de consulter sa description, ses objectifs, leur progression et les éventuelles récompenses à récupérer.

Le journal peut être ouvert avec la touche d’accent grave — généralement la touche ` ou ~ selon le clavier — et ce raccourci peut être modifié dans les contrôles de Minecraft. Un bouton est également ajouté dans l’inventaire, à proximité du livre de recettes, pour accéder au journal sans retenir de raccourci.

Ce fonctionnement est visible dans Resurvival, un modpack que nous avons déjà présenté sur Minecraft-France et que le créateur de Questlog cite lui-même comme exemple d’intégration. Le journal y sert moins de tableau de tâches que de guide permettant de comprendre une progression entièrement retravaillée.

Comment fonctionne une quête ?

Une quête Questlog est construite autour de plusieurs blocs logiques. Le créateur décide d’abord quand elle devient disponible, puis ce que le joueur doit faire pour la terminer, ce qui peut provoquer son échec et ce qu’elle donne une fois complétée.

• Conditions d’apparition : elles déterminent quand la quête se débloque et commence à suivre la progression du joueur. Sans condition, elle peut être disponible immédiatement.
• Objectifs : ce sont les actions à accomplir pour terminer la quête.
• Conditions d’échec : elles peuvent faire échouer la quête si un événement précis se produit.
• Récompenses : elles sont attribuées après la réussite, automatiquement ou après validation du joueur.

Cette séparation est importante. Une quête peut par exemple ne devenir visible qu’après l’achèvement d’une autre quête, puis demander d’entrer dans un biome précis et de récupérer un objet. À l’inverse, une entrée purement narrative peut ne comporter aucun véritable objectif et simplement servir à transmettre une information.

La description peut elle aussi changer selon l’état de la quête : un texte peut être affiché pendant sa réalisation, un autre après sa réussite et un troisième après un échec. Cela permet d’éviter les journaux où le même paragraphe reste figé alors que la situation du joueur a déjà évolué.

Les objectifs que Questlog peut suivre

La documentation prévoit un nombre important de types d’objectifs. Ils couvrent aussi bien la survie classique que l’exploration, le combat ou des événements très précis. La plupart acceptent un nombre à atteindre : une quête peut donc demander de miner un bloc une fois comme d’en casser plusieurs centaines.

Créer de vraies suites de quêtes

Les quêtes peuvent dépendre les unes des autres grâce à l’objectif quest_complete. Lorsqu’il est utilisé comme condition d’apparition, la quête suivante reste cachée jusqu’à ce que la précédente soit terminée. Il devient ainsi possible de créer une progression linéaire, plusieurs branches ou des chapitres qui se débloquent progressivement.

Questlog possède également des objectifs logiques. or valide une étape lorsqu’au moins l’un des sous-objectifs est accompli, tandis que not inverse une condition. Un modpack peut par exemple lancer une quête uniquement si le joueur n’a pas encore visité le Nether, ou lui laisser le choix entre plusieurs manières d’atteindre le même résultat.

Un objectif spécial peut même être rendu impossible à terminer par une action normale du joueur. Il sert alors à créer une entrée de lore ou une quête contrôlée entièrement par une commande ou un autre système externe.

Récompenses et échecs

Une quête n’est pas obligée de donner une récompense, mais Questlog propose plusieurs possibilités lorsque le créateur souhaite associer progression narrative et récompense matérielle.

• Objets : un ou plusieurs objets peuvent être remis au joueur, y compris avec des composants ou enchantements personnalisés.
• Expérience : la récompense peut prendre la forme de points d’expérience ou de niveaux.
• Table de butin : le résultat peut provenir directement d’une loot table Minecraft ou d’un mod.
• Commande : une commande peut être exécutée au nom du joueur avec un niveau de permission défini.
• Choix : le joueur peut sélectionner une ou plusieurs récompenses parmi différentes possibilités.

Les récompenses sont normalement réclamées dans le journal, mais elles peuvent aussi être configurées en attribution automatique. Le créateur peut ajouter un son au moment de la récupération et personnaliser le nom ainsi que l’icône affichés dans l’interface.

Le système d’échec fonctionne dans l’autre sens : une liste d’objectifs peut être surveillée et, si l’un d’eux est rempli, la quête échoue et cesse de suivre la progression jusqu’à sa réinitialisation. C’est utile pour les défis, les missions conditionnelles ou des scénarios où certaines actions ont réellement des conséquences.

Des notifications difficiles à rater

La philosophie de Questlog repose beaucoup sur la transmission de l’information. Une quête importante ne doit pas apparaître discrètement dans un menu que le joueur n’ouvrira peut-être jamais. Chaque quête peut donc déclencher des notifications à son déblocage et à sa réussite.

Le créateur peut utiliser de petits toasts similaires aux notifications de Minecraft, faire apparaître un badge sur le bouton du journal dans l’inventaire ou ouvrir directement une fenêtre de quête. Les sons de déclenchement et de réussite sont eux aussi configurables.

Les badges peuvent utiliser une texture personnalisée et même être animés avec une spritesheet verticale. Un modpack peut donc remplacer le simple point d’exclamation par un indicateur parfaitement adapté à son interface.

Chapitres et organisation

Lorsque le nombre de quêtes augmente, elles peuvent être rangées dans des chapitres. Chaque chapitre possède son propre nom, son icône et son ordre d’affichage. Un chapitre peut aussi être défini comme section principale ou être complètement masqué.

Une quête appartient par défaut au chapitre principal, mais elle peut être envoyée vers une autre catégorie tout en restant éventuellement visible dans la liste principale. Cette organisation convient par exemple à un modpack qui sépare sa campagne, ses tutoriels, ses quêtes secondaires et ses informations techniques.

Les versions récentes du mod ont également élargi les possibilités avec des quêtes répétables et des quêtes globales, utiles pour les packs qui souhaitent proposer des objectifs récurrents ou partager certaines progressions à une échelle plus large.

Une interface entièrement personnalisable

L’apparence très simple de Questlog est volontaire : pratiquement tous ses éléments graphiques ont été pensés pour être remplacés via un resource pack. Un modpack peut ainsi conserver le journal parchemin d’origine, créer une interface technologique ou adopter une esthétique complètement différente.

Chaque quête peut personnaliser le fond du panneau principal, celui du panneau de détails, les textures des boutons et séparateurs, ainsi qu’un calque supplémentaire. Les dimensions et positions des panneaux peuvent aussi être modifiées.

La palette de texte est elle aussi configurable : couleur du texte normal, du texte survolé, des titres, de la progression et des objectifs terminés. Même les libellés des boutons peuvent être remplacés ou traduits.

Les descriptions prennent en charge un format enrichi simplifié. Un texte peut contenir un lien vers une autre quête : cliquer dessus ouvre directement la quête concernée. Il peut aussi afficher une image au survol, avec prise en charge de dimensions personnalisées et même de petites animations.

Un exemple concret de quête

Pour comprendre le fonctionnement, imaginons une quête très simple créée pour Minecraft-France. Elle demande au joueur de récupérer trois diamants et lui donne ensuite 100 points d’expérience.

{
  "title": "Premiers diamants",
  "description": "Trouvez et récupérez trois diamants.",
  "icon": {
    "item": "minecraft:diamond"
  },
  "objectives": [
    {
      "type": "questlog:item_obtain",
      "item": "minecraft:diamond",
      "required_amount": 3,
      "name": "Obtenir 3 diamants"
    }
  ],
  "rewards": [
    {
      "type": "questlog:experience",
      "experience": 100
    }
  ],
  "toast_on_unlock": true,
  "toast_on_complete": true
}

Le fichier peut être enregistré sous config/questlog/quests/premiers_diamants.json. Le titre et la description définissent ce que le joueur lit, l’icône utilise directement le modèle du diamant et item_obtain surveille l’obtention de trois diamants. Dès que l’objectif est rempli, la quête passe à l’état terminé et la récompense devient disponible.

Pour transformer cet exemple en petite chaîne de quêtes, il suffit de créer une seconde quête et de lui demander, dans ses conditions d’apparition, que questlog:premiers_diamants soit terminée. La deuxième mission n’apparaîtra alors qu’après la première.

Créer et tester ses quêtes

Questlog est entièrement piloté par des fichiers JSON. Une quête correspond à un fichier placé dans config/questlog/quests/, tandis que les chapitres sont stockés dans config/questlog/chapters/. L’identifiant d’une quête est dérivé de son chemin de fichier, ce qui permet aussi d’organiser les définitions dans des sous-dossiers.

La documentation officielle suppose donc une connaissance minimale du JSON. Pour faciliter la création, les développeurs proposent aussi des exemples prêts à étudier et renvoient vers un générateur de quêtes en ligne. Ce dernier peut accélérer l’écriture, mais comprendre la structure générée reste utile dès que le projet devient complexe.

Commandes utiles pour les créateurs et administrateurs

/questlog reload recharge les quêtes et chapitres depuis la configuration, puis synchronise les changements avec les joueurs connectés. Cela permet de modifier un fichier sans redémarrer complètement la partie ou le serveur.

• /questlog open ouvre l’interface, éventuellement directement sur une quête ou un chapitre.
• /questlog progress reset réinitialise la progression d’une quête, d’un chapitre ou de l’ensemble du journal.
• /questlog progress complete termine immédiatement les objectifs ciblés.
• /questlog trigger force le déclenchement et l’apparition d’une quête.
• Toutes les commandes peuvent utiliser /ql comme raccourci.

Ces commandes demandent un niveau de permission suffisant et sont surtout destinées au développement, aux tests et à l’administration d’un serveur.

Pour un projet conséquent, la commande de rechargement devient particulièrement pratique : le créateur peut modifier une description, un objectif ou un chapitre, recharger Questlog et contrôler immédiatement le résultat en jeu.

À qui s’adresse Questlog ?

Pour un joueur qui installe des mods un par un dans une survie classique, Questlog n’a pas vraiment d’intérêt seul. Il prend tout son sens lorsqu’un créateur l’utilise pour accompagner une expérience conçue autour de lui.

Dans un modpack Minecraft, il peut servir de tutoriel progressif, présenter un mod lorsqu’il devient utile, raconter l’histoire du pack, signaler un changement de règles ou organiser une campagne complète. Cette approche est particulièrement adaptée aux packs où la progression s’éloigne fortement de la survie Minecraft classique.

FTB Quests reste plus adapté lorsqu’un pack veut afficher un très grand arbre rempli de tâches de collecte et de fabrication. Questlog choisit une autre direction : une liste plus compacte, proche d’un journal de RPG, avec un accent mis sur le texte, les notifications et le moment où l’information est présentée. Un modpack peut même utiliser les deux, par exemple FTB Quests pour la progression technique et Questlog pour le scénario ou les tutoriels importants.

On retrouve justement FTB Quests dans des packs comme Craft to Exile 2, où plusieurs centaines de tâches structurent une longue progression. Questlog vise généralement une présentation moins arborescente et davantage intégrée à l’aventure.

Installation de Questlog

Questlog fonctionne côté client et côté serveur. Pour une partie multijoueur ou un modpack distribué à plusieurs joueurs, il doit donc être présent dans les deux environnements avec les dépendances requises par le loader choisi.

L’installation du fichier reste celle d’un mod Minecraft classique. Si vous débutez, notre guide explique comment installer un mod avec Forge, NeoForge ou Fabric et comment vérifier les éventuelles dépendances.

Téléchargement de Questlog