Starbound-FR.net Informational domain page
Sign In
Wide analog film photograph of a quiet coastal harbor at dusk, with soft grain, pale blue sky fading into gray water, a low stone breakwater, and a few moored wooden boats in muted brown and rust tones

Créer une quête Starbound avec un éditeur de mods

Créer une quête personnalisée dans Starbound permet d’ajouter une histoire, une mission d’exploration ou un objectif inédit à une partie. Avec quelques fichiers JSON, des dialogues et éventuellement un script Lua, il est possible de bâtir un contenu cohérent sans modifier directement les fichiers originaux du jeu.

L’opération demande toutefois de bien comprendre la structure des ressources de Starbound. Une quête associe généralement un titre, des textes, des objectifs, des récompenses et des conditions de progression. Selon le résultat recherché, elle peut aussi être reliée à un PNJ, à un objet ou à un événement précis.

Ce tutoriel présente une méthode accessible pour préparer votre environnement, créer le fichier de quête, ajouter des étapes et tester votre mod en toute sécurité. Les chemins exacts peuvent varier légèrement selon la version du jeu et les outils utilisés, mais les principes restent les mêmes.

Choisir le type de quête

Avant d’ouvrir l’éditeur de mods, déterminez le rôle de votre mission. Une quête courte peut demander au joueur de récupérer un objet, de visiter une planète ou de parler à un personnage. Une aventure plus complète peut enchaîner plusieurs objectifs et modifier le dialogue d’un PNJ après chaque étape.

Le plus simple consiste à partir d’une quête existante comme modèle. Les ressources de Starbound se trouvent dans les fichiers du jeu, généralement dans une archive .pak. Un outil d’extraction d’assets permet d’examiner les fichiers JSON et les scripts Lua sans toucher à l’installation originale.

Notez la structure d’une quête officielle avant de commencer. Observez les noms des propriétés, la forme des objectifs et la manière dont les récompenses sont définies. Cette comparaison évite les erreurs de syntaxe et vous aide à rester compatible avec le fonctionnement interne du jeu.

Préparer un espace de travail

Créez un dossier dédié à votre projet dans le répertoire des mods de Starbound. Donnez-lui un nom unique, par exemple quete_expedition_fr. Ajoutez ensuite le fichier de métadonnées requis par votre version du jeu, ainsi que les sous-dossiers nécessaires pour les quêtes, les dialogues et les scripts.

Conservez une copie de chaque fichier avant modification et utilisez un éditeur prenant en charge le format JSON. La coloration syntaxique, l’indentation automatique et la validation des accolades sont particulièrement utiles. Un seul caractère manquant peut empêcher le lancement du jeu ou désactiver le contenu du mod.

Les ressources utiles à réunir sont les suivantes :

N’utilisez pas directement un fichier extrait comme fichier final. Copiez-le dans votre mod, adaptez son chemin et modifiez son identifiant. Cette méthode protège les fichiers de base et simplifie la désinstallation ou la mise à jour de votre création.

Construire le fichier de quête

Dans le dossier de votre mod, créez un répertoire consacré aux quêtes, puis ajoutez un fichier portant une extension adaptée, souvent .quest ou .json selon le modèle choisi. Le contenu doit respecter strictement la structure attendue par Starbound.

Commencez par les informations visibles par le joueur : identifiant unique, titre, description, texte de progression et message de réussite. Évitez les accents ou les espaces dans l’identifiant technique, mais utilisez un français naturel dans les textes affichés.

Un squelette peut ressembler à ceci :

{
  "id": "expedition_ruines_01",
  "title": "Les ruines silencieuses",
  "text": "Explorez les ruines signalées par votre équipage.",
  "completionText": "Vous avez retrouvé les données perdues.",
  "canBeAbandoned": true,
  "rewards": [
    {
      "item": "money",
      "count": 500
    }
  ]
}

Ce fragment sert de base pédagogique. Les noms exacts des champs et le format des récompenses doivent être vérifiés à partir d’une quête officielle correspondant à votre version. Starbound peut refuser un fichier valide au niveau JSON si une propriété attendue manque ou si sa valeur ne correspond pas au format du jeu.

Définir les objectifs et les étapes

Les objectifs donnent sa logique à la mission. Vous pouvez demander au joueur de collecter une ressource, d’éliminer un adversaire, d’atteindre une position ou de dialoguer avec un PNJ. Pour une première création, limitez-vous à un ou deux objectifs afin d’identifier rapidement l’origine d’un éventuel problème.

Une quête en plusieurs étapes repose sur une progression claire. La première étape peut révéler une destination, la suivante demander un objet et la dernière déclencher le retour auprès du donneur de quête. Chaque étape doit être associée au texte approprié et, si nécessaire, à une condition de validation.

Nommez les objectifs de manière explicite. Un identifiant comme collecter_fragment est plus facile à retrouver dans les journaux d’erreur que objectif2. Vérifiez également que l’objet recherché existe réellement dans les ressources du jeu et que son identifiant respecte exactement les majuscules et minuscules utilisées par Starbound.

Pour rendre la mission lisible, prévoyez des textes courts et précis. Le joueur doit comprendre ce qu’il doit faire sans deviner le fonctionnement interne du mod. Les coordonnées, les noms de planètes et les objets importants peuvent être mis en évidence dans les dialogues ou les descriptions.

Relier la quête à un PNJ

Une quête isolée ne se déclenche pas toujours automatiquement. Elle doit être appelée par un contenu existant : dialogue de PNJ, interaction avec un objet, événement de scénario ou système de génération de missions. Pour un premier mod, le dialogue d’un personnage est souvent la solution la plus simple.

Copiez un fichier de dialogue officiel dans votre mod en conservant son chemin relatif. Ajoutez une réponse qui lance la quête et une autre qui affiche le texte de retour. Selon le système utilisé, cette réponse peut appeler une fonction de script ou utiliser une action prévue par le dialogue.

Vous pouvez aussi créer un PNJ entièrement nouveau, mais cette option ajoute plusieurs éléments : apparence, fichier d’entité, dialogues, emplacement et éventuelles animations. Commencez par une quête accessible depuis un personnage déjà présent afin de séparer les problèmes liés à la mission de ceux liés à la création du PNJ.

Après avoir relié le dialogue à la quête, vérifiez que l’identifiant est strictement identique dans chaque fichier. Une différence d’orthographe suffit à empêcher le déclenchement, même si le jeu ne montre pas toujours un message explicite à l’écran.

Ajouter des scripts et des récompenses

La plupart des quêtes simples peuvent fonctionner uniquement avec du JSON. Un script Lua devient utile lorsque vous souhaitez déclencher une animation, modifier un dialogue, vérifier une condition spéciale ou contrôler une interaction qui n’existe pas dans les modèles standards.

Placez le script dans un dossier clairement nommé et indiquez son chemin relatif dans le fichier de quête ou dans l’entité concernée. Évitez d’ajouter du code avant d’avoir validé la version basique de la mission. Une quête fonctionnelle sans script constitue un point de comparaison précieux en cas d’erreur.

Les récompenses peuvent inclure de l’argent, des objets, des pixels ou un élément destiné à débloquer la suite de l’histoire. Vérifiez la disponibilité de chaque objet et utilisez des quantités raisonnables. Une récompense impossible à générer peut provoquer un échec de validation ou disparaître silencieusement.

Pour une aventure scénarisée, prévoyez aussi une récompense narrative : nouveau dialogue, accès à une zone ou indication vers la prochaine mission. Cette progression donne une véritable cohérence à votre contenu personnalisé.

Tester et corriger le mod

Lancez Starbound avec uniquement votre mod actif, puis utilisez un personnage de test. Parlez au PNJ concerné, acceptez la quête et exécutez chaque objectif dans l’ordre prévu. Testez également l’abandon, la reprise et la fin de mission si ces comportements sont autorisés.

Contrôlez les journaux du jeu après chaque modification. Les erreurs de syntaxe JSON, les chemins incorrects et les identifiants inconnus y apparaissent généralement avec le nom du fichier concerné. Corrigez une seule chose à la fois pour comprendre précisément l’effet de chaque changement.

Avant de publier votre travail, effectuez cette vérification :

Installez ensuite le mod sur une copie de votre profil ou dans un environnement de test séparé. Les quêtes peuvent enregistrer leur progression dans la sauvegarde, et une modification importante de leur identifiant peut rendre une ancienne mission inutilisable.

Partager une quête avec la communauté

Quand la quête fonctionne, organisez votre dossier avant de le distribuer. Retirez les fichiers temporaires, les sauvegardes personnelles et les ressources inutilisées. Ajoutez un fichier README présentant le nom du mod, sa version, ses dépendances et la procédure d’installation.

Indiquez aussi les éventuelles incompatibilités avec d’autres mods. Un conflit de chemin ou un remplacement de dialogue peut modifier le comportement d’un contenu déjà installé. Préférez les correctifs ciblés et les fichiers de patch lorsque cela est possible, plutôt que la copie complète d’une ressource officielle.

Pour présenter votre création aux joueurs francophones, fournissez une description claire, quelques captures d’écran et la liste des objectifs. Mentionnez la version de Starbound utilisée et signalez si la quête nécessite une nouvelle partie ou un personnage vierge.

Publiez votre quête sur Starbound-Fr afin de partager votre scénario, recueillir des retours et permettre à d’autres joueurs de tester votre aventure. Un mod bien documenté sera plus facile à installer, à corriger et à faire évoluer avec les prochaines versions du jeu.