tekton/_daily_basis/task_2025-12-12.md

Game Mechanics Refactor Task

Summary

Refactor game mechanics to replace the lap-based racing system with a cycle-based goals system, add power-up points, live leaderboard, and enhanced special tiles handling.

Tasks

Phase 1: Core System Changes

• Create GoalsCycleManager (new manager for 60-second goal cycles with timer)
• Modify player_race_manager.gd to remove lap/finish logic
• Remove can_finish, finish_race, start_new_lap logic from player
• Add score tracking system to player

Phase 2: Power-up System

• Create PowerUpManager (new manager for power-up points)
• Modify special_tiles_manager.gd to track holo tile pickups (4 = 1 bar)
• Change holo tiles to give power-up points instead of auto-triggering effects
• [/] Add hotkey for using special effect (project.godot input action)

Phase 3: Goal Completion Logic

• Implement goal completion detection → award 1 power-up point
• Implement score calculation (early completion = more points)
• Implement 9-tile randomization around player on goal complete
• Implement timer end logic: clear playerboard, convert matches to score

Phase 4: UI Components

• Add timer display to each player's goals panel in AllPlayerGoals
• Create power-up bar UI (battery-style, 4 bars max)
• Create live leaderboard UI on right side of main.tscn
• Wire up leaderboard to update dynamically based on scores

Phase 5: Input Mapping & Cleanup

• Add use_powerup input action to project.godot
• Remove/deprecate lap-related code paths
• Test multiplayer synchronization of new systems