Modder son VPET : Digital Monster Color et Pendulum Color

Jul. 31, 2024

Tutoriel en français supposément clair pour modder son Digital Monster Color ou Pendulum Color

Introduction

Matériel nécessaire :

• KeeYees SOP8 SOIC8 Test Clip and CH341A USB
• Tournevis
• Ordinateur sous Windaube (les utilisateurs de linoox peuvent s’adapter ou se débrouiller).

Le tutoriel initial en anglais.

Ce tutoriel est à peu près une traduction de cette vidéo mais avec plus de détails sur le modding.

Le discord Digitama Hatchery Discord Server contient beaucoup de ressources pour le modding, dont entre autre des sprites et certains outils.

Les liens vers les logiciels nécessaires seront donnés au fur et à mesure.

/!\ Attention, tout le tutoriel est valable pour les Pendulum Color aussi, mais certaines valeurs données sont pour le DMC car je ne possède pas (encore ?) de Pendulum Color : il faudra donc adapter ces valeurs.

Connexion DMC - Ordinateur

Le DMC est composé de 4 boutons : A, B, C et Reset. Seuls C et Reset ont de l’importance pour le tutoriel. C est le troisième bouton (le plus bas), et Reset est le bouton difficilement accessible entre le bouton B et C.

Démonter le DMC

Il y a quatres vis cruciformes à enlever au dos du boîtier, puis deux vis à l’intérieur qui fixent la carte mère à l’avant du boîtier. Les six vis sont de la même taille.

Brancher le matériel

/!\ Attention, cette étape est certainement la plus susceptible d’être répétée : le branchement est capricieux et minutieux. Il est normal de passer du temps avant que l’ordinateur ne puisse lire l’appareil.

• Brancher le cable avec la pince à l’Eeprom Programmer
• Attention, le fil rouge doit être dans le même sens que le levier

• Brancher la pince sur le DMC, le fil rouge doit être en haut

Connecter à l’ordinateur

/!\ Attention, si à le DMC commence à faire du bruit à n’importe quel moment, ce n’est pas normal et il faut le débrancher immédiatement.

• Connecter l’eeprom programmer à un ordinateur

/!\ Attention, il faut que le bouton reset soit maintenu pendant toute l’opération. Vous pouvez mettre une des vis sur le bouton reset comme sur la photo ci-dessus.

• Cliquer sur le bouton avec le “?” :

Un message similaire au suivant s’affichera si le logiciel n’arrive pas à lire le DMC. Dans ce cas, il faut refaire le branchement de la pince au DMC.

ID(9F): FFFFFF(Unknown)
ID(90): FFFF(Unknown)
ID(AB): FF(Unknown)
ID(15): FFFF(Unknown)

Si vous avez Error Connecting il faut le installer le driver pour CH341.

Cas normal : la fenêtre suivante s’affiche.

• Sélectionner le premier.
• Cliquer sur le bouton de lecture :

• Sauvegarder le fichier extrait. Par exemple V<n>_dump.bin, <n> étant le numéro de version de l’appareil

Vérification de l’intégrité du dump

/!\ ATTENTION, étape très importante à ne surtout pas sauter. Elle n’était pas dans le tutoriel en anglais et je m’étais contenté de voir si je pouvais correctement extraire les sprites du dump (comme suggéré dans le tutoriel). Il s’avérait que oui, mais mon dump était pourri quand même et je ne m’en suis rendu compte qu’après avoir réécrit sur mon appareil lorsque j’ai fini par parcourir la liste des outils pour découvrir qu’un vérificateur d’intégrité existait. J’ai donc perdu mon dump de DMC ver.2 mais j’ai pu récupérer un dump de DMC ver.5 qui a un mini-jeu similaire.

• Télécharger l’outil DmcHashCheck.
• Mettre le fichier du dump dans le même dossier que DmcHashCheck.exe (par facilité).
• Shift + clic droit dans le dossier -> Ouvrir la fenêtre PowerShell ici
• Entrer la ligne de commande suivante, en remplaçant <nom du dump> par le nom de votre fichier :

.\DmcHashCheck.exe <nom du dump>

• La commande devrait renvoyer le résultat suivant :

Firmware identified: Digimon Color Ver.1
Firmware data verified.

Si ce n’est pas le cas, il faut recommencer à l’étape Connecter à l’ordinateur

Modification du dump

Télécharger l’outil DigimonColorSpriteTool

Les instructions pour l’outil DigimonColorSpriteTool sont disponibles sur le dépôt git, mais les lignes de commande à utiliser à chaque étape seront données lorsqu’elles sont pertinentes.

Pour plus de facilité, le dump devrait être placé dans le même dossier que l’outil.

Extraction des sprites du dump

Note : pour les PenC et à pour toute la suite du tutoriel, il faut remplacer toutes les occurrences de dm<n> par penc<n>.

• Se placer dans le dossier de l’outil DigimonColorSpriteTool
• Shift + clic droit dans le dossier -> Ouvrir la fenêtre PowerShell ici
• Taper la commande suivante pour extraire les sprite du dump :

DigimonColorSpriteTool.exe export-preset .\V<n>_dump.bin dm<n> .\sprite

Rappel : <n> est le numéro de version de l’appareil.

Cette commande devrait avoir extrait tous les sprites du dump dans le dossier sprite.

[Optionnel] Commande pour extraire les sprites des Digimon seulement, sous forme de feuille :

DigimonColorSpriteTool.exe export-sheets-preset .\V<n>_dump.bin dm<n> .\sprite-sheets

Modification des sprites

Ressources diverses pour les sprites :

• 16x16 Digimon Sprites, une collection de sprites 16 x 16 mise à l’échelle 48x48 pour le DMC, comme tous les sprites du DMC. Ce qui signifie qu’il est possible d’avoir des sprites plus détaillés puis mis à l’échelle, par exemple du 24 x 24.
• 24x24 Digimon Sprites, une collection dont la majorité des sprites sont ne sont pas prêt à l’emploi : ce sont des feuilles non-ordonnées de 7 ou 8 sprites, et il faut 15 sprites pour DMC, 12 pour PenC. Il faut donc remplir les trous en dupliquant certains sprites pour que les expressions correspondent. Contient aussi des sprites d’UI et d’attaques prêt à l’emploi pour DMC ver.2. Pour les autres versions de DMC, il suffit de bien renommer les sprites concernés en les comparant avec les sprites de la version extraite.
• Sprites DMC v1 - 6, anglais et japonais
• Archive de sprites divers format feuille
• Schéma de feuilles de sprite pour Digital Monster Color et Pendulum Color. Permet de savoir à quel numéro il faut attribuer quelle expression. Très utile en cas d’utilisation de l’archive de 24x24 ou de sprite personnalisés de zéro.

Il faut remplacer les sprites des Digimon non-désirés du dossier sprite par les sprites des Digimon voulus. Il est possible de voir les lignes évolutives des Digimon ici.

Il est aussi possible de remplacer tous les autres sprites, ainsi que de traduire les menus à l’aide des sprite anglais disponibles dans un des liens ci-dessus. Ici, le fond d’écran ainsi que l’œuf de départ ont été modifiés :

Pour s’aider dans le renommage des fichiers, il est possible d’utiliser le Bulk Rename Utility.

Pour savoir a quelle animation correspond chaque sprite, il suffit de regarder les feuilles de sprites pour Digital Monster Color et Pendulum Color.

Pour le DMC, le cycle de marche utilise IDLE 1/ IDL2 et ATTACKING 2. Pour DMC, en ce qui concerne l’animation de Manger, il faut placer bouche fermée en premier et bouche ouverte en second, mais c’est l’inverse pour le PenC.

Importation des sprites vers le dump

• Taper la commande suivante pour mettre les sprite du dossier sprite dans le dump :

DigimonColorSpriteTool.exe import-preset .\V<n>_dump.bin dm<n> .\sprite V<n>_dump_modded.bin

Cette commande devrait créer un nouveau dump appelé V<n>_dump_modded.bin. C’est lui qui sera remis dans le DMC. La commande suppose que le dossier contenant les sprites s’appelle sprite. Si non, mettre le bon nom de dossier.

Si c’est la méthode des feuilles de sprite qui a été choisie, il faut utiliser la commande suivante :

DigimonColorSpriteTool.exe import-sheets-preset .\V<n>_dump.bin dm<n> .\sprite-sheets V<n>_dump_modded.bin

La commande suppose que le dossier contenant les feuilles de sprite s’appelle sprite-sheets. Si non, mettre le bon nom de dossier.

Modificateur de stats

Il existe un éditeur de stat appelé DigimonColorStatEditor pour DMC. Le lien du salon discord du Digitama Hatchery Discord Server.

Il est possible de modifier pas mal de stats grâce à l’outil.

La stat la plus intéressante à modifier est certainement le sprite d’attaque pour faire correspondre au Digimon modifié Main Attack Sprite.

• Sélectionner la version correspondant au dump dans le menu déroulant Device
• Sélectionner le Digimon voulu (le sprite originel va s’afficher, ce ne sera pas le sprite remplacé si un sprite l’a été)
• /!\ Attention*, la valeur du sprite d’attaque est décalée de 1. Si le sprite d’attaque numéro 17 est souhaité, il faut mettre 16.
• Cliquer sur le bouton Save this stats avant de passer au Digimon suivant.
• Lorsque toutes les modifications sont faites, cliquer sur Print out all stat code
• Ouvrir le dump dans l’éditeur de stat à l’aide du bouton Search .bin file en bas de la page
• Cliquer sur Save .bin as fixed

Note : pour voir le numéro des sprites d’attaque, il suffit de regarder le nom des fichiers dans le dossier où les sprites ont été extraits. Normalement ce sont les numéros 1 à 117.

Note : l’outil n’a pas fonctionné sur mon dump de DMC ver.5, il a fallu modifier le code à la fin.

Pour ça, il faut reprendre le code affiché par Print out all stat code et l’insérer dans le .bin à la main.

• Télécharger ImHex
• Ouvrir le dump dans ImHex
• Dans DigimonColorStatEditor, sélectionner le dernier Digimon de la liste
• Copier le code affiché à droite de la ligne Original Code
• Chercher dans ImHex le code copié pour trouver l’endroit où termine le code concernant les Digimon et le noter
• Dans DigimonColorStatEditor, sélectionner le premier Digimon de la liste
• Chercher dans ImHex le code copié pour trouver l’endroit où commence le code concernant les Digimon et le noter
• Sélectionner toute la partie du code correspondant aux Digimon
• Dans DigimonColorStatEditor, copier le code affiché par Print out all stat code
• Coller dans ImHex et s’assurer que les changements ont bien été collés : ils s’affichent en rouge

• Enregistrer sous le dump au cas où la modification ne serait pas bonne

Réécriture du DMC avec le dump modifié

• Ouvrir le dump fraîchement modifié dans AsProgrammer.exe.
• Cliquer sur le menu déroulant du bouton avec la flèche rouge pointant vers la gauche et cliquer sur Unprotect -> erase -> programe -> verify /!\ Rappel que le bouton Reset doit être maintenu durant toute l’opération (entre autre via l’utilisation d’une vis).

• Déconnecter l’appareil.
• Allumer le DMC en maintenant le bouton C (troisième bouton). Note : il est possible de mettre n’importe quelle version du DMC dans n’importe quel DMC. C’est très utile pour choisir le mini-jeu d’entraînement (section Training). J’ai un DMC version 2 avec un dump de version 5.

Problèmes potentiels

Si le DMC ne s’allume pas, il faut tenter de remettre un dump originel (vérifié avec DmcHashCheck.exe). Si ce n’est toujours pas bon, il est plus probable que ce soit le fusible qui ait été court-circuité plutôt que le DMC soit cassé. Dans ce cas, il suffit de brancher le DMC pendant 30 minutes à quelques heures, et ça devrait généralement aller.

S’il s’allume, il est alors possible de retenter d’écrire un dump modifié.