55 lines
2.4 KiB
Markdown
55 lines
2.4 KiB
Markdown
# 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](file:///c:/Users/ADT/Documents/GodotProjects/tekton-enet/scripts/managers/goals_cycle_manager.gd) | 60-sec timer, scoring (base+time bonus), goal regeneration, 9-tile randomization |
|
|
| [powerup_manager.gd](file:///c:/Users/ADT/Documents/GodotProjects/tekton-enet/scripts/managers/powerup_manager.gd) | Power-up points (4 bars max), holo tile tracking, special effect activation |
|
|
|
|
### Modified Files
|
|
|
|
| File | Changes |
|
|
|------|---------|
|
|
| [player.gd](file:///c:/Users/ADT/Documents/GodotProjects/tekton-enet/scenes/player.gd) | Added `powerup_manager`, `score`, use_powerup input, removed finish checks |
|
|
| [playerboard_manager.gd](file:///c:/Users/ADT/Documents/GodotProjects/tekton-enet/scripts/managers/playerboard_manager.gd) | Holo tiles → powerup points, goal completion check |
|
|
| [player_race_manager.gd](file:///c:/Users/ADT/Documents/GodotProjects/tekton-enet/scripts/managers/player_race_manager.gd) | Deprecated lap system, kept pattern matching |
|
|
| [main.gd](file:///c:/Users/ADT/Documents/GodotProjects/tekton-enet/scenes/main.gd) | GoalsCycleManager init, UI setups, signal handlers |
|
|
| [ui_manager.gd](file:///c:/Users/ADT/Documents/GodotProjects/tekton-enet/scripts/managers/ui_manager.gd) | Power-up bar, leaderboard panel, timer labels |
|
|
| [project.godot](file:///c:/Users/ADT/Documents/GodotProjects/tekton-enet/project.godot) | Added `use_powerup` input (F key) |
|
|
|
|
---
|
|
|
|
## New Game Flow
|
|
|
|
```mermaid
|
|
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
|