Particle Trails
Cosmetic particle trails behind moving players.
Requires: Factorio 2.1. Optional: Space Age (planet trails), Jetpack (exhaust plume in flight), Cargo Ships (ship wake), Alien Biomes
Trails
- Flags (18): trans, transmasculine, pride, progress pride, bi, ace, lesbian, sapphic, pan, gay, nonbinary, genderfluid, genderqueer, aro, aroace, agender, intersex, demisexual. Each as a colour mix or striped (the flag's stripes as a ribbon).
- Solid colours (18): pink, blue, white, purple, yellow, orange, red, green, gray, black, brown, cyan, teal, magenta, gold, lavender, mint, navy, plus rainbow (cycles hues as you walk). Each as puffs or striped.
- Gradients (6): sunset, ocean, aurora, candy, forest, fire.
- Themes (19): lightning, flames, earth (matches the ground's colour), nature, ice, shadow, bubbles, snow, sakura, autumn, confetti, toxic, footprints, footprint path, smoke, gears, rose petals, wildflowers, feathers.
- Orbiting (8): star, hearts, glitter, fireflies, music, butterflies, dust motes, blue embers. These circle you while you stand still.
- Factorio (6): ore, uranium, circuits, science, biter blood, rocket exhaust.
- Space Age (4): Vulcanus, Gleba, Fulgora, Aquilo.
- Reactive (4):
- Comet: sparkles when walking, blazing ribbon at high speed or in vehicles.
- Heartbeat: more hearts as you take damage, then blood.
- Day and night: butterflies by day, fireflies by night.
- Wanderer: matches the ground (sand, grass, each planet's trail).
- Wanderer with other mods (none required):
- Jetpack: exhaust plume in flight. Ground-reading trails (earth, footprints, footprint path, Alien Biomes' grass and volcanic) pause while airborne.
- Ships: hull-width stern foam for any vehicle on water (Cargo Ships, submarines).
- Planet mods: own trails for Maraxsis, Cerys, Lignumis, Muluna; other planets use their tile colours.
- Painted floors: puffs in the paint colour (e.g. Dectorio painted concrete).
- Alien Biomes (2): alien grass, volcanic.
Settings
| Setting | Scope | Default | Effect |
|---|---|---|---|
| Particle trail | Per player | None | Your trail (also set by the picker). |
| Particle trail amount | Per player | 2 | Density: 1 = half, 4 = double. |
| Trail from vehicles | Per player | On | Keep the trail while driving. |
| Glowing trails | Per player | On | Allow trails to light the ground at night. |
| Show the trail picker button | Per player | On | Top-left button. Shortcut, Alt+T and /trail work regardless. |
| Circle you when standing still | Per player | On | Orbiting trails circle you when stopped. |
| Particle trail size | Startup | 1.0 | Particle scale, 0.5×–2×. |
For mod developers
Assign trails, register new ones or trigger bursts via the particle-trails remote interface. Pass a source name so multiple mods can assign trails independently; it also labels your mod in the picker's priority list.
-- show a trail for a player
remote.call("particle-trails", "start_trail", player_index, "trans", "my-mod")
-- remove your trail; the next trail in the priority list shows instead
remote.call("particle-trails", "stop_trail", player_index, "my-mod")
-- what is showing, and what your mod has assigned
remote.call("particle-trails", "get_active_trail", player_index)
remote.call("particle-trails", "get_assigned_trail", player_index, "my-mod")
-- every trail name
remote.call("particle-trails", "list_trails")
-- make your mod's trail thicker (above 1) or thinner (below 1),
-- without changing which trail shows
remote.call("particle-trails", "set_trail_scale", player_index, "my-mod", 1.5)
-- a one-off ring of a trail's particles, e.g. when something happens
remote.call("particle-trails", "burst", player_index, "trans", 60)
-- your own trail, from your own particle prototypes
remote.call("particle-trails", "register_trail", "my-trail", {
particles = { "my-particle-a", "my-particle-b" },
weights = { 3, 1 }, -- optional: how often each particle is picked
mode = "random", -- or "striped" for a ribbon, one lane per particle
title = "My trail", -- optional: the name shown in the trail picker
burst = 2, -- optional: particles per burst
})
Data stage: require("__particle-trails__.lib.particle").make_particle(name, filename, overrides) creates particles matching the built-in ones.
Made for Factorio 2.1. Licensed under GPL-3.0.
Contact: Discord (fastest) · Website