Skip to main content

Debug UI

The debug UI uses Iris (immediate-mode GUI) and is toggled with F3. It auto-enables in sandbox mode.

Tabs​

Overview​

  • Current day/night mode
  • Chunk count and pacing info
  • Trail marker, phase, difficulty multiplier
  • Quick player stats

Chunks​

  • Per-chunk info (index, pacing phase, trail marker)
  • Phase legend with color coding
  • Chunk generation queue status

Lighting​

  • Progressive tier display with daylight percentages
  • Mode prediction for upcoming chunks
  • Manual day/night toggle buttons

Flags​

  • Toggle all feature flags and debug flags at runtime
  • Checkboxes for each flag atom

Performance​

  • FPS counter
  • Memory usage
  • Cache statistics

Foliage/Decore​

  • Decore visibility toggle
  • Scan & Cull Overlapping Trees button — scans Forest folder and removes trees on baseplates
  • Get Bounds and Trees button — visual detection with BoxHandleAdornments
  • Forest generation debug logs toggle

Enemies (DevTools)​

  • Spawn enemies at player position or click location
  • PathMonster sweep trigger
  • Watcher boss spawn
  • Lost Quirkymal / Mimic spawn
  • Enemy list grouped by chunk with spawn summaries

Movement (DevTools)​

  • Teleport to specific chunk index
  • Coordinate teleport
  • Noclip fly mode (BodyVelocity + BodyGyro)
  • Walk speed override

World (DevTools)​

  • Force day/night
  • Danger zone visualization
  • Path node debug markers (dark purple Quirkymal clones)
  • Chunk bounds visualization
  • Chunk unloading controls
  • Echo marker spawning

Player (DevTools)​

  • God mode toggle
  • Health controls (set, damage, heal)
  • Force death / respawn
  • Collision toggle

LOD (DevTools)​

  • Manual LOD override slider (0-3)
  • Distance threshold adjustment
  • Server spawn LOD control

Path Diagnostics​

The debug controller includes path analysis:

  • Crossings: Where path nodes cross each other
  • Jumps: Large gaps between consecutive nodes
  • Reversals: Direction changes in the path

Output via "Dump Path Diagnostics to Output" button.

Chunk Bounds Detection​

Uses Separating Axis Theorem (SAT) to detect overlapping chunk baseplates, visualized with colored BoxHandleAdornments.