tekton/_daily_basis/walkthrough_2025-12-12.md

Game Mechanics Refactor - Walkthrough

Summary

Successfully refactored the game from a lap-based racing system to a cycle-based goals system with power-ups, scoring, and a live leaderboard.

---

Changes Made

New Files Created

File	Purpose
goals_cycle_manager.gd	60-sec timer, scoring (base+time bonus), goal regeneration, 9-tile randomization
powerup_manager.gd	Power-up points (4 bars max), holo tile tracking, special effect activation

Modified Files

File	Changes
player.gd	Added powerup_manager, score, use_powerup input, removed finish checks
playerboard_manager.gd	Holo tiles → powerup points, goal completion check
player_race_manager.gd	Deprecated lap system, kept pattern matching
main.gd	GoalsCycleManager init, UI setups, signal handlers
ui_manager.gd	Power-up bar, leaderboard panel, timer labels
project.godot	Added use_powerup input (F key)

---

New Game Flow

flowchart LR
    A[60s Cycle] --> B[Grab Tiles]
    B --> C{Holo?}
    C -->|Yes| D[+Powerup]
    C -->|No| E[Check Goal]
    E -->|Match| F[+Score +Powerup +Randomize 9 tiles]
    F --> G[New Goals]
    A --> H{Timer End}
    H --> I[Clear Board → Score Matching]

---

Manual Testing Required

1. Timer Test: Verify 60-sec countdown on goal panels
2. Goal Completion: Complete pattern → score + powerup + tile randomization
3. Holo Tiles: Pick 4 → 1 powerup bar (no auto effect)
4. F Key: Use powerup → triggers random special effect
5. Leaderboard: Updates dynamically with score rankings
6. Multiplayer Sync: Timer and scores sync across clients