Commands

Since 2.0.0

Photon2 does not manage when, where, or how VFX are used. While Photon provides some built-in commands, these are primarily for testing purposes.

✨ Basic Commands

Command	Description
/photon particle_editor	Open the visual particle editor
/photon_client clear_particles	Remove all Photon particles
/photon_client clear_fx_cache	Clear FX cache (run after changing .fx files)

---

📦 FX Binding & Emitting

Photon2 lets you bind effects to blocks or entities, or emit them at specific positions with full parameter control.

Command Format

/photon fx <fxFile> <type> ... [offset] [rotation] [scale] [delay] [force death] [allow multi] ...

• <fxFile>: Resource location of the FX file (e.g., mod_id:filename for assets/mod_id/fx/filename.fx)
• <type>: block or entity
• See parameter table below for details

Parameter	Required	Default	Description
fxFile	Yes	-	FX file resource name, e.g. photon:fire
type	Yes	-	block or entity
offset	No	0 0 0	Position offset (x y z)
rotation	No	0 0 0	Rotation (Euler angles: x y z)
scale	No	1 1 1	Scale (x y z)
delay	No	0	Emit delay (ticks)
force death	No	false	Immediately remove all particles if the target becomes invalid
allow multi	No	false	Allow multiple effects with the same name to be bound to the same object

---

🟦 Bind FX to a Block

Format:

/photon fx <fxFile> block <position(x y z)> [offset] [rotation] [scale] [delay] [force death] [allow multi] [check state]

• position: Required, block coordinates (x y z)
• check state: If false (default), effect is removed if the block changes. If true, also removed if the blockstate changes.

Example:

/photon fx photon:fire block ~ ~ ~ 0 0 0 0 0 0 1 1 1 0 false false false

---

🟩 Bind FX to Entities

Format:

/photon fx <fxFile> entity <entities(selector)> [offset] [rotation] [scale] [delay] [force death] [allow multi] [auto rotation]

• entities: Required, entity selector

• auto rotation:

  • none (default): No rotation
  • forward: Forward direction
  • look: Head look direction
  • xrot: Body rotation direction

Example:

/photon fx photon:fire entity @e[type=minecraft:minecart, distance=..1] 0 0.5 0 0 0 0 1 1 1 0 false false look

---

❌ Remove FX Commands

Command Format	Example
/photon fx remove block <position(x y z)> [force] [location]	/photon fx remove block ~ ~ ~ true
/photon fx remove entity <entities(selector)> [force] [location]	/photon fx remove entity @e[type=pig]

• force: Remove all particles immediately if the object becomes invalid (true), or wait for natural death (false)
• location: Specify FX resource location (optional)

---

📋 Parameter Notes & Tips

• Position, rotation, and scale are always three numbers (x y z)
• FX file path is usually assets/<mod_id>/fx/your_fx_name.fx
• After changing any .fx file, always run /photon_client clear_fx_cache to refresh!

---

🌈 Advanced Usage Examples

Bind an effect to your feet

shell /photon fx photon:smoke block ~ ~-1 ~

Bind explosion FX to all pigs nearby

shell /photon fx photon:explosion entity @e[type=minecraft:pig, distance=..10]