Packer PBO
Un PBO est le format d'archive que DayZ charge : le jeu ne lit pas les dossiers en vrac, il lit
un fichier .pbo par dossier d'addon d'un mod. Cette page empaquette un dossier d'addon dans un
PBO (ce que fait l'AddonBuilder de Bohemia) et ouvre n'importe quel PBO existant pour lister,
prévisualiser et extraire ses fichiers. Utilisez-la pour empaqueter un seul addon à la main ou
pour étudier comment est fait un addon vanilla ou tiers. Il vous faut un dossier d'addon (un
dossier contenant un config.cpp) pour empaqueter ; rien pour parcourir.
L'empaquetage est la première étape du chemin de build et de publication : empaquetez ici, signez dans Clés & signature, testez dans le Launcher, publiez depuis Steam Workshop. Pour un mod avec plusieurs dossiers d'addon, Compiler le mod sur la page Steam Workshop fait les deux premières étapes pour tout le mod d'un coup.
L'écran
- Onglets : Empaqueter (affiché en premier) et Parcourir et extraire.
- Empaqueter, carte de gauche « Source » :
- Dossier de l'addon : le dossier à empaqueter. Le reste du formulaire est mémorisé par dossier.
- .pbo de sortie : un fichier ou un dossier. Vide : dans un projet (un
ci/build.yamlou un dossiertarget/@Nameà côté de la source), le PBO va danstarget/@Name/addons/<folder>.pbo; ailleurs, il est écrit à côté du dossier source. Le texte indicatif montre le chemin. - Préfixe : vide, utilise le fichier
$PBOPREFIX$du dossier, affiché comme texte indicatif. Quand il n'y a ni l'un ni l'autre, un avertissement apparaît avec Écrire $PBOPREFIX$ d'après le nom du dossier. - Binariser config.cpp → config.bin (activé par défaut) et Signer après l'empaquetage (un champ Clé privée apparaît alors, rempli avec votre clé par défaut).
- Empaqueter et le journal du résultat (fichiers empaquetés, chemin de sortie, SHA-1).
- Empaqueter, carte de droite « Motifs d'exclusion » : un motif à joker par ligne (
*,?) ; les fichiers correspondants ne sont pas empaquetés. - Parcourir et extraire, volet de gauche : Ouvrir un PBO, un filtre, Tout extraire ; puis les badges d'en-tête (préfixe, nombre de fichiers, taille, somme de contrôle, autres champs d'en-tête) et le tableau des fichiers (nom, taille, stocké ou compressé en LZSS). Sans rien d'ouvert : une explication, Ouvrir un PBO, Ouvrir un exemple et vos PBO récents.
- Parcourir et extraire, volet de droite « Aperçu » : le fichier sélectionné en texte
(scripts, configs,
config.binreconverti en texte), en image (.paa,.edds,.png,.tga) ou en dump hexadécimal de ses 4096 premiers octets.
Premiers pas
- Ouvrez Packer PBO ; l'onglet Empaqueter s'affiche.
- Dans Dossier de l'addon, choisissez le dossier qui contient votre
config.cpp. - Regardez Préfixe. Si le badge « Pas de $PBOPREFIX$ ni de préfixe » s'affiche, appuyez sur
Écrire $PBOPREFIX$ d'après le nom du dossier (ou saisissez un préfixe comme
MyMod\scripts). - Laissez Binariser config.cpp coché. Cochez Signer après l'empaquetage si vous avez déjà une clé.
- Appuyez sur Empaqueter. Le journal indique où le PBO a été écrit.
- Passez à Parcourir et extraire, ouvrez le PBO que vous venez de créer et vérifiez son préfixe et ses fichiers.
Suivre la visite guidée (dans l'app) · Visite : regarder dans un PBO (dans l'app)
Tâches courantes
Empaqueter un dossier d'addon
- Onglet Empaqueter, choisissez le Dossier de l'addon.
- Vérifiez le préfixe, gardez Binariser coché.
- Empaqueter. Une ligne verte dans le journal donne le chemin de sortie.
Empaqueter et signer d'un coup
- Cochez Signer après l'empaquetage.
- Choisissez votre
.biprivatekey(la clé par défaut de Clés & signature est préremplie). - Empaqueter. Le journal ajoute « Signed → …bisign ». Si seule la signature échoue, le PBO est quand même écrit et le journal le dit.
Regarder dans un PBO vanilla
- Onglet Parcourir et extraire, Ouvrir un PBO, choisissez un fichier de
<DayZ>/Addons(ou utilisez l'exemple). - Saisissez dans le filtre (
config,.p3d,.paa…). - Cliquez sur une ligne pour la prévisualiser.
config.bins'affiche comme texte de config lisible.
Extraire un PBO pour lire ou réutiliser ses fichiers
- Ouvrez le PBO, appuyez sur Tout extraire.
- Choisissez un dossier de destination : les fichiers vont dans
<destination>/<pbo name>/. - Le PBO lui-même n'est pas modifié. Ne redistribuez pas les fichiers d'autres auteurs.
Laisser des fichiers hors d'un PBO
- Onglet Empaqueter, carte de droite.
- Ajoutez un motif par ligne, par exemple
*.psdoudocs/*. - Les motifs sont mémorisés avec le dossier.
Exemples
- Un PBO vanilla : gear_drinks (dans l'app) :
Addons/gear_drinks.pbode votre dossier DayZ, ouvert en lecture seule. Regardez le badge de préfixe (DZ\gear\drinks), le badge vert de somme de contrôle, la ligneconfig.bin(cliquez dessus : la config binaire s'affiche en texte, avec les classesCfgVehiclesdes boissons) etCanteen.p3davec ses textures sousdata\. Il faut que DayZ soit installé et son dossier défini dans les Paramètres.
Concepts
- PBO (« packed bank of files ») : une archive avec un petit en-tête (paires clé/valeur
comme
prefix), une liste d'entrées (nom, taille, horodatage, compressé ou non), les données des fichiers et une somme de contrôle SHA-1 à la fin. Référence : https://community.bistudio.com/wiki/PBO_File_Format. - Préfixe et
$PBOPREFIX$: le préfixe est le chemin virtuel que le jeu donne au contenu du PBO. Un fichierscripts\4_World\x.cdans un PBO de préfixeMyModestMyMod\scripts\4_World\x.cpour le jeu, et c'est le chemin que vous écrivez dansconfig.cppet dans les scripts. La convention est un fichier texte nommé$PBOPREFIX$à la racine du dossier de l'addon contenant le préfixe ; il est lu à l'empaquetage et n'est pas empaqueté lui-même. - Config binarisée : le jeu lit les configs sous forme binaire (« rapifiée »,
config.bin). Empaqueter avec Binariser convertit chaqueconfig.cppenconfig.bindans le PBO ; votre fichier source n'est pas touché. Seules les configs sont converties ici : les modèles et les textures sont empaquetés tels quels. - Ce qui est exclu : par défaut, la même liste que le
exclude.lstdes DayZ Tools plus les fichiers parasites du contrôle de version :*.h,*.hpp.bak,*.psd,*.tga,*.png,*.pac,*.bak,*.blend,*.blend1,*.fbx,*.max,*.xcf,thumbs.db,.git/*,.gitignore,.gitattributes,.vscode/*,.idea/*,$pboprefix$,$prefix$,$pboprefix$.txt,*.dep,*.tmp. Un motif commençant par/est ancré à la racine du dossier. - PBO protégés : certains auteurs chiffrent (EBO) ou obscurcissent leurs PBO. Le Workbench les liste mais n'ouvre, n'extrait ni n'indexe jamais leurs fichiers.
- Signature : un fichier
.bisignà côté du PBO prouve qui l'a empaqueté. Voir Clés & signature.
Pièges
- Pas de préfixe : sans
$PBOPREFIX$et sans préfixe saisi, le jeu ne peut pas résoudre les fichiers empaquetés. La page avertit avant l'empaquetage et peut écrire le fichier pour vous. - Exclure ce dont vous avez besoin :
*.pnget*.tgasont exclus par défaut (les images sources sont normalement converties en.paa). Si votre mod livre vraiment un.png, supprimez cette ligne. - Mauvais emplacement de sortie : avec la sortie laissée vide dans un projet, le PBO atterrit
dans
target/@Name/addons/, là où Compiler le mod et le Launcher l'attendent. Une sortie saisie est mémorisée pour ce dossier. - Modifier un PBO après signature : toute modification du
.pboinvalide son.bisign. Empaquetez, puis signez, jamais l'inverse. - Les fichiers du jeu sont en lecture seule : parcourez-les et extrayez-les, ne réempaquetez jamais un PBO vanilla. Modifiez plutôt le jeu avec votre propre addon.
- « checksum mismatch » : le fichier a été tronqué ou modifié après l'empaquetage ; empaquetez-le de nouveau.
Pour les agents
- Outils de
dztqui font le même travail sans la fenêtre : pbo_pack: empaquette un dossier d'addon (préfixe depuis$PBOPREFIX$sauf s'il est donné,config.cppbinarisé par défaut, signature facultative avec une.biprivatekey).pbo_list: en-tête, fichiers avec tailles, validité de la somme de contrôle,protection(argumentspbo,filter).pbo_read_file: un fichier d'un PBO en texte (config.bindérapifié).pbo_extract: tous les fichiers d'un PBO dans un dossier (éventuellement seulement certaines extensions).vfs_search/vfs_read: trouvent et lisent des fichiers du jeu par chemin virtuel sans nommer le PBO.mod_build: le mod entier (chaque dossier d'addon) depuisci/build.yaml.- Fichiers lus : le dossier de l'addon, son
$PBOPREFIX$, unci/build.yamloutarget/@*à côté (pour choisir la sortie par défaut), le.pboouvert. Fichiers écrits : le.pbode sortie, son.bisignen cas de signature,$PBOPREFIX$seulement depuis son bouton, les fichiers extraits seulement dans le dossier choisi par l'utilisateur. Le formulaire d'empaquetage par dossier source est conservé dans les paramètres. - État de la page transmis à l'assistant :
tab(empaqueter ou parcourir et extraire). Empaqueter : dossier source, sortie, préfixe (saisi ou détecté), binariser oui/non, signer oui/non, et les lignes d'avertissement / d'erreur du journal comme problèmes. Parcourir : le fichier ouvert, son préfixe, la raison deprotected, le filtre et l'entrée sélectionnée. Le chemin de la clé de signature n'est jamais inclus. - Ancres :
pbo-tabs,pbo-tab-pack,pbo-tab-browse,pbo-pack-source,pbo-pack-prefix,pbo-pack-options,pbo-pack-excludes,pbo-pack-button,pbo-open,pbo-files,pbo-preview,pbo-extract(seulement avec un PBO ouvert).
Voir aussi
- Clés & signature : signer le PBO que vous avez empaqueté.
- Steam Workshop : construire le mod entier et le publier.
- Launcher : tester le mod empaqueté avec un serveur local.
- Config : lire la config fusionnée du jeu que forment les fichiers
config.bin. - Présentation de Beans Workbench.