Particle Editor

From Valve Developer Community
Jump to navigation Jump to search
English (en)Deutsch (de)Translate (Translate)


This article is about Source Source 1 version of Particle Editor. For the Source 2 Source 2 version, see Particle Editor (Source 2).

The Particle Editor is an engine tool available since SourceSource 2007 on Windows machines. To use it, run your game or mod with -tools -nop4 on the command line and select 'Particle Editor' from the Tools menu. Make sure that sv_lan is set to 1 in the console located in the lower-left corner (sv_lan 1).


To load a map into the engine viewport, look to the console window at the bottom of the screen and type map <levelname>.

Tip.pngTip:Earlier particle editor builds never refresh particles in the current map. To work around this, execute bind h "ent_fire info_particle_system stop;wait 120;ent_fire info_particle_system start" in the console then use H.

Currently Supported Games

Icon-Bug.pngBug:The 64-bit particle editor is currently broken. The 32-bit version of TF2 must be started, this can be done by creating a .bat file beside the executable with these contents: tf.exe -game tf -tools and launching that.  [todo tested in?]

Interface guide

This screenshot is from Alien Swarm. Earlier versions of the editor look different, but work in the same way.

Particles asw.jpg

The top edge of the screen is the main menu. From here you can load and save PCF files, undo and redo actions, and configure your workspace.

  1. The browser shows the contents of the current PCF file. You can store any number of particle systems in the same PCF. The numbers of parents and children are shown beneath the preview.
  2. The engine viewport shows whatever the game is currently rendering. You can flip control to and from the game with F10, and maximise your view with F11.
  3. Properties is where the current particle system is edited. You can add, remove and configure new functions and children. Whenever you make a change, all instances of the particle system restart.
    Tip.pngTip:You can use your scroll wheel to increase or decrease most values. There are three modifier keys to help with this:
    • For increments of 0.1, use Ctrl
    • For increments of 10, use Shift
    • To lock the value to 0-1, use Alt
  4. The preview window shows the current system and its children up close. You can manipulate your view by holding LMB to rotate, RMB to zoom, and MMB to pan. The "Ctrl Pnts" tab lets you configure temporary control points for the preview. The "Lock Preview System" checkbox stops the preview from updating when you select a new system, making it easy to edit child systems and see the result in its proper context. To

The bottom edge of the screen contains a compact developer console. Commands are entered into the left box, while the last line of output is displayed in the right.

See also