Changelog

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