> For the complete documentation index, see [llms.txt](https://kazescripts.gitbook.io/kazescripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kazescripts.gitbook.io/kazescripts/kaze_sound/commands-and-debugging.md).

# Commands and debugging

Player commands, test commands and debug tools.

## Player commands

| Command                         | Description                                                                                                          |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `/soundvolume <0-100>`          | Sets your own kaze\_sound music and sound volume. Saved between sessions. Without a number, shows the current value. |
| `/vol <0-100>`                  | Sets your radio and phone call volume. Saved between sessions.                                                       |
| `/setvoiceintent speech\|music` | Microphone mode. `speech` has noise suppression; `music` sends raw audio.                                            |

## Voice keys

| Key                     | Action              |
| ----------------------- | ------------------- |
| `` ` `` (key under Esc) | Change voice range. |
| `Left Alt` (hold)       | Talk on the radio.  |

## Admin commands

| Command                   | Description                                                                                                     |
| ------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `/muteply <id> [seconds]` | Mutes a player for everyone. Runs again to unmute. Default length 900 seconds. Needs the `command.muteply` ace. |

```cfg
add_ace group.admin command.muteply allow
```

## Test commands

Available only with `Config.Debug = true`.

| Command                       | Description                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------- |
| `/ksound_orbit [url]`         | A sound circles you at 6 m, one lap every 8 s. The clearest surround test.      |
| `/ksound_here [preset] [url]` | A looping sound at your position, for example `/ksound_here club`.              |
| `/ksound_room <preset>`       | Switches the test sound's room preset live.                                     |
| `/ksound_car [url]`           | Turns your current or last vehicle into a radio.                                |
| `/ksound_2d [url]`            | A plain 2D sound.                                                               |
| `/ksound_sync [url]`          | A server-synced sound at your position. Needs the `Config.AdminAce` permission. |
| `/ksound_stop`                | Stops every sound.                                                              |

Without a URL, the commands use the built-in test beat.

To allow admins to use `/ksound_sync`, add this to `server.cfg`:

```cfg
add_ace group.admin command.ksound allow
```

## Debug overlay

With debug on, a label floats above every sound in range:

| Label part            | Meaning                                                                       |
| --------------------- | ----------------------------------------------------------------------------- |
| id                    | The sound id.                                                                 |
| distance              | Metres from your camera.                                                      |
| `clear` / `wall`      | Whether the wall check found something in the way.                            |
| `3d` / `2d` / `basic` | Playback mode. See [Audio sources](/kazescripts/kaze_sound/audio-sources.md). |
| preset                | The room preset in use.                                                       |

The F8 console prints a warning when a positioned sound falls back to basic mode, and prints the reason when a file fails to load. Voice chat prints its connection and radio activity with the `[kaze_voice]` prefix.

## Engine log

With debug on, the audio engine logs each sound's create, play, seek and end to the NUI devtools console. Include those lines when you ask for support.

{% hint style="warning" %}
Turn `Config.Debug` off on a live server. The overlay draws every frame.
{% endhint %}