Particules
Particules ouvre et modifie les effets de particules : les fichiers .ptc qui décrivent la fumée, le feu, les étincelles, la poussière et les explosions que joue le jeu. Vous l'utilisez pour étudier les effets du jeu, en copier un dans votre mod, changer ses émetteurs et ses courbes, et regarder un aperçu approximatif pendant ce temps. Pour parcourir les effets du jeu, il faut le dossier DayZ défini dans les Paramètres ; pour lister les vôtres, il faut un dossier de workspace (également dans les Paramètres).
La page est marquée Aperçu dans le rail. Ouvrir, modifier, valider et enregistrer des effets fonctionne. L'aperçu est une approximation du moteur, et les fichiers que cette page écrit ont été vérifiés par sa propre validation, pas dans le jeu : regardez toujours un effet modifié en jeu avant de le livrer.
L'écran
- En-tête : Nouveau (un effet non enregistré avec un émetteur), Ouvrir (un
.ptcn'importe où sur le disque), Annuler, Rétablir, Recharger, Enregistrer sous, Enregistrer. Un badge « modifié » s'affiche tant qu'il y a des modifications non enregistrées. - Liste des effets (à gauche) : le commutateur Workspace / Jeu, un bouton Réanalyser et un champ de filtre. Workspace liste les fichiers
.ptcde vos dossiers de workspace. Jeu liste les effets dans les PBO du jeu (les archives dans lesquelles le jeu livre ses fichiers), restreints par le champ de recherche. Cliquez sur une ligne pour l'ouvrir. - Barre d'aperçu (au centre, en haut) : Lecture / Pause, Relancer, vitesse (0,1× à 2×), Boucle, Grille, couleur d'arrière-plan, Cadrer.
- Aperçu (au centre) : l'effet en cours de lecture. Glisser fait orbiter, glisser avec le bouton droit déplace, la molette zoome. Quand rien n'est ouvert, il montre quoi faire ; quand un fichier ne peut pas être lu, il montre l'erreur.
- Ligne d'état (sous l'aperçu, une fois un effet ouvert) : d'où vient l'effet, et un badge avec le nombre de problèmes. Cliquez sur le badge pour les lister ; cliquez sur un problème pour sélectionner son émetteur.
- Émetteurs (à droite, en haut) : une ligne par émetteur avec son index (
#0,#1...). Les boutons au-dessus ajoutent, dupliquent, déplacent et suppriment un émetteur. L'œil d'une ligne masque cet émetteur dans l'aperçu seulement. - Effet (à droite) : les deux clés de l'effet lui-même,
VelAffectetMinFPS. - Émetteur (à droite) : le nom de l'émetteur sélectionné, son matériau avec une miniature et un bouton Choisir, puis ses paramètres en six groupes (Émission, Particule, Mouvement, Rotation, Animation de sprite, Rendu). Survolez le nom d'un paramètre pour lire ce qu'il fait.
- Courbes (à droite, en bas) : un badge par courbe ; vert signifie que l'émetteur la définit. L'éditeur en dessous montre la courbe choisie sous forme de graphique et de tableau de clés.
Premiers pas
- Cliquez sur Jeu en haut de la liste des effets.
- Saisissez
smoke_bonfiredans le champ de recherche et cliquez sur la ligne. - Regardez-le dans l'aperçu. Utilisez la liste des vitesses et Relancer pour regarder de plus près.
- À droite, lisez l'émetteur : son matériau,
BirthRate,LifeTime,Velocity, et les courbesSizeetAlpha. - Cliquez sur Enregistrer sous et enregistrez-le dans le dossier de votre mod. Le fichier est maintenant à vous : le bouton Enregistrer et la modification sont activés.
- Changez
BirthRateou glissez une clé de la courbeSizeet regardez l'aperçu suivre.
Faire la visite (dans l'app)
Tâches courantes
Copier un effet du jeu dans votre mod
- Passez la liste sur Jeu, cherchez, cliquez sur l'effet.
- Cliquez sur Enregistrer sous et choisissez un dossier de votre mod.
- Repassez la liste sur Workspace et appuyez sur Réanalyser si le fichier n'apparaît pas encore.
Commencer un nouvel effet
- Cliquez sur Nouveau : vous obtenez un émetteur avec des valeurs par défaut.
- Cliquez sur Choisir dans la section Matériau et choisissez un matériau de particule (
.emat). - Définissez les paramètres d'Émission (
ShapeType,BirthRate,MaxNum), puisLifeTimeetVelocity. - Appuyez sur Ctrl+S : un effet non enregistré demande où l'enregistrer.
Changer la façon dont les particules s'estompent ou grandissent
- Sélectionnez l'émetteur.
- Dans Courbes, cliquez sur
Alpha(opacité) ouSize. Si elle indique « Non définie », cliquez sur Ajouter une courbe. - Double-cliquez sur le graphique pour ajouter une clé, glissez une clé pour la déplacer, clic droit sur une clé pour la supprimer. Le tableau en dessous contient les valeurs exactes.
- Pour une courbe de couleur, utilisez la case de couleur de chaque clé.
Saisir des valeurs exactes
- Cliquez sur un champ numérique et tapez. Le champ garde ce que vous tapez ; le fichier reçoit le nombre analysé.
- Flèche haut / bas incrémente de 0,1 (de 1 pour les entiers) ; Maj multiplie le pas par dix, Alt le divise par dix.
- Le ✕ à côté d'un paramètre supprime la clé pour que la valeur par défaut s'applique de nouveau.
Corriger ce que la validation signale
- Cliquez sur le badge des problèmes sous l'aperçu.
- Cliquez sur une ligne : son émetteur est sélectionné, et le paramètre ou la courbe fautifs sont marqués en rouge à droite.
- Corrigez la valeur. Le compteur se met à jour pendant la frappe.
Renommer ou réordonner des émetteurs
- Saisissez le nouveau nom dans le champ Nom et appuyez sur Entrée. Les noms doivent être uniques.
- Utilisez les flèches au-dessus de la liste des émetteurs pour le déplacer. Déplacer change son index, que les scripts utilisent.
Exemples
- Fumée de feu de joie (dans l'app) : un émetteur et quatre courbes (Color, Alpha, RotationSpeed, Size). L'effet le plus court à lire de haut en bas.
- Petit feu de camp (dans l'app) : six émetteurs (lueur, trois couches de flammes, étincelles, fumée). Masquez-les un par un avec l'œil pour voir ce qu'apporte chacun ; notez lesquels ont
Repeatactivé. - Explosion de mine (dans l'app) : quatorze émetteurs avec
EffectTime0.1 et sansRepeat: un effet ponctuel. Gardez Boucle activé, ralentissez la vitesse et appuyez sur Relancer. - Échappement du Hatchback (dans l'app) : un seul petit émetteur utilisé pour un véhicule.
Les exemples s'ouvrent depuis le jeu, en lecture seule.
Concepts
- Fichier d'effet (.ptc) : un fichier texte. Un
EffectDefcontient une liste d'émetteurs (Emitors), chacun unEmitorDefavec un nom et des lignesKey value. Les clés absentes prennent une valeur par défaut ; la page montre cette valeur par défaut en grisé dans le champ vide. - Émetteur : une source de particules : où elles naissent (
ShapeType,ShapeSize,Offset,Angles), combien (BirthRate,MaxNum), combien de temps vit chacune (LifeTime), comment elles bougent (Velocity,ConeAngle,GravityMultiply,AirResistance) et comment elles sont dessinées (matériau,SizeMultiplier,BillboardingType). Un effet superpose plusieurs émetteurs. - EffectTime et Repeat :
EffectTimeest la durée pendant laquelle l'émetteur émet, en secondes. AvecRepeatdésactivé, l'émetteur s'exécute une fois (une explosion) ; activé, il recommence (un feu). - Courbes : une valeur dans le temps, sous forme de clés entre 0 et 1.
Color,Alpha,SizeetRotationSpeedcourent sur la vie d'une particule (0 = naissance, 1 = mort). Les courbes finissant parMast(AlphaMast,SizeMast,BRateMast,VelocityMast...) courent sur l'EffectTimede l'émetteur et s'appliquent à toutes ses particules. - Matériau (.emat) : la texture des particules, son mode de fusion (additif ou fusion alpha) et sa grille de planche de sprites. Un
.ptcy fait référence sous la forme{GUID}Graphics/Particles/materials/….emat; la boîte Choisir écrit cette référence pour vous. - Utiliser un effet depuis un script : le jeu enregistre chaque effet dans la classe
ParticleList(scripts/3_Game/Particles/ParticleList.c), qui transforme un nom de fichier en identifiant entier. Un mod ajoute le sien avecmodded class ParticleList { static const int MY_EFFECT = RegisterParticle("mod_folder/", "my_effect"); }: le dossier avec des barres obliques et une barre finale, le nom du fichier sans.ptc. L'identifiant se joue ensuite avecParticle.PlayOnObject(id, object, localPos)ouParticle.PlayInWorld(id, position)(ParticleManageroffre les mêmes appels). - Changer un effet à l'exécution :
Particle.SetParameter(emitter, parameter, value)prend l'index de l'émetteur (le#affiché dans la liste des émetteurs) et une constanteEmitorParam. L'infobulle d'un paramètre donne sa constante quand il en a une (par exempleBirthRateestEmitorParam.BIRTH_RATE).
Référence : les pages Particle Editor du wiki communautaire de Bohemia Interactive (DayZ Workbench).
Pièges
- L'aperçu n'est pas le jeu. Il simule le taux de naissance, la durée de vie, la vitesse dans le cône, la gravité, la traînée, les rebonds sur le sol et les courbes. Il ne simule ni le vent, ni les ressorts, ni l'éclairage. Vérifiez le résultat en jeu.
- Les effets du jeu sont en lecture seule. Enregistrer est désactivé pour eux et son infobulle dit pourquoi ; Enregistrer sous crée votre copie. Rien dans le dossier DayZ n'est jamais modifié.
- L'ordre des émetteurs compte pour les scripts. Les scripts désignent les émetteurs par index, donc déplacer ou supprimer un émetteur change ce qu'un appel à
SetParametertouche. - Un matériau « introuvable ». L'effet s'ouvre quand même, mais les particules n'ont pas de texture. Choisissez de nouveau le matériau, ou vérifiez que les données du jeu sont montées (dossier DayZ dans les Paramètres).
- Enregistrer peut réindenter un fichier écrit à la main. Quand un fichier n'est pas mis en forme comme la page l'écrit, le journal le dit à l'ouverture. La version précédente est conservée comme sauvegarde à chaque enregistrement.
- Quelqu'un d'autre a modifié le fichier. Si le fichier a changé sur le disque après son ouverture, Enregistrer s'arrête et propose Recharger ou Enregistrer quand même. Sans modifications non enregistrées, la page le recharge d'elle-même.
- Les clés inconnues sont conservées. Les clés que la page ne connaît pas sont listées sous « Autres clés » et réécrites telles quelles ; elles ne peuvent pas être modifiées ici.
- Quitter la page garde l'effet ouvert, ses modifications non enregistrées et son historique d'annulation ; la lecture se met en pause jusqu'à votre retour.
Pour les agents
Outils de dzt qui font le même travail sans la fenêtre :
ptc_info: résumé d'un.ptc(chemin de fichier ou chemin virtuel du jeu) : clés de l'effet, et par émetteur son nom, index, matériau, forme,MaxNum,BirthRate,LifeTime,EffectTime,Repeat, courbes et clés inconnues.ptc_validate: les vérifications de la liste des problèmes : structure, noms d'émetteurs, types et plages de valeurs, courbes, et aveccheck_materialssi chaque matériau existe dans les fichiers montés.vfs_searchavec"ext":"ptc": trouver les effets du jeu par chemin ;vfs_readrenvoie le texte de l'un d'eux.file_read: lire un.ptcd'un mod comme du texte. Un.ptcest du texte brut, donc les outils habituels de modification de fichiers s'appliquent ; lancez ensuiteptc_validate.
Fichiers que la page lit et écrit :
- Lit les fichiers
.ptcdes dossiers de workspace (trouvés par une analyse sur 12 niveaux de dossiers au plus) et des PBO du jeu ; lit les matériaux.ematet leurs textures pour les miniatures et l'aperçu. - Écrit uniquement le
.ptcque vous enregistrez. Chaque enregistrement copie d'abord la version précédente dansparticle-backups/<file name>/<time>.ptcdu dossier de configuration de l'application. - Le fichier ouvert est surveillé : une modification faite par un autre programme est rechargée (ou signalée, si vous avez des modifications non enregistrées).
Ce que la page dit à l'assistant : le fichier ouvert (ou « game, read-only » / « new effect »), l'émetteur sélectionné, le nombre d'émetteurs, une erreur de chargement le cas échéant, s'il y a des modifications non enregistrées, et la liste des problèmes de validation (émetteur et message). Elle propose l'action « Vérifier cet effet ».
Ancres des étapes guidées : particles-new, particles-open, particles-save-as, particles-save, particles-files, particles-game, particles-preview-bar, particles-preview, particles-problems, particles-inspector, particles-emitters, particles-curves.
Voir aussi
- Textures (PAA) : regarder les planches de sprites qu'utilisent les matériaux de particules.
- Éditeur de scripts : déclarer l'effet dans
ParticleListet le jouer. - Packer PBO : empaqueter le
.ptcavec votre mod. - Le Workbench