Nethercore Debugging Skill

Nethercore Debugging

The debug system is built into the Nethercore player and works with all consoles.

F4 Debug Inspector

Press F4 during development to open the Debug Inspector. This is your primary debugging tool.

Features:

Live value editing (sliders, toggles, color pickers)
Read-only watches for monitoring
Grouped/collapsible organization
Frame control (pause, step, time scale)
Zero overhead in release builds

Quick Reference

| Function | Purpose | Call In | |----------|---------|---------| | debug_register_i32(name, ptr) | Editable integer | init() | | debug_register_f32(name, ptr) | Editable float | init() | | debug_register_bool(name, ptr) | Toggle checkbox | init() | | debug_register_vec3(name, ptr) | 3D position | init() | | debug_register_color(name, ptr) | RGBA picker | init() | | debug_watch_*(name, ptr) | Read-only display | init() | | debug_group_begin/end(name) | Collapsible sections | init() |

Range-Constrained (Sliders)

debug_register_f32_range(b"Speed".as_ptr(), 5, &SPEED, 0.0, 20.0);
debug_register_i32_range(b"Lives".as_ptr(), 5, &LIVES, 0, 10);

Keyboard Shortcuts

| Key | Action | |-----|--------| | F4 | Toggle Debug Inspector | | F3 | Toggle Runtime Stats | | F5 | Pause/Resume | | F6 | Step one frame (when paused) | | F7/F8 | Decrease/Increase time scale |

Frame Control

fn update() {
    if debug_is_paused() != 0 { return; }
    let dt = delta_time() * debug_get_time_scale();
    // ...
}

Typical Setup

static mut PLAYER_X: f32 = 0.0;
static mut GRAVITY: f32 = 9.8;
static mut GOD_MODE: u8 = 0;

fn init() {
    unsafe {
        debug_group_begin(b"Player".as_ptr(), 6);
        debug_watch_f32(b"X".as_ptr(), 1, &PLAYER_X);
        debug_register_f32_range(b"Gravity".as_ptr(), 7, &GRAVITY, 1.0, 50.0);
        debug_register_bool(b"God Mode".as_ptr(), 8, &GOD_MODE);
        debug_group_end();
    }
}

When to Use What

| Scenario | Tool | |----------|------| | Live parameter tuning | Debug Inspector (F4) | | Tracking state over time | log() in update() | | Regression testing | Replay system | | Finding exact frame of bug | F5 pause + F6 step |

Agent Skills: Nethercore Debugging

Install this agent skill to your local

Skill Files