Skip to content

feat(practice): always-on spline/particle guide trail for Practice Mode #174

@TheMeinerLP

Description

@TheMeinerLP

Description

SplineVisualizationSystem is promoted from a debug feature to a player-facing guide, automatically enabled during Practice Mode sessions. Lowest priority — safe to defer post-MVP.

Acceptance Criteria

  • `SplineVisualizationSystem` activates automatically when `GameMode.PRACTICE` is detected
  • Particle trail is visible to the practicing player only (not broadcast to other instances)
  • Visual parameters are tunable per map: particle density, color, lookahead distance threshold
  • Defaults are set for first-time-player readability (higher density than debug mode)
  • The system is disabled in `GameMode.RACE` sessions (no performance cost in competitive play)
  • Guide points must be authored in the setup plugin before the system has data to render
  • Unit/integration tests verify the system activates and deactivates with the correct game mode
  • No visual artifacts when a player retries (trail resets with the ring tracker)

Technical Details

  • Guide point authoring in the setup plugin is a prerequisite (tracked separately)
  • `SplineVisualizationSystem` remains in `server` module — no shared-module imports of Minestom
  • Visual parameters stored in MapDefinition or a sidecar config file (Gson-serialized)
  • System follows the ECS pattern: declares required components, processes matching entities each tick

Dependencies

Estimate

L

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestgameplayGameplay mechanicsplayer-feelGame feel, feedback timing, or player experience

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions