WaW: Stories. Créer des histoires au jeu

Publié
EN FR PL RU UA +

De quoi a-t-on besoin ?

  • Un éditeur de texte qui prend en charge l’encodage utf-8. Par exemple, Notepad++. En aucun cas, n’utilisez Microsoft Office, Libre Office : leurs outils sont trop intelligents pour nos tâches et… ils risquent d’abîmer le code.
  • Carte des ressources du jeu.
  • Si la carte des ressources ne vous suffit pas, vous pouvez accéder au contenu des packages rpa à l’aide de cet outil. Au moment de l’édition de cette page, la version actuelle du décompresseur est adaptée.
  • La documentation du moteur Ren’Py (est principalement en anglais, mais sur YouTube et d’autres ressources, vous pouvez souvent trouver des indications dans votre langue maternelle).
  • Un script écrit par vous ou vos amis (éventuellement basé sur une fanfic).

Premiers pas. Directives pour l’ajout de histoires au jeu

  1. Créez un dossier pour votre histoire. Pour ça… Dans le dossier du jeu, trouvez le dossier game, puis le dossier stories, et créez-y un dossier avec un nom en caractères latins et sans espaces, par exemple : harry_et_le_1er_lecon. Le chemin d’accès doit être : game/stories/harry_and_first_lesson/. Dans ce dossier seront placés tous les fichiers de votre histoire.
  2. Ajoutez un fichier avec la description de votre histoire. Il doit avoir l’extension rpy (vous pouvez créer un nouveau fichier texte et changer l’extension de txt à rpy). Dans ce fichier, veillez à inclure des informations sous forme de dictionnaire (code-valeur). Cela permettra au jeu de voir et d’exécuter votre histoire.
    Voici le modèle :
init -100 python:
    mods_list.append({
        "name": "Nom de votre histoire",  # Titre. Il s'agit d'un commentaire au code
        "tech_name": "nom_de_votre_histoire_unique",  # Toutes les étiquettes (Label) et variables de votre histoires doivent commencer par ce nom !
        "description": "Description de votre histoire", # Description de votre histoire
        "language": "fr",  # La langue (par exemple, 'fr', 'en')
        "start_label": "label_start",  # Etiquette (label) pour le début
    })


label label_start:
    "Votre texte ou vos actions ici. Votre histoire commence dans ce bloc de code."
    return

3. Si vous souhaitez utiliser des ressources supplémentaires : musique, décors, personnages, vous pouvez ajouter des dossiers pour eux dans le dossier de votre histoire. Leurs noms peuvent être : images, sounds ou sons, music ou musique, characters ou personnages (en français ou en anglais, mais sans signes diacritiques dans les noms).

Conseils :

  1. Veillez à ce que les noms de fichiers, de dossiers et d’étiquettes soient uniques pour éviter les conflits. Commencez-les toujours par votre « nom_de_votre_histoire_unique ». Vous pouvez voir un exemple dans le dossier stories/example_story
  2. Utilisez les commentaires dans le code pour plus de commodité : ajoutez le symbole # et indiquez ensuite à quoi sert ce fragment de code. Cela vous sera utile lorsque vous déciderez de vous souvenir dans six mois de ce que vous avez écrit ici…

Test

Assurez-vous que votre histoire s’affiche correctement dans la liste de ces mêmes histoires dans le jeu et qu’elle fonctionne sans erreur.

Leçon du professeur Flitwick

Voici à quoi pourrait ressembler le code d’une histoire courte, avec des décors et des personnages.

init -100 python:
    mods_list.append({
        "name": "L'école du professeur Flitwick pour créer des histoires",
        "tech_name": "flitwick_school_fr",  # Nom unique de votre histoire
        "description": "Le professeur Flitwick va vous apprendre à écrire des histoires pour ce jeu !",
        "language": "fr",
        "start_label": "flitwick_start_fr",  # Étiquette de démarrage
    })

label flitwick_start_fr:
    scene bg chants day
    show fl norm:
        xalign .32 ypos 30 zoom .4
    show chants_tumb
    show chants_tables day
    with Dissolve(1, alpha=True)

    fl "Bienvenue à l'école de création de histoires du professeur Flitwick ! Aujourd'hui, je vais vous expliquer comment créer une histoire pour ce jeu."
    fl "C'est très facile si tu suis mes instructions. Pouvons-nous commencer ?"

    fl "Tout d'abord, créez un dossier pour votre histoire."
    fl "Il doit être placé dans le dossier {color=#6495ED}game/stories/{/color}, et nommé de manière à ce que l'on sache clairement quelle histoire vous êtes en train de créer."

    centered "\"game/stories/votre_histoire/\""

    fl "Deuxièmement, vous devez ajouter un fichier script. Appelons-le, par exemple, {color=#6495ED}votre_histoire.rpy{/color}."
    fl "Ce fichier doit contenir des informations sur votre histoire. Pour plus de détails sur la façon dont il est écrit, voir le fichier README.md"
    show fl lecture3
    fl "Notez le {color=#6495ED}\"tech_name\"{/color} ! C'est un nom unique pour éviter les conflits. Toutes vos variables et étiquettes (Label) doivent commencer par ce nom."
    show fl smile
    fl "Ensuite, créez une étiquette (Label) avec votre script de démarrage. Il doit correspondre au {color=#6495ED}\"start_label\"{/color} du dictionnaire."
    fl 'label label_start:\n    "Votre texte ou vos actions se trouvent ici."\n    return'


    fl "Si votre histoire utilise des ressources - images, musique, etc. - placez-les dans le même dossier que votre script."
    fl "Par exemple, les images peuvent être placées dans le dossier {color=#6495ED}votre_histoire/images/{/color}."

    fl "Ensuite, testez votre modification. Assurez-vous qu'elle apparaît dans la liste des modifications et qu'elle s'exécute sans erreur."
    fl "Voilà, c'est fait ! Vous savez maintenant comment créer des histoires pour ce jeu. Bonne chance !"

    fl "Et n'oubliez pas : des noms de variables uniques sont la clé d'une création de histoire réussie !"
    return