Guides

Outils de Modding Project Zomboid

AnimZed, TileZed, WorldZed, PZTools et le workflow de cartographie et d'animation Build 42.

Dernière mise à jour:

Guide des Outils de Modding

L’écosystème de modding de Project Zomboid repose sur une suite d’outils officiels et communautaires qui permettent aux créateurs de construire des cartes, des animations et du contenu pour le jeu. Après le Build 42.20 Big Glow Up qui a roughly doublé la bibliothèque de tuiles à 35 000 tuiles, The Indie Stone met à jour WorldZed, TileZed et AnimZed pour permettre aux moddeurs de correspondre à la nouvelle étendue. Ce guide couvre ce que chaque outil fait, comment ils se connectent, et comment les nouveaux moddeurs peuvent commencer à construire sans se perdre dans une décennie de discussions de forum.

Cette page cible les créateurs construisant des mods pour Build 42. Si vous voulez jouer avec des mods, voir Guide des Mods pour le workflow Workshop et l’ordre de chargement. Pour créer votre propre contenu, lisez la suite.

La suite d’outils en un coup d’œil

OutilObjectifStatut
TileZedÉditeur de tuiles et de cartes 2DDéveloppement actif pour B42
WorldZedAssemblage de cartes au niveau mondialMis à jour avec les tuiles B42
AnimZedÉditeur d’animation de spritesEn développement
PZToolsÉdition Qt non officielle de Tim BakerMaintenue par la communauté

TileZed : l’éditeur de tuiles 2D

TileZed est l’éditeur officiel de tuiles 2D de Project Zomboid. Il permet aux moddeurs de créer et arranger les blocs de construction qui deviennent murs, sols, meubles et objets mondiaux. TileZed expédie les tuiles que vous voyez en jeu : chaque tuile de sol, section de mur, cadre de porte et objet acessoire est placé et configuré dans TileZed avant de devenir partie d’une carte.

Ce que TileZed fait :

  • Créer et éditer des tuilesets 2D pour murs, sols et objets
  • Configurer les propriétés des tuiles : marchable, solide, transparent, couches de sprite
  • Exporter les tuiles au format que Project Zomboid lit au runtime
  • Support pour objets multi-tuelles et meubles

Commencer avec TileZed :

  1. Téléchargez TileZed depuis les ressources officielles de modding Project Zomboid
  2. Étudiez la structure existante des tuilesets dans les fichiers du jeu de base
  3. Commencez par des tuiles simples de sol et mur avant les objets complexes
  4. Rejoignez le Discord de modding Project Zomboid pour les questions de workflow

La page wiki TileZed a une documentation détaillée sur les propriétés des tuiles, la configuration des couches et les paramètres d’export. Après Build 42.20, TileZed a reçu des mises à jour pour gérer la nouvelle bibliothèque de 35 000 tuiles.

WorldZed : assemblage mondial et chunking

WorldZed assemble les tuiles individuelles dans la structure mondiale plus large que Project Zomboid utilise. Pendant que TileZed gère les tuiles simples, WorldZed gère la grille de chunks, les layouts de zones et comment les tuiles se connectent à travers la carte. WorldZed est là où les moddeurs placent les villes, les routes et les relations spatiales qui définissent la navigation.

Ce que WorldZed fait :

  • Assembler les grilles de tuiles en zones de carte navigables
  • Configurer les densités de spawn de zombies et types de zones
  • Définir les métadonnées au niveau mondial : noms de villes, points de spawn, zones climatiques
  • Exporter le monde compilé pour utilisation avec les cartes TileZed

Le Build 42.20 a doublé la surface de la carte, WorldZed a reçu des mises à jour significatives pour gérer le comté de Knox étendu. Les moddeurs créant des cartes personnalisées doivent utiliser WorldZed pour définir les limites de zone avant de placer les tuiles de bâtiment individuelles dans TileZed.

AnimZed : éditeur d’animation de sprites

AnimZed est l’éditeur d’animation de sprites maison que The Indie Stone développe pour les animations de sprites. Le travail d’animation dans Project Zomboid implique des feuilles de sprites, le timing des images et les machines d’état qui contrôlent comment les personnages, animaux et objets se déplacent. AnimZed vise à rendre ce workflow plus accessible que l’édition manuelle de données de sprites.

Statut actuel d’AnimZed :

  • En développement actif dans le cadre de la poussée d’outils post-B42
  • Géra les animations de personnages, le mouvement animal et les changements d’état des objets
  • Devrait être livré avec la documentation AnimZed après que les priorités de hotfix se calment

Pour l’instant, les moddeurs travaillant avec des animations doivent étudier le format d’animation existant dans les fichiers du jeu de base et surveiller les blogs officiels des développeurs pour les annonces de sortie AnimZed.

PZTools : édition Qt maintenue par la communauté

PZTools est une continuation non officielle de PZWorldEd, TileZed et BuildingEd de Tim Baker, maintenue par la communauté. Il inclut PZWorldEd, TileZed et BuildingEd avec support pour les workflows de cartographie Build 42 actuels.

Ce que PZTools ajoute :

  • Configuration portable qui ne dépend pas des installations système
  • Support natif 256-cell pour de plus grandes zones de carte
  • Édition d’images et fonctionnalités d’automatisation de cartographie
  • Mis à jour pour les formats de tuiles Build 42

PZTools est le point de départ recommandé pour les moddeurs qui veulent le workflow TileZed sans attendre les mises à jour officielles des outils. Il est maintenu par la communauté, alors vérifiez le dépôt GitHub pour les dernières notes de compatibilité Build 42.

Comment les outils se connectent : un workflow de cartographie typique

Créer une carte personnalisée dans Project Zomboid passe généralement par plusieurs outils :

  1. Concept et planification — définissez la région que vous voulez créer
  2. WorldZed — définissez les limites de zone, points de spawn et connexions de routes
  3. TileZed — créez les tuiles individuelles et objets pour vos bâtiments
  4. WorldZed à nouveau — placez vos tuiles dans la grille de zones
  5. Test — chargez votre carte en jeu et itérez

Le workflow Build 42 ajoute des étapes supplémentaires à cause de la plus grande bibliothèque de tuiles. Attendez-vous à des temps d’export et d’import plus longs quand vous travaillez avec des zones urbaines denses.

Structure des dossiers de mods pour Build 42

Les mods dans Build 42 utilisent un système de dossiers structuré :

mods/
  VotreMod/
    mod.info          # Métadonnées du mod
    Contents/
      scripts/        # Scripts Lua du jeu
      media/
        textures/     # Feuilles de sprites et images
        tiles/        # Définitions de tuiles
        animations/   # Données d'animation
        maps/         # Fichiers mondiaux et de zones
        scripts/      # Lua supplémentaire
    docs/             # Documentation optionnelle

La structure de dossiers 42/ est devenue obligatoire pour le contenu Build 42. Les formats de mods Build 41 hérités peuvent ne pas se charger correctement sur la branche stable actuelle.

Où en apprendre plus

  • Section modding PZWiki — documentation complète sur l’API Lua, les formats de tuiles et le scriptage
  • Discord de modding Project Zomboid — communauté active pour les questions de workflow
  • Forums Steam Workshop modding — canaux officiels pour les annonces d’outils
  • Dépôt GitHub PZTools — mises à jour et documentation des outils communautaires

Le modding est une compétence profonde. Commencez par des remplacements de tuiles simples avant d’essayer des surcharges complètes de carte. La bibliothèque de tuiles Build 42 est la plus grande de l’histoire du jeu—utilisez les tuiles existantes comme modèles plutôt que de construire de zéro.

Pièges courants pour les nouveaux moddeurs

  • Ignorer l’exigence du dossier 42/ — Le contenu Build 42 doit utiliser la nouvelle structure de dossiers
  • Zones de tuiles qui se chevauchent — Les zones WorldZed ne doivent pas entrer en conflit ou le jeu plante au chargement
  • Mismatches de timing d’animation — Les sprites doivent correspondre au taux d’images que le jeu attend
  • Tester sur unstable seulement — Vérifiez toujours que votre mod se charge sur stable avant de publier

Guides associés

FAQ

Foire aux questions

Réponses rapides aux questions les plus fréquentes.

De quels outils ai-je besoin pour modder Project Zomboid?

TileZed pour les tuiles, WorldZed pour l'assemblage de cartes, et AnimZed pour les animations. PZTools est l'édition Qt maintenue par la communauté qui combine ces workflows.

Les outils officiels sont-ils mis à jour pour Build 42?

TileZed et WorldZed ont reçu des mises à jour pour la bibliothèque de tuiles Build 42.20. AnimZed est encore en développement dans le cadre de la poussée d'outils post-stable.

Qu'est-ce que PZTools?

Une continuation Qt non officielle de PZWorldEd, TileZed et BuildingEd originaux, maintenue par la communauté avec compatibilité Build 42.

Quelle structure de dossiers Build 42 exige-t-il?

Les mods Build 42 doivent utiliser la structure de dossiers 42/. Les formats de mods Build 41 hérités peuvent ne pas se charger sur la branche stable actuelle.

Où puis-je apprendre à modder Project Zomboid?

Commencez avec la documentation de modding PZWiki, rejoignez le Discord de modding Project Zomboid, et étudiez les mods existants dans le Workshop.