tekki/nissefolk
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

Issue #6: F3 Debug View #11

Merged
tekki merged 4 commits from feature/debug-view into master 2026-03-21 14:07:07 +00:00
Conversation 2 Commits 4 Files Changed 8 +497 -2
claude commented 2026-03-21 12:12:45 +00:00
Collaborator
Copy Link

Closes #6

Was sich geändert hat

Neue Datei: DebugSystem.ts

  • Pathfinding-Visualisierung: cyan Linien + Ziel-Highlight in World Space (Depth 50)
  • Sammelt und liefert alle Debug-Daten per getDebugData(ptr): FPS, Maus-Weltkoords, Tile-Typ, Ressourcen/Gebäude/Crops auf dem Hovered-Tile, Nisse-Stats, Job-Stats
  • toggle() schaltet Linien-Grafik ein/aus

VillagerSystem.ts

  • getActivePaths() neu: liefert Position + Restpfad aller laufenden Nisse (für Pathfinding-Viz)
  • JSDoc auf allen bisher undokumentierten Methoden ergänzt

WorldSystem.ts

  • JSDoc auf allen Methoden ergänzt

GameScene.ts

  • DebugSystem registriert und in update() getickert
  • Event debugToggle → debugSystem.toggle()
  • JSDoc auf create(), update(), shutdown() ergänzt

UIScene.ts

  • F3 togglet Debug-Panel + emittiert debugToggle an GameScene
  • Debug-Panel: Text-Overlay links oben (unter Build/Farm-Indikatoren) mit allen Daten
  • [F3] Debug in der Controls-Hint ergänzt
  • JSDoc auf allen bisher undokumentierten Methoden ergänzt

Test

  • F3 drücken: Panel erscheint, Pfade werden als cyan Linien gezeichnet
  • Maus über verschiedene Tiles: Tile-Typ + Inhalte aktualisieren sich
  • Nisse laufen lassen: Pfade werden live nachgezogen
  • F3 erneut: alles verschwindet
Closes #6 ## Was sich geändert hat ### Neue Datei: `DebugSystem.ts` - Pathfinding-Visualisierung: cyan Linien + Ziel-Highlight in World Space (Depth 50) - Sammelt und liefert alle Debug-Daten per `getDebugData(ptr)`: FPS, Maus-Weltkoords, Tile-Typ, Ressourcen/Gebäude/Crops auf dem Hovered-Tile, Nisse-Stats, Job-Stats - `toggle()` schaltet Linien-Grafik ein/aus ### `VillagerSystem.ts` - `getActivePaths()` neu: liefert Position + Restpfad aller laufenden Nisse (für Pathfinding-Viz) - JSDoc auf allen bisher undokumentierten Methoden ergänzt ### `WorldSystem.ts` - JSDoc auf allen Methoden ergänzt ### `GameScene.ts` - `DebugSystem` registriert und in `update()` getickert - Event `debugToggle` → `debugSystem.toggle()` - JSDoc auf `create()`, `update()`, `shutdown()` ergänzt ### `UIScene.ts` - F3 togglet Debug-Panel + emittiert `debugToggle` an GameScene - Debug-Panel: Text-Overlay links oben (unter Build/Farm-Indikatoren) mit allen Daten - `[F3] Debug` in der Controls-Hint ergänzt - JSDoc auf allen bisher undokumentierten Methoden ergänzt ## Test - F3 drücken: Panel erscheint, Pfade werden als cyan Linien gezeichnet - Maus über verschiedene Tiles: Tile-Typ + Inhalte aktualisieren sich - Nisse laufen lassen: Pfade werden live nachgezogen - F3 erneut: alles verschwindet
claude added 22 commits 2026-03-21 12:12:45 +00:00
✨ zoom to mouse pointer + middle-click pan 715278ae78 
- Scroll wheel now zooms toward the mouse cursor instead of screen center
- Middle mouse button held: pan camera by dragging
- Both actions respect current zoom level
📝 update CHANGELOG for Issue #5 mouse handling fa41075c55
🐛 fix zoom-to-mouse using getWorldPoint diff instead of manual formula f0065a0cda
🐛 fix zoom: center world point under mouse, then zoom to center b5130169bd
🐛 zoom-to-mouse: use ptr.worldX/Y + set scroll after setZoom 216c70dbd9
♻️ revert zoom to simple center zoom, remove mouse targeting cccfd9ba73
🐛 debug: log mouse+center on zoom, draw red cross at viewport center 0e4c7c96ee
🐛 zoom-to-mouse: ptr.worldX/Y formula, debug log still active fb4abb7256
🐛 fix zoom-to-mouse: capture worldX/Y before setZoom d354a26a80
🐛 zoom-to-mouse: track world coords on pointermove, avoid ptr.worldX getter 6de4c1cbb9
🐛 fix debug cross: world-space position + counter-scale, tracks viewport center correctly 6fa3ae4465
🐛 fix debug cross: clear+redraw each frame at world-space center, no transforms 0011bc9877
♻️ revert zoom to center-only, keep middle-click pan 34220818b0
✨ add ZoomTestScene with Phaser default zoom for analysis 007d5b3fee 
Separate test environment at /test.html (own Vite entry, own Phaser
instance). ZoomTestScene renders a 50×50 tile grid with crosshair
markers and a live HUD overlay showing zoom, scroll, viewport in px
and tiles, mouse world/screen/tile coords, and renderer info.
Zoom uses plain cam.setZoom() — no mouse tracking — to observe
Phaser's default center-anchor behavior.
✨ add file logging via Vite middleware to ZoomTestScene 9b6341fe46 
Vite dev server gets a /api/log middleware (POST appends to
game-test.log, DELETE clears it). ZoomTestScene writes a zoom event
with before/after state on every scroll, plus a full snapshot every
2 seconds. Log entries are newline-delimited JSON.
🐛 fix HUD overlay zoom + add red center crosshair faa4deb0bf 
Text overlay now uses a dedicated HUD camera (zoom=1, fixed scroll)
so it's never scaled by the world zoom. World objects and HUD objects
are separated via camera ignore lists. Added red screen-center
crosshair to HUD layer as a precise alignment reference.
♻️ increase test world to 500×500 tiles, adjust marker intervals aefb67dba6
✨ add ZoomMouseScene with zoom-to-mouse correction fede13d64a 
Implements scroll correction after cam.setZoom() so the world point
under the mouse stays fixed. Formula accounts for Phaser's
center-based zoom: scrollX += (mouseX - cw/2) * (1/zBefore - 1/zAfter).
Tab switches between the two test scenes in both directions.
Also fixes centerWorld formula in ZoomTestScene overlay and logs.
✨ implement zoom-to-mouse in CameraSystem 0f411f0f34 
Replaces plain cam.setZoom() with zoom-to-mouse: after each zoom step
the scroll is corrected by (mouseOffset from center) * (1/zBefore - 1/zAfter),
keeping the world point under the cursor fixed. Also fixes getCenterWorld()
which previously divided by zoom incorrectly. Added JSDoc to all methods.
📝 update CHANGELOG for Issue #5 zoom-to-mouse 49fae62f27
✨ add F3 debug view (Issue #6) f6fc1d1e7c 
F3 toggles a debug overlay with:
- FPS
- Mouse world/tile coordinates
- Tile type under cursor
- Resources, buildings, crops on hovered tile
- Nisse count broken down by AI state (idle/walking/working/sleeping)
- Active jobs by type (chop/mine/farm)
- Pathfinding visualization: cyan lines + destination highlight
  drawn in world space via DebugSystem

Added DebugSystem to GameScene. VillagerSystem exposes
getActivePaths() for the path visualization. JSDoc added to all
previously undocumented methods in VillagerSystem, WorldSystem,
GameScene, and UIScene.
📝 update CHANGELOG for Issue #6 debug view 16852c42e7
claude added 2 commits 2026-03-21 12:37:53 +00:00
📝 update CHANGELOG for Issue #6 debug view 16852c42e7
🔒 ignore .claude/ dir and game-test.log 1feeff215d
claude added 1 commit 2026-03-21 13:58:20 +00:00
📝 add session-start warning to CLAUDE.md 01e57df6a6 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
tekki approved these changes 2026-03-21 14:04:54 +00:00
Dismissed
tekki approved these changes 2026-03-21 14:06:58 +00:00
tekki merged commit 0c636ed5ec into master 2026-03-21 14:07:07 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
tekki
Labels
Clear labels
bug
design
feature
improvement
question
status: backlog
status: done
status: in discussion
status: in progress
status: ready
status: review
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
claude tekki
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: tekki/nissefolk#11
No description provided.
Delete Branch "feature/debug-view"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?