> For the complete documentation index, see [llms.txt](https://laot7490.gitbook.io/ltbridge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://laot7490.gitbook.io/ltbridge/utilities/debug.md).

# Debug

## Debug

Toggle colored debug prints during development. Use instead of raw `print()` in modules for consistent formatting.

### Functions

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Detailed</strong></td><td>Prints a formatted and detailed (with file and line info) debug message.</td><td><a href="#detailed">#detailed</a></td></tr><tr><td><strong>Error</strong></td><td>Send a error debug message.</td><td><a href="#error">#error</a></td></tr><tr><td><strong>Info</strong></td><td>Send a info debug message.</td><td><a href="#info">#info</a></td></tr><tr><td><strong>Print</strong></td><td>Prints a formatted debug message.</td><td><a href="#print">#print</a></td></tr><tr><td><strong>SetMode</strong></td><td>Set debug mode.</td><td><a href="#setmode">#setmode</a></td></tr><tr><td><strong>Success</strong></td><td>Send a success debug message.</td><td><a href="#success">#success</a></td></tr><tr><td><strong>Verbose</strong></td><td>Send a verbose debug message.</td><td><a href="#verbose">#verbose</a></td></tr><tr><td><strong>Warn</strong></td><td>Send a warning debug message.</td><td><a href="#warn">#warn</a></td></tr></tbody></table>

***

## Detailed

Prints a formatted and detailed (with file and line info) debug message.

{% hint style="info" %}
**Side:** Shared · **Category:** Debug · **API:** `LT.Debug.Detailed`
{% endhint %}

### Example

```lua
LT.Debug.Detailed('Hello!', 'type')
```

### Parameters

| Name      | Required | Description       |
| --------- | -------- | ----------------- |
| `message` | Yes      | Message to print. |
| `type`    | No       | 'info'            |

***

## Error

Send a error debug message.

{% hint style="info" %}
**Side:** Shared · **Category:** Debug · **API:** `LT.Debug.Error`
{% endhint %}

### Example

```lua
LT.Debug.Error('Hello!')
```

### Parameters

| Name      | Required | Description       |
| --------- | -------- | ----------------- |
| `message` | Yes      | Message to print. |

***

## Info

Send a info debug message.

{% hint style="info" %}
**Side:** Shared · **Category:** Debug · **API:** `LT.Debug.Info`
{% endhint %}

### Example

```lua
LT.Debug.Info('Hello!')
```

### Parameters

| Name      | Required | Description       |
| --------- | -------- | ----------------- |
| `message` | Yes      | Message to print. |

***

## Print

Prints a formatted debug message.

{% hint style="info" %}
**Side:** Shared · **Category:** Debug · **API:** `LT.Debug.Print`
{% endhint %}

### Example

```lua
LT.Debug.Print('Hello!', 'type')
```

### Parameters

| Name      | Required | Description       |
| --------- | -------- | ----------------- |
| `message` | Yes      | Message to print. |
| `type`    | No       | 'info'            |

***

## SetMode

Set the minimum debug level. Default is `1` (errors only).

{% hint style="info" %}
**Side:** Shared · **Category:** Debug · **API:** `LT.Debug.SetMode`
{% endhint %}

### Mode levels

| Level | Name     | Shows                           |
| ----- | -------- | ------------------------------- |
| `0`   | Disabled | Nothing                         |
| `1`   | Errors   | Errors only (default)           |
| `2`   | Warnings | Errors + warnings               |
| `3`   | Info     | Errors, warnings, info, success |
| `4`   | All      | Everything including verbose    |

### Example

```lua
LT.Debug.SetMode(3)
```

### Parameters

| Name   | Required | Description            |
| ------ | -------- | ---------------------- |
| `mode` | No       | Level 0–4 (default: 1) |

***

## Success

Send a success debug message.

{% hint style="info" %}
**Side:** Shared · **Category:** Debug · **API:** `LT.Debug.Success`
{% endhint %}

### Example

```lua
LT.Debug.Success('Hello!')
```

### Parameters

| Name      | Required | Description       |
| --------- | -------- | ----------------- |
| `message` | Yes      | Message to print. |

***

## Verbose

Send a verbose debug message.

{% hint style="info" %}
**Side:** Shared · **Category:** Debug · **API:** `LT.Debug.Verbose`
{% endhint %}

### Example

```lua
LT.Debug.Verbose('Hello!')
```

### Parameters

| Name      | Required | Description       |
| --------- | -------- | ----------------- |
| `message` | Yes      | Message to print. |

***

## Warn

Send a warning debug message.

{% hint style="info" %}
**Side:** Shared · **Category:** Debug · **API:** `LT.Debug.Warn`
{% endhint %}

### Example

```lua
LT.Debug.Warn('Hello!')
```

### Parameters

| Name      | Required | Description       |
| --------- | -------- | ----------------- |
| `message` | Yes      | Message to print. |
