Particle Trails


Cosmetic player trails of various types.

Content
a day ago
2.0 - 2.1
272
Character
Owner:
Laine_iwa
Source:
N/A
Homepage:
https://laine.page.gd
License:
GNU GPLv3
Created:
2 months ago
Latest Version:
0.10.1 (a day ago)
Factorio version:
2.0 - 2.1
Downloaded by:
272 users

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