> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_housing/features/debug-console.md).

# Debug Console

`/housing_console` opens a three-lane debug console for diagnosing live issues without restarting the resource.

{% hint style="warning" %}
The debug console is **disabled by default**. Enable it in [main config](/paid-resources/rcore_housing/configuration/config.md) only on test servers - it exposes internal log streams to anyone allowed to open it.
{% endhint %}

## 🔌 Enable

```lua
Config.DebugConsole = {
    Enabled           = false,
    AllowedIdentifiers = {
        -- 'license:...',
    },
    FlushIntervalMs = 100,
    BatchSize       = 25,
    RingBufferSize  = 2000,
}
```

| Option               | Description                                                                                   |
| -------------------- | --------------------------------------------------------------------------------------------- |
| `Enabled`            | Master switch.                                                                                |
| `AllowedIdentifiers` | License/Steam identifiers allowed to open the console. Empty list = ACE `housing.debug` only. |
| `FlushIntervalMs`    | How often (ms) the server flushes new log entries to clients.                                 |
| `BatchSize`          | Max log entries per network batch.                                                            |
| `RingBufferSize`     | Max in-memory ring-buffer entries per lane.                                                   |

## 🧪 React / NUI Logging

`Config.DebugFrontend = true` turns on structured logging from the React UI - button clicks, `fetchNui` calls, action handlers. Use this when chasing "the button does nothing" reports without rebuilding the JS bundle.

## 🧰 Lanes

The console shows three independent log lanes:

| Lane       | Purpose                                              |
| ---------- | ---------------------------------------------------- |
| **Server** | Server-side debug streams.                           |
| **Client** | Client-side debug streams (current player).          |
| **NUI**    | React/NUI debug streams from `Config.DebugFrontend`. |

Each lane has its own filter, pause, and ring buffer.

## 🔑 ACE Permission

Add this line to your ACE config to grant console access by group:

```cfg
add_ace group.admin housing.debug allow
```

Players with `housing.debug` can open the console even when they're not in `AllowedIdentifiers`.