Particle Trails


Cosmetic player trails of various types.

Content
a day ago
2.0 - 2.1
272
Character

Changelog

Version: 0.10.1
Date: 2026-11-17
  Changes:
    - Hidden optional dependency on Krastorio 2, so this mod loads after it.
Version: 0.10.0
Date: 2026-11-12
  Features:
    - Tips and Tricks: the trail picker, the /trail and /trails commands, and
      the priority list.
    - Wanderer in the air: with Jetpack, the wanderer becomes an exhaust
      plume of flame and smoke while you fly, and goes back to the ground
      when you land.
    - Wanderer on water in a vehicle (Cargo Ships' ships, submarines, a car
      in the shallows): foam churned up at the stern, as wide as the hull.
    - Wanderer on more planets: Maraxsis (bubbles), Cerys (frost), Lignumis
      (falling leaves) and Muluna (grey regolith). Any other planet still
      follows the ground by the colour of its tiles.
    - Wanderer on painted floors, such as Dectorio's painted concrete: puffs
      in the paint's colour.
  Changes:
    - With Jetpack, the trails that read the ground (earth, footprints, the
      footprint path and Alien Biomes' grass and volcanic) stop while you
      fly. They used to kick up dirt and leave prints from the air.
    - Nothing here needs the other mods installed: Jetpack is only asked
      when it is there, and planets, floors and water are recognised by
      their names.
Version: 0.9.0
Date: 2026-11-11
  Features:
    - New flag trail: Transmasculine, as puffs and striped (pink, then pale to
      deeper blue at the centre).
    - New remote function set_trail_scale(player_index, source, scale): makes
      one mod's trail thicker (above 1) or thinner (below 1) without changing
      which trail shows or the priority order. Biochemistry uses it to
      thicken identity flags while the hormone is working.
Version: 0.8.0
Date: 2026-11-07
  Features:
    - Striped versions of the solid colours: a single-colour ribbon, as
      wide as the striped flags, in a new Striped colours section of the
      picker and in the trail setting.
    - Eight more solid colours, as puffs and striped: brown, cyan, teal,
      magenta, gold, lavender, mint and navy.
    - Rainbow and Rainbow (striped): one colour at a time, moving round the
      colour wheel as you walk.
    - Gradient ribbons: Sunset, Ocean, Aurora, Candy, Forest and Fire.
    - New themes: Butterflies, Rose petals, Wildflowers, Feathers, Dust
      motes, Blue embers, and Footprint path (footprints that stay on the
      ground for a minute and fade).
    - Factorio trails: Ore, Uranium (glows), Circuits, Science, Biter blood
      and Rocket exhaust. Biter blood uses the game's own blood particles.
    - Space Age trails: Vulcanus, Gleba, Fulgora and Aquilo.
    - Reactive trails: Comet (sparkles at a walk, a blazing ribbon when fast
      or driving), Heartbeat (more hearts and then blood as you're hurt),
      Day and night (butterflies by day, fireflies by night) and Wanderer
      (follows the ground, and each planet's own trail on it).
    - Standing still, the star, hearts, glitter, fireflies, music,
      butterflies, dust motes and blue embers trails circle round you, each
      its own way: a crown of stars that now and then fly off, a
      heartbeat of hearts, a swirl of glitter, wandering fireflies, a
      bouncing note, a butterfly flying a figure of eight, dust drifting at
      three heights and a rising spiral of embers. They have their own Orbiting section in the picker, and the
      new Circle you when standing still setting turns it off.
    - A priority list in the trail picker decides whose trail shows: your
      pick or a mod's (the Estrogen Mod's dose trail, say). Put any of them
      first; your pick counts even when it's No trail. By default mods still
      win, and a mod new to the list goes just above your pick.
      Each row shows whose it is, their trail, and whether it's showing,
      overridden or not in use.
    - The trail picker opens from a button in the top-left corner (shared
      with other mods' buttons; hide it in the mod settings), a shortcut bar
      button, or Alt+T (rebindable), as well as /trail. Both buttons show
      the mod's comet.
    - The notice that a mod's trail is showing names the mod.
  Changes:
    - No longer uses the Status Effect HUD: its Trail row and the "Show trail
      in the HUD" setting are gone.
    - Polished the trail picker: every trail button is the same size so all
      sections line up, evenly spaced sections, the scrollbar no longer
      covers the last column, and the flag sections are now at the bottom,
      after the solid colours and themes.
  Bugfixes:
    - The trail picker stays where you drag it, instead of jumping back to the
      middle of the screen every time you pick a trail or reopen it.
Version: 0.7.0
Date: 2026-11-03
  Features:
    - Alien Biomes support (optional dependency): the earth trail matches its
      ground too, with new purple, violet and rust tones for its purple,
      violet and red-grass terrain.
    - New themed trails: fireflies (blinking, they light up the dark), glitter,
      factory smoke and gears.
    - Two trails only offered with Alien Biomes: alien grass, tufts torn up in
      the colour of the alien vegetation you walk through, and volcanic, ash
      and embers glowing in the colour of the heat field underfoot. They get
      their own "Alien Biomes" section in the trail picker.
  Changes:
    - Flag trails now use each flag's real colours, in both the particle and
      the striped style. Fixed: the pride and progress pride rainbow, bi
      (looked like trans), trans, pan, genderfluid, nonbinary, ace,
      demisexual, intersex and aroace, genderqueer's green, the gay men's
      flag, which now has all seven stripes, and sapphic, whose pink bands
      are back to a third of the flag each with the violet in the middle.
    - The earth trail picks its colours by the tint of the ground rather than
      its darkness, so darker coloured ground no longer all comes out grey.
Version: 0.6.0
Date: 2026-11-03
  Features:
    - Every flag trail now also comes in a striped style, e.g. "Trans (striped)",
      that leaves the flag behind you as a ribbon of stripes, curving smoothly
      round every turn.
    - New flag trails: progress pride, sapphic and aroace.
    - New themed trails: hearts, bubbles (they float up and pop), snow, sakura,
      autumn, music, confetti, toxic sludge and footprints. Sakura drops
      whole cherry blossoms and loose notched petals.
    - The earth trail now takes its colours from the ground you walk on, mixed
      with a lighter or darker tone and drawn as outlined, shaded clods so it
      still stands out from that ground.
    - Redrawn flames, lightning, nature and ice trails in finer detail:
      flickering fire that burns down to embers, flickering bolts that throw
      sparks, leaves with little wildflowers, and ice shards that scatter and
      glitter on the ground so ice no longer looks like snow.
    - Trails follow you into cars, tanks, trains and spidertrons. Turn this off
      with the new "Trail from vehicles" setting.
    - Trails thicken as you move faster than a run, so they stay even with
      exoskeletons and in vehicles.
    - The flames, lightning, star and toxic trails light up the ground at night.
      Turn this off with the new "Glowing trails" setting.
    - New trail picker window. Open it with /trail, or by clicking the new
      Trail row in the Status Effect HUD (needs Status Effect HUD 0.6.0).
      It can also pick trails added by other mods.
    - Trail names in the settings dropdown are now readable, and trail
      descriptions and messages can be translated.
    - start_trail, stop_trail and get_assigned_trail take an optional source
      name so several mods can assign trails side by side. Calls without one
      work as before.
    - New burst(player_index, trail, count) remote function for a one-off ring
      of a trail's particles, e.g. when a dose is taken.
    - register_trail accepts weights (how often each particle is picked),
      mode = "striped", a title, and spread/lift spawn options.
    - New data-stage helper: require("__particle-trails__.lib.particle")
      .make_particle(name, filename, overrides) makes particles that match the
      built-in ones.
  Changes:
    - Per-player trail settings are cached instead of read on every burst.
    - When two mods assign you a trail at once, stopping one now falls back to
      the other instead of clearing both.
Version: 0.5.1
Date: 2026-11-03
  Changes:
    - The trail amount setting now scales each trail instead of replacing it.
      At the default of 2 every trail looks as designed, so the flames and
      lightning trails are thicker than before.
  Bugfixes:
    - Other mods couldn't register their own trails at all.
    - Trails registered by other mods are now saved, so they don't vanish on
      load or cause a desync when someone joins a multiplayer game.
    - /trail now saves your choice, so it isn't lost when you rejoin.
Version: 0.5.0
Date: 2026-09-18
  Changes:
    - Targets Factorio 2.1 (factorio_version 2.1, API 2.1.19); runtime and
      prototype usage re-verified against the 2.1 docs (no changes required)
    - Version floor release for the estrogen-mod 0.13.0 dependency
Version: 0.4.2
Date: 2026-09-09
  Features:
    - Added the gay trail (gay men's / Vincian flag: teal, light teal, white,
      light blue, royal blue puffs)
    - Added four new puff palette colours used by the gay trail:
      teal, light-teal, light-blue, royal-blue
  Notes:
    - Backward compatible: all remote API functions and existing trails unchanged
Version: 0.4.1
Date: 2026-09-09
  Features:
    - Added four more well-known queer identity flag trails:
      aro (aromantic: dark green/light green/white/gray/black),
      agender (black/gray/white/green), intersex (yellow/purple),
      and demisexual (black/gray/white/purple)
    - Added two new puff palette colours: black and dark-green
      (black is also available as its own solid colour trail)
  Notes:
    - Backward compatible: all remote API functions and existing trails unchanged
Version: 0.4.0
Date: 2026-09-09
  Features:
    - Added seven new thematic trails with unique particle shapes and behaviors:
      lightning (electric bolts), flames (rising fire), earth (dirt clumps),
      nature (drifting leaves & petals), ice (frost crystals),
      shadow (dark wisps), and star (cosmic sparkles)
    - New particle prototypes use optimized-particle type with custom
      life_time, movement_modifier, and vertical_acceleration per theme
    - Updated sprite generation tool to produce 8 distinct shape types
      (puff, bolt, flame, chunk, leaf, crystal, wisp, star)
  Features:
    - Added in-game commands for changing trails:
      /trails - list all available trails
      /trail <name> - set your trail (e.g. /trail lightning)
      /trail off - disable your trail
  Bugfixes:
    - Fixed loading an old save overwriting the player's trail preference.
      Main menu selection now always takes priority.
  Notes:
    - Fully backward compatible: all existing trails (trans, pride, bi, ace,
      lesbian, pan + 9 solid colours) and remote API functions unchanged
    - Version bump 0.3.x -> 0.4.0 is a minor feature release with no
      breaking changes; estrogen-mod's dependency constraint (>= 0.1.0)
      remains satisfied
Version: 0.3.2
Date: 2026-09-09
  Features:
    - Added get_assigned_trail to distinguish temporary mod assignments from player menu selections
Version: 0.3.1
Date: 2026-09-07
  Bugfixes:
    - Fixed on_tick crash "attempt to perform arithmetic on field 'spacing'": built-in trails now automatically receive the default spawn parameters (spacing, burst, min_move, back_offset), and register_trail coerces its numeric options
Version: 0.3.0
Date: 2026-09-07
  Features:
    - Added nine solid colour trails (pink, blue, white, purple, yellow, orange, red, green, gray), selectable in the same per-player "Particle trail" setting
  Bugfixes:
    - Fixed mod failing to load: per-player settings must use the Factorio 2.0 setting type "runtime-per-user" (the 1.1 name "runtime-per-player" was rejected)
Version: 0.2.0
Date: 2026-09-07
  Major Features:
    - The mod now works standalone: pick a trail per player in the mod settings ("Particle trail") and it kicks up while walking, no other mod required
  Features:
    - Added five new built-in trails: pride (rainbow), bi, ace, lesbian and pan, alongside the trans trail
    - New per-player setting "Particle trail amount" (1-4 puffs per burst) and startup setting "Particle trail size" (0.5x-2x scale, requires restart)
    - New remote API functions: list_trails() and register_trail(name, spec) so other mods can enumerate and add custom trails at runtime
    - start_trail now validates the trail name and returns whether it succeeded; a mod-assigned trail overrides the player's own selection and clears back to it on stop_trail
  Changes:
    - Trail particles are now shared per colour (particle-trails-puff-*) and generated from a 9-colour pastel palette
    - Players sitting in vehicles no longer kick up trails; storage cleans up when players leave
Version: 0.1.0
Date: 2026-09-07
  Features:
    - Initial release: Particle Trails framework for player movement particle trails, currently with the trans trail (pastel pink, blue and white puffs)
    - Remote API for other mods: remote.call("particle-trails", "start_trail", player_index, "trans"), stop_trail(player_index), get_active_trail(player_index)
    - Trail particles render behind the player character (lower-object-above-shadow) and kick up behind the feet relative to the movement direction