Particles

Tutorial · 2:53

Particles opens and edits particle effects: the .ptc files that describe the smoke, fire, sparks, dust and explosions the game plays. You use it to study the game's own effects, copy one into your mod, change its emitters and curves, and watch an approximate preview while you do. To browse the game's effects you need the DayZ folder set in Settings; to list your own you need a workspace folder (also in Settings).

The page is marked Preview in the rail. Opening, editing, validating and saving effects work. The preview is an approximation of the engine, and the files this page writes have been checked by its own validation, not in the game: always look at an edited effect in game before you ship it.

The screen

First steps

  1. Click Game at the top of the effect list.
  2. Type smoke_bonfire in the search field and click the row.
  3. Watch it in the preview. Use the speed list and Restart to look closer.
  4. On the right, read the emitter: its material, BirthRate, LifeTime, Velocity, and the Size and Alpha curves.
  5. Click Save as and save it into your mod folder. The file is now yours: the Save button and editing are enabled.
  6. Change BirthRate or drag a key of the Size curve and watch the preview follow.

Take the tour (in the app)

Common tasks

Copy a game effect into your mod

  1. Switch the list to Game, search, click the effect.
  2. Click Save as and choose a folder of your mod.
  3. Switch the list to Workspace and press Rescan if the file does not show yet.

Start a new effect

  1. Click New: you get one emitter with default values.
  2. Click Pick in the Material section and choose a particle material (.emat).
  3. Set the Emission parameters (ShapeType, BirthRate, MaxNum), then LifeTime and Velocity.
  4. Press Ctrl+S: an unsaved effect asks where to save.

Change how particles fade or grow

  1. Select the emitter.
  2. In Curves, click Alpha (opacity) or Size. If it says "Not set", click Add curve.
  3. Double-click the graph to add a key, drag a key to move it, right-click a key to remove it. The table below holds the exact values.
  4. For a colour curve, use the colour box of each key.

Type exact values

  1. Click a number field and type. The field keeps what you type; the file gets the parsed number.
  2. Arrow up / down steps by 0.1 (by 1 for whole numbers); Shift steps ten times more, Alt ten times less.
  3. The ✕ next to a parameter removes the key so the default applies again.

Fix what the validation reports

  1. Click the problems badge under the preview.
  2. Click a line: its emitter is selected, and the parameter or curve at fault is marked in red on the right.
  3. Correct the value. The count updates as you type.

Rename or reorder emitters

  1. Type the new name in the Name field and press Enter. Names must be unique.
  2. Use the arrows above the emitter list to move it. Moving changes its index, which scripts use.

Examples

Examples open from the game, read-only.

Concepts

Reference: the Particle Editor pages of the Bohemia Interactive community wiki (DayZ Workbench).

Pitfalls

For agents

Tools of dzt that do the same work without the window:

Files the page reads and writes:

What the page tells the assistant: the open file (or "game, read-only" / "new effect"), the selected emitter, the number of emitters, a load error if any, whether there are unsaved changes, and the list of validation problems (emitter and message). It offers the action "Check this effect".

Anchors for guided steps: 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.

See also