Migrer un pack existant

stewbeet migrate transforme un datapack ou un resource pack que vous avez déjà en projet StewBeet. Vos fichiers vont dans src/, un template ajoute beet.yml et le reste d'un projet autour, et stewbeet build vous rend votre pack. Rien de ce que vous avez écrit n'est modifié, seulement déplacé.

C'est prévu pour les packs faits à la main ou avec d'autres outils. Un dossier qui a déjà une configuration beet est refusé, puisque c'est déjà un projet beet.

Vous découvrez beet ? Le schéma en haut de la page de configuration beet montre qui fait beet, bolt, mecha et StewBeet.

Avant de commencer

  • Commitez le dossier dans git, ou copiez-le. La migration déplace des fichiers.
  • Ouvrez un terminal dans le dossier de votre pack, ou dans le dossier au-dessus. Un pack, c'est un pack.mcmeta à côté d'un dossier data/, d'un dossier assets/, ou des deux, et il est cherché jusqu'à deux dossiers de profondeur.
  • Un datapack et un resource pack au maximum. Un même dossier qui contient les deux compte pour un seul pack.

Prévisualiser la migration

--dry-run affiche tout ce que la migration ferait, sans rien changer. Ici le pack est My Pack/, un datapack et un resource pack qui partagent un seul pack.mcmeta :

LigneSignification
addUn fichier du template, écrit parce que vous n'avez rien à cet emplacement
skipUn fichier du template laissé de côté, avec la raison
writebeet.yml, avec en dessous les valeurs reprises de votre pack
moveUn de vos fichiers ou dossiers, déplacé tel quel
deleteUn pack.mcmeta qui ne contenait qu'une description et un pack format
removeUn dossier vidé par les déplacements

Quel template

TemplateCe que vous obtenez
minimalbeet avec un seul plugin StewBeet. Le plus proche du pack que vous aviez.
basicTous les plugins StewBeet configurés et commentés. Le template qu'utilise le tutoriel.

Sans nom, la commande vous le demande, et Entrée choisit minimal. extensive n'est pas proposé, car ses items d'exemple se mélangeraient aux vôtres.

Terminal
uvx stewbeet migrate basic --dry-run
Found datapack and resource pack in My Pack
Migration plan:
  add     .gitignore
  add     definitions_debug.json
  add     pyproject.toml
  skip    assets/pack.png (replaced by your pack.png)
  add     assets/textures/README.md
  add     src/link.py
  add     src/setup_definitions.py
  skip    src/data/basic_template/function/enjoy.mcfunction (replaced by your datapack)
  add     src/definitions/additions.py
  add     src/definitions/ores.py
  write   beet.yml
            name: My Pack
            id: mypack
            description: from pack.mcmeta
  move    My Pack/data -> src/data
  move    My Pack/assets -> src/assets
  move    My Pack/pack.png -> assets/pack.png
  delete  My Pack/pack.mcmeta (beet.yml and StewBeet write it at build time)
  remove  My Pack/ (empty once moved)
WARNING Set author in beet.yml: it still names the template's author
Dry run: nothing was changed. Run the same command without --dry-run to apply this plan.

Migrer

La commande affiche le même plan, puis demande Apply this plan? (y/n). Ajoutez --yes pour sauter la question, dans un script par exemple.

Terminal
uvx stewbeet migrate basic

Vérifier beet.yml, puis compiler

Les avertissements sous le plan listent ce qui reste à faire à la main :

  • author contient encore l'auteur du template. Mettez votre nom.
  • id est repris de votre namespace, le dossier sous data/ autre que minecraft. S'il y a plusieurs namespaces, il n'est pas rempli : choisissez celui sous lequel StewBeet doit générer ses fonctions.

Puis compilez :

build/ contient maintenant votre datapack et votre resource pack, avec un pack.mcmeta écrit pour la version minecraft indiquée dans beet.yml. Si vous aviez votre propre pyproject.toml, celui du template a été ignoré : ajoutez stewbeet à ses dépendances, ou compilez avec uvx stewbeet build.

Terminal
uv run stewbeet build

Avant et après

L'exemple ci-dessus, migré vers basic :

Avant                                   Après
.                                       .
└── My Pack/                            ├── beet.yml           id, nom et description repris du pack
    ├── pack.mcmeta                     ├── pyproject.toml
    ├── pack.png                        ├── assets/
    ├── data/                           │   └── pack.png       votre icône
    │   ├── minecraft/tags/...          └── src/
    │   └── mypack/function/...             ├── data/          votre datapack, inchangé
    └── assets/                             ├── assets/        votre resource pack, inchangé
        └── mypack/lang/en_us.json          ├── definitions/   du template, sans item pour l'instant
                                            ├── link.py
                                            └── setup_definitions.py

Ce que devient chaque fichier

  • data/ et assets/ vont dans src/data/ et src/assets/, contenu intact.
  • Un pack.mcmeta qui ne contient qu'une description et un pack format est supprimé : sa description passe dans beet.yml, et StewBeet écrit un nouveau pack.mcmeta à chaque build. S'il contient plus, comme overlays ou filter, il va dans src/pack.mcmeta. StewBeet garde ses clés en plus mais fixe toujours pack_format et description : vérifiez que les formats qu'il liste correspondent aux versions que vous visez.
  • pack.png va là où le template range son icône : src/ pour minimal, assets/ pour basic. Si le datapack et le resource pack en ont chacun une, celle du datapack est utilisée et l'autre reste à sa place.
  • Les fichiers du template que vous avez déjà, comme .gitignore ou pyproject.toml, sont conservés. La copie du template est ignorée.
  • Un resource pack migré vers minimal reçoit une section resource_pack dans beet.yml, car ce template ne compile qu'un datapack.
  • Les dossiers où se trouvait votre pack sont supprimés une fois vides.

Quand la commande refuse

Toutes les vérifications ont lieu avant le premier déplacement : un refus laisse le dossier tel quel.

MessageQue faire
This folder already has a beet configurationLe dossier est déjà un projet beet : il n'y a rien à migrer.
No pack foundLe pack.mcmeta manque, ou il est à plus de deux dossiers de profondeur. Lancez la commande plus près.
Found 2 datapacksUn projet contient un datapack et un resource pack. Lancez la commande depuis un dossier qui ne contient que le pack à migrer.
Nothing was changed, because: src/data already existsQuelque chose occupe déjà la place de vos fichiers. Déplacez-le et relancez.
Could not download the 'basic' templateLes templates sont téléchargés depuis GitHub pour votre version de StewBeet : il faut une connexion.

Et ensuite

  • Définitions : transformez un à un les items que vous donnez avec des loot tables écrites à la main en définitions. StewBeet écrit alors leurs loot tables, leurs modèles et leurs pages de manuel.
  • Configuration beet : chaque option du beet.yml que vous venez d'obtenir.