Mois : décembre 2024

Générer des énigmes pour Kolotoc : un guide pratique

1 commentaire

Introduction

🎉 Kolotoc est enfin disponible ! Après des mois, que dis-je, des années de travail, notre jeu inspiré de la « Roue de la fortune » est sorti hier, juste à temps pour Noël.

Dans cet article, je vais vous montrer comment utiliser un script PHP que j’ai développé pour créer vos propres énigmes et les intégrer dans le jeu. Si vous souhaitez personnaliser votre expérience ou ajouter vos propres catégories, ce guide est fait pour vous !

Fonctionnalités du script

Ce script a été conçu pour :

  1. Nettoyer et formater les chaînes de caractères
    • Suppression des accents et des caractères spéciaux.
    • Conversion en majuscules pour une uniformité parfaite.
  2. Convertir des fichiers texte en données binaires structurées
    • Organisation des énigmes par catégories (une catégorie = un fichier texte).
    • Création d’un fichier binaire compact et optimisé pour Kolotoc.
  3. Générer des fichiers d’en-tête optionnels pour des projets C
    • Idéal pour des tests ou une intégration spécifique.

Format du fichier binaire généré

Voici la structure du fichier binaire généré :

  • Signature : 3 octets – « KWF » (Kolotoc Wheel Format).
  • Nombre de catégories : 1 octet.
  • Métadonnées des catégories :
    • Position du titre.
    • Début et longueur de la liste des phrases.
  • Liste des phrases :
    • Position de chaque phrase relative.

Instructions d’utilisation

  1. Préparer les fichiers texte
    • Chaque fichier représente une catégorie.
    • Une phrase par ligne dans chaque fichier.
  2. Exécuter le script
    Ouvrez un terminal et utilisez la commande suivantephp compile.php <dossier> (Remplacez <dossier> par le chemin vers le dossier contenant vos fichiers texte)
  3. Résultats
    • Les fichiers nettoyés (avec des noms adaptés) sont enregistrés dans le même dossier avec l’extension .cleaned.
    • Le fichier binaire final s’appelle kolo2.bin.

Exemple

Supposons que vous avez un dossier contenant les fichiers suivants :

  • animaux.txt
  • villes.txt

Exécution :

Copier le codephp compile.php enigmes/

Résultats :

  • Un fichier binaire kolo2.bin contenant toutes les catégories.
  • Des fichiers nettoyés animaux.txt.cleaned et villes.txt.cleaned.

Intégration dans Kolotoc

Pour que vos énigmes personnalisées soient prises en compte dans le jeu, remplacez simplement le fichier kolo2.bindans le disque du jeu Kolotoc par celui généré par le script. Une fois fait, lancez le jeu et vos nouvelles catégories apparaîtront comme par magie ! 🌟

Conclusion

Avec ce script, vous avez le pouvoir de personnaliser Kolotoc selon vos envies. Ajoutez vos propres énigmes, explorez de nouvelles thématiques, et partagez vos créations avec vos amis. Si vous avez des questions ou des idées d’amélioration, n’hésitez pas à les partager en commentaire !

Et surtout, amusez-vous bien avec Kolotoc, le jeu qui met votre esprit à l’épreuve tout en vous divertissant. 🎄🎁

Téléchargez Kolotoc ici : crazypiri.itch.io/kolotoc

Téléchargez le script sur github : github.com/redbug26/kolotoc-compiler