Steam Workshop
Cette page compile un mod entier et le publie sur le Steam Workshop, d'où les joueurs et les
serveurs téléchargent les mods DayZ. Elle part d'un petit fichier de votre projet,
ci/build.yaml : elle empaquette et signe chaque addon (Compiler le mod), lance les
vérifications préalables, vous laisse écrire la note de version, et n'envoie qu'après votre
confirmation. Il vous faut un dossier de mod (sources ou un @Mod déjà compilé), une clé de
signature (Clés & signature) et un compte Steam qui possède DayZ.
C'est la dernière étape du chemin de build et de publication : empaqueter (Packer PBO), signer (Clés & signature), tester en local (Launcher), publier. Compiler le mod fait les étapes d'empaquetage et de signature pour tout le mod, et son bouton Tester avec un serveur local passe le résultat au Launcher.
L'écran
- En-tête : la liste des fichiers
build*.yamltrouvés dans les dossiers de vos projets, Ouvrir (n'importe quelle config sur le disque), Nouvelle config. - Mes objets Workshop : les objets publiés par le compte Steam de cet ordinateur (privés
compris), rapprochés de vos projets : visibilité, abonnés, dernière mise à jour, projet local,
et par ligne Ouvrir, Publier… (charge son
build.yaml), Créer une configuration avec cet id, des liens vers l'objet. Elle ne contacte Steam que quand vous appuyez sur Actualiser. - Introduction (tant qu'aucune config n'est ouverte) : ce que vérifie une publication et les deux façons de commencer.
- Avec une config ouverte :
- Objet : nom du mod, id de l'objet Workshop (
0= un nouvel objet sera créé), dossier de contenu, détails publics de l'objet, Objet protégé, et les options pour mettre aussi à jour la visibilité ou les tags. - Vérifications préalables : une ligne par vérification avec un badge OK / Avertissement /
Erreur, et des boutons de correction là où la page peut corriger (écrire
meta.cpp, installer steamcmd). - Compiler le mod : sources, addons trouvés, dossier de sortie, clé de signature, Compiler le mod, Tout reconstruire, le journal de build, puis Tester avec un serveur local, Plutôt le diag hors ligne et Publier….
- Note de version : le texte de cette version (BBCode Steam).
- Connexion Steam : envoi via le client Steam ou steamcmd, délai d'abandon, la confirmation supplémentaire d'un objet protégé, Publier sur le Workshop.
- Annonce Discord : annoncer après une publication, webhook, qui mentionner, message, Envoyer un test.
- La description d'envoi générée (VDF) et le journal d'envoi.
Premiers pas
- Appuyez sur Nouvelle config et choisissez le dossier de votre mod : un
@MyModcompilé, un dossier d'addon (avec unconfig.cpp) ou le dossier qui contient vos dossiers d'addon. Le reste du formulaire se remplit. - Laissez
workshop_item_idà0pour un mod qui n'est pas encore sur le Workshop. Gardez la visibilité Privé pour un premier envoi. Appuyez sur Créer et ouvrir :ci/build.yamletci/CHANGENOTE.mdsont écrits dans votre projet. - Dans Compiler le mod, vérifiez les addons et la clé de signature, puis appuyez sur
Compiler le mod. Les PBO sont écrits dans
target/@MyMod/addons, signés, aveckeys/,meta.cppetmod.cpp. - Appuyez sur Tester avec un serveur local : le Launcher démarre un serveur avec le mod compilé, puis le jeu.
- De retour ici, lisez Vérifications préalables. Corrigez chaque ligne rouge.
- Écrivez la Note de version, appuyez sur Publier sur le Workshop, lisez la confirmation, confirmez.
Suivre la visite guidée (dans l'app) · Visite : préparer une version (dans l'app)
Tâches courantes
Créer le build.yaml d'un mod
- Nouvelle config, choisissez le dossier du mod.
- Définissez l'id de l'objet (
0pour un nouvel objet, ou collez l'id / le lien d'un objet existant), le titre, la visibilité, une image d'aperçu facultative (png / jpg / gif de moins de 1 Mo), la description et les tags. - Ouvrez Aperçu de build.yaml pour voir le fichier, puis Créer et ouvrir.
Compiler le mod
- Ouvrez la config, appuyez sur Compiler le mod.
- Les addons dont les fichiers n'ont pas changé sont conservés ; cochez Tout reconstruire pour tout réempaqueter.
- Les badges donnent compilés / inchangés / ignorés / échecs, et si le mod est prêt à publier.
Publier une mise à jour
- Compilez, testez, puis vérifiez qu'aucune ligne des vérifications préalables n'est rouge.
- Écrivez la note de version.
- Envoyer via : le client Steam (Steam lancé, connecté avec le compte qui possède l'objet ; sans mot de passe) ou steamcmd (identifiant, mot de passe, code Steam Guard).
- Publier sur le Workshop → la boîte de dialogue montre l'objet, ses abonnés et la note →
confirmez. Pour un nouvel objet, son id est réécrit dans
build.yaml.
Protéger un objet en ligne
- Ouvrez sa config, cochez Objet protégé.
- Chaque publication demande alors une case de plus (« Cet objet est protégé… je veux vraiment
le mettre à jour ») avant que le bouton fonctionne. Le réglage est conservé dans vos
paramètres ;
protected: truedansbuild.yamlle protège aussi pourdztet les assistants.
Annoncer sur Discord
- Dans Discord, créez un webhook pour le salon et copiez son URL.
- Collez-la dans URL du webhook (elle est enregistrée dans vos paramètres locaux pour cette config).
- Choisissez qui mentionner, éventuellement un message, appuyez sur Envoyer un test (sans mention).
- Cochez Annoncer : après une publication réussie, le titre, le lien, l'aperçu et la note de version sont publiés.
Exemples
Cette page n'a pas d'exemple à ouvrir : elle travaille sur votre propre projet et votre compte
Steam. Pour voir un projet complet, créez un mod depuis l'Accueil (Nouveau mod) et ouvrez le
ci/build.yaml qu'il contient.
Concepts
build.yaml: la config de publication d'un projet, en généralci/build.yaml. Champs principaux :mod_name(@MyMod),workshop_item_id(0= créer),content_dir(par défauttarget/<mod_name>),title,description/description_file,preview_image,visibility(0 public, 1 amis, 2 privé, 3 non répertorié),tags,changenote/changenote_file,update_metadata,protected, un blocdiscord:, et les réglages de build :src_dir,skip,exclude_packages,exclude_files,private_key/key_dir,sign,binarize,author,version,mod_cpp.- Ce que fait un build : chaque dossier d'addon de
src_dir(par défautsrc/, sinon les dossiers de la racine du projet contenant unconfig.cpp) est empaqueté dans<content>/addons/<name>.pboavecconfig.cppbinarisé ; les addons inchangés sont ignorés ; chaque PBO est signé avec la clé du projet (private_key, sinon l'unique*.biprivatekeydekey_dir, sinon votre clé par défaut) ; les signatures d'autres clés ou de PBO supprimés sont retirées ;keys/<authority>.bikey,meta.cpp(avec l'id de l'objet) etmod.cppsont écrits ; puis les vérifications préalables s'exécutent. Un build n'envoie jamais rien. - Le plan et ses vérifications préalables : avant tout envoi, la page calcule un plan : la
note de version résolue, la description d'envoi exacte, et des vérifications : PBO présents
dans
addons/, chaque.bisignvalide aveckeys/*.bikey,meta.cppavec le bonpublishedid, image d'aperçu de moins de 1 Mo, rien qui ne doive être livré (une clé privée), objet protégé confirmé. Une Erreur bloque le bouton Publier ; un Avertissement non. - Note de version : le texte que Steam affiche dans l'historique des modifications de
l'objet. Elle vient de
changenote_file(par défautci/CHANGENOTE.md; les lignes commençant par#sont des commentaires) ou dechangenote. Les modifications faites sur la page ne valent que pour cette publication. meta.cpp/mod.cpp: de petits fichiers à la racine de@Mod.meta.cpprelie le dossier à son objet Workshop (publishedid) ;mod.cppdonne le nom et l'auteur affichés dans les launchers.- Objets protégés : un objet qui a une audience active. Y publier demande une confirmation
supplémentaire explicite, dans la page et dans
dzt(confirm_protected). - Webhook Discord : une URL secrète qui permet à n'importe qui de poster dans votre salon.
Elle n'est conservée que dans les paramètres locaux, jamais dans
build.yaml; la CI la lit depuis une variable d'environnement (DISCORD_WEBHOOK_URLsauf sidiscord.webhook_enven nomme une autre). Elle n'est jamais envoyée à un assistant. - Le Workshop de DayZ : https://steamcommunity.com/app/221100/workshop/.
Pièges
- Publier un ancien build : vous modifiez les sources, oubliez de compiler, publiez. Compilez d'abord. Dans Mes objets Workshop, mise à jour nécessaire marque un objet dont le build local est plus récent que ce qui est publié.
- Mauvais id d'objet : une mise à jour écrase l'objet pour tous les abonnés. La confirmation montre le titre de l'objet et le nombre d'abonnés : lisez-la. Protégez les objets en ligne.
update_metadata: il renvoie titre, description, visibilité et aperçu et écrase ce que vous avez modifié sur la page Steam. Laissez-le désactivé et utilisez les deux cases « Définir aussi ».- Config dans le dossier envoyé : la page refuse d'enregistrer
build.yamldans@Mod. - Premier envoi public par accident : les nouveaux objets sont Privé par défaut ; rendez- les publics une fois testés.
- Steam vous affiche « en train de jouer à DayZ » quelques secondes pendant Actualiser et pendant un envoi via le client Steam : c'est normal.
- Mots de passe : le mot de passe steamcmd sert à l'envoi et n'est jamais stocké ; un code Steam Guard est à usage unique.
- Une publication continue quand vous quittez la page : l'id du nouvel élément est quand même écrit dans la config et l'annonce Discord part. Revenez pour voir son journal.
Pour les agents
- Outils de
dztqui font le même travail sans la fenêtre : mod_build: compile le mod entier depuis sonbuild.yaml(n'envoie jamais rien).workshop_plan: essai à blanc d'une publication : note de version, description d'envoi, vérifications préalables. Ne contacte jamais Steam. À lancer et à montrer toujours avant de publier.workshop_publish: envoi ; demandeconfirm: true, etconfirm_protected: truepour un objet protégé. Seulement sur demande explicite de l'utilisateur.workshop_changenote: rend une note de version (Markdown → BBCode Steam).workshop_announce: publie l'annonce Discord sans publier (confirm: true).workshop_item_info: détails publics d'un objet ;workshop_my_items: les objets du compte.workshop_install_steamcmd: télécharge steamcmd (confirm: true).mod_new: crée un projet qui a déjàci/build.yaml.- Fichiers lus :
build.yaml, les fichiers de note de version et de description, l'image d'aperçu, le dossier de contenu (target/@Mod), la liste d'objets en cache (<config>/workshop/published.json). Fichiers écrits : par Nouvelle configci/build.yaml,ci/CHANGENOTE.md,ci/DESCRIPTION.md(quand une description est saisie) et letarget/@Mod/addonsvide ; par un build les PBO,.bisign,keys/*.bikey,meta.cpp,mod.cpp; après une première publication le nouvel id d'objet dansbuild.yaml. Les paramètres conservent les objets protégés et les webhooks Discord. - État de la page transmis à l'assistant : le fichier de config ouvert, le nom du mod, l'objet Workshop (id ou « nouvel objet »), et l'erreur du plan comme problème. Jamais l'identifiant Steam, le mot de passe, le code Guard ni le webhook Discord. Ne les demandez pas dans le chat.
- Ancres :
workshop-config-picker,workshop-open,workshop-new-config,workshop-my-items,workshop-intro; avec une config ouverte :workshop-item,workshop-preflight,workshop-build,workshop-build-button,workshop-changenote,workshop-upload,workshop-publish,workshop-discord. Pointezworkshop-publish, ne cliquez jamais dessus à la place de l'utilisateur.
Voir aussi
- Packer PBO : empaqueter un seul addon, regarder dans un PBO.
- Clés & signature : créer la clé avec laquelle Compiler le mod signe.
- Launcher : tester le mod compilé avec un serveur local avant de publier.
- Présentation de Beans Workbench.