![Day[Z] Titan Launcher logo](/assets/img/logo2.webp?v=1781090027){kind=logo}
Day[Z] Titan Launcher
L’Addon Builder est l’empaqueteur PBO officiel livré avec DayZ Tools, et la colonne vertébrale de chaque mod PC - il transforme votre dossier de mod brut en .pbo chargeable. Les moddeurs l’ont surnommé « addon breaker » car les anciennes versions étaient capricieuses, mais les mises à jour récentes l’ont rendu vraiment fiable. Ce guide passe en revue chaque champ et option dans l’ordre, du lancement de l’outil au message « build successful ».
Obtenir sur Steam — DayZ ToolsSuivez l’ordre. Les premières étapes pointent le builder vers les bons dossiers, les étapes du milieu couvrent les options d’empaquetage, et la fenêtre Options contient deux réglages - les motifs files-to-copy et la clé privée - qui décident discrètement du sort d’un mod.
L’Addon Builder se trouve dans DayZ Tools, un paquet gratuit sur Steam (App 830640). Ouvrez Steam, réglez le filtre de bibliothèque sur Tools et recherchez DayZ Tools - s’il n’apparaît pas, vérifiez que la catégorie Tools est activée dans le menu déroulant au-dessus de la barre de recherche.
Lancez-le et laissez-le démarrer en mode administrateur. DayZ Tools est la voie standard et prise en charge pour obtenir l’Addon Builder, aucun téléchargement tiers n’est donc nécessaire pour suivre ce guide.
Obtenir sur Steam — DayZ Tools
Dans le lanceur DayZ Tools, les outils sont listés sur le côté gauche. L’Addon Builder est la troisième entrée en partant du haut - cliquez dessus pour ouvrir l’empaqueteur.
La fenêtre principale apparaît alors avec tous ses champs et cases à cocher. Elle peut sembler chargée au début, mais chaque option est traitée ci-dessous dans l’ordre où vous l’utiliserez réellement.
L’Addon source directory pointe vers le tout premier dossier de votre structure de mod - le dossier racine qui contient tout ce que vous voulez empaqueter. Le builder parcourt depuis ce dossier jusqu’au bout, en intégrant chaque fichier qu’il contient.
Empaquetez toujours depuis le lecteur P:, où vous devriez effectuer l’essentiel de votre travail de modding. Le lecteur P: renseigne automatiquement les bons chemins de fichiers, de sorte que les textures, modèles et autres assets référencés par votre mod sont résolus à l’empaquetage. Si vous pointez plutôt vers quelque chose comme C:\Program Files\Steam\steamapps\..., les chemins figent un emplacement que personne d’autre n’a sur sa machine et les assets ne se chargeront pas.
Le destination directory (ou un nom de fichier se terminant par .pbo) décide exactement où le fichier empaqueté est écrit. Vous pouvez le déposer directement dans la structure de dossiers voulue - par exemple le dossier addons de votre serveur - en modifiant cette seule ligne.
C’est particulièrement pratique pour les tests : changez le chemin ici et le builder produit là où vous en avez besoin, sans autre réglage. Vous pouvez le rediriger à tout moment lorsque vous empaquetez vers une autre cible.
L’Addon prefix vous permet d’écraser entièrement un PBO core ou celui de quelqu’un d’autre. En préfixant vos fichiers pour correspondre à l’original, le jeu charge votre version à la place de la version vanilla - utile pour des changements vanilla d’ampleur, comme refaire toutes les textures de véhicules ou ajouter des vêtements ensanglantés sur tous les fichiers rvmat vanilla sans créer une retexture séparée pour chacun.
Le prefixing est un sujet profond ; le même concept d’Arma 3 s’applique ici, il vaut donc la peine de chercher sur le wiki Bohemia et dans les vidéos communautaires si vous voulez tout le détail. Le champ Addon version à côté n’est que de la comptabilité - 1.0, 2.0, etc. - pour organiser vos releases. Il n’affecte pas la construction.
Avec Clear temp folder activé, le builder crée une copie de sauvegarde de votre mod dans un dossier temp sur le lecteur P: pendant l’empaquetage. Si quelque chose tourne mal en cours de build, cette copie est un filet de sécurité au cas où votre structure de dossiers core serait corrompue.
Lors d’un empaquetage réussi, la copie temp est supprimée automatiquement, tandis que le .pbo fini est écrit à la destination définie plus tôt - prêt à tester, à pousser sur Steam ou à charger sur votre serveur.
La signature écrit une signature sur votre PBO à l’aide d’une .bikey privée. C’est requis pour tout mod public - voire privé - pour être utilisable : le joueur doit placer la .bikey correspondante dans le dossier keys à la racine de son serveur. Sans cette clé, un PBO non signé ne se chargera tout simplement pas dans le jeu.
La case reste grisée tant que vous ne pointez pas le builder vers une clé privée dans la fenêtre Options (étape 11). Définissez d’abord la clé, et l’option Sign output PBO devient disponible.
Binarize - prononcé « bi-nice » par beaucoup de moddeurs - convertit vos modèles et configs au format compilé du moteur. Cela protège votre travail (quiconque dépaquette le mod voit un bloc de remplacement au lieu de votre modèle dans Object Builder) et, surtout, permet à DayZ de lire correctement votre structure de fichiers. L’omettre est une cause connue de bugs étranges et difficiles à diagnostiquer.
Binarize all textures fait de même pour les textures elles-mêmes. Activez les deux pour une release normale. La seule exception critique est config.cpp, qui ne doit jamais être binarisé - cela est géré par la liste files-to-copy à l’étape 10.
Enable extended logging fait imprimer au builder un rapport complet de tout ce qu’il fait pendant un empaquetage - chaque fichier synchronisé, utilisé et traité. Lorsqu’un build échoue, ce niveau de détail vous permet de remonter au fichier ou à l’étape exacte qui a causé le problème.
Un build raté affiche une fenêtre d’erreur que vous devez fermer. Un bon passage se termine par un message clair « build successful » et la liste complète des fichiers affichée en dessous.
Ouvrez Options et restez sur l’onglet General. La case « files to copy » contient une liste de motifs séparés par des virgules ou des points-virgules - par exemple *.emat; - qui sont copiés tels quels dans le PBO, sans être binarisés. Chaque entrée est une étoile (tout nom), un point, l’extension, puis un point-virgule pour clore.
Gardez toujours *.cpp dans cette liste. Si config.cpp est binarisé, cela peut casser votre système de santé - les états de santé de départ peuvent ne plus passer correctement à endommagé, gravement endommagé ou ruiné. Le config.cpp contrôle la façon dont les objets et modèles sont implémentés, leurs valeurs de dégâts et les textures attachées, donc le protéger de la binarisation est essentiel.
Vous devez aussi exclure les fichiers image set et layout. S’ils sont binarisés, ils ne peuvent pas s’afficher comme icônes ou images fantômes - les aperçus d’accessoires pâles que vous voyez pour les chargeurs, grenades et objets personnalisés similaires - les laisser dans la liste de copie maintient votre habillage d’interface fonctionnel.
Toujours dans Options, réglez Path to the private key sur votre fichier .bikey - c’est ce qui dégrise la case Sign output PBO de l’étape 7. Cliquez sur les trois points, naviguez vers votre dossier de clés privées et double-cliquez sur la clé à utiliser.
Un workflow courant consiste à empaqueter avec une clé de test dédiée. Si vous faites cela, remettez-la avant de publier : signer avec une clé qui ne correspond pas à la .bikey du dossier keys du serveur causera des problèmes de chargement. Le même onglet Options contient aussi le chemin du dossier temp, le chemin du dossier projet (pointez-le vers votre lecteur P:), le champ author (par défaut votre nom Steam) et la liste de motifs d’exclusion - laissez le fichier d’exclusion sur sa valeur par défaut.
L’onglet Tools à côté de General ne liste que les chemins par défaut des outils sous-jacents. Il n’y a presque jamais de raison d’y toucher ; laissez « use default » coché sauf si vous avez délibérément déplacé votre installation.
Source et destination définies et options choisies, cliquez sur Pack. Si un PBO existe déjà à la destination, le builder demande s’il faut l’écraser - confirmez par oui - et s’il n’en existe pas, il commence à empaqueter immédiatement.
Une fois terminé, vous verrez « build successful » et la sortie écrite dans votre dossier de destination. Si un build échoue, réessayez une fois avant de conclure que le mod est cassé - l’Addon Builder a parfois des ratés, et une seconde tentative propre réussit souvent. À partir de là, le .pbo est prêt à tester, signer ou livrer.
Le lecteur P: résout automatiquement les chemins de fichiers référencés par votre mod, de sorte que textures, modèles et autres assets se chargent correctement. Empaqueter depuis un chemin comme C:\Program Files fige un emplacement que personne d’autre n’a, et les assets ne se chargeront pas.
Binariser config.cpp peut casser votre système de santé, de sorte que les états de santé de départ peuvent ne pas passer à endommagé, gravement endommagé ou ruiné. Garder *.cpp dans la liste files-to-copy le copie non binarisé et évite cela.
Oui pour tout mod partagé. La signature avec une .bikey privée est requise, et les joueurs doivent placer la .bikey correspondante dans le dossier keys de leur serveur. Un PBO non signé ne se chargera pas.
Il compile vos modèles et configs au format du moteur, les protège d’une ouverture dans Object Builder et permet à DayZ de lire correctement votre structure de fichiers. L’omettre provoque des bugs difficiles à diagnostiquer.
Activez extended logging pour voir exactement quel fichier a causé l’erreur, puis empaquetez une fois de plus. L’Addon Builder a parfois des ratés, et une seconde tentative propre réussit souvent.