# Nethercore Systems Nethercore AI Plugins Debugging

> Nethercore Debugging

- Skill: `tomevault-io/nethercore-systems-nethercore-ai-plugins-debugging` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/nethercore-systems-nethercore-ai-plugins-debugging`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/nethercore-systems-nethercore-ai-plugins-debugging/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/nethercore-systems-nethercore-ai-plugins-debugging

---


# 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)

```rust
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

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

## Typical Setup

```rust
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 |

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nethercore-systems) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->