How to Spawn and Control Particles with TLib

TLib exposes particle spawning through simple method calls rather than builder chains, so you can fire off effects from a command, a block, or an item without writing a lot of boilerplate. The core idea is that you pick a particle type, a position, and optionally a velocity or direction, then call the spawn method.

Basic particle spawning

Start by identifying the particle you want (vanilla particles work, and TLib also lets mods register custom particle factories). Call the static/dynamic spawn helper with the world, the particle type, and the x/y/z coordinates. For a static particle you only need the position. For a dynamic one you also pass motion values so the particle drifts.

Shaped and directional particles

TLib supports shaped spawns (for example arranging particles along a line, circle, or area) and directional spawns where you supply a facing vector. Use the shaped helper when you want a ring or burst around a point, and the directional helper when you want a trail that follows a look vector. If you are triggering this from a command, read the player's position and rotation first, then feed those into the directional spawn so the effect points where the player is aiming.

Test in a flat area at night so the particles are easy to see, and adjust count and spread until the effect looks right.