# Commands

Whisperstone has one command, `/kswhisper`. It has no aliases. Everything players do happens in the window; the subcommands are for admins.

## Overview

| Command | What it does | Permission | Console |
|---------|--------------|------------|---------|
| `/kswhisper` | Opens your Whisperstone | `ks.whisperstone.user.use` (allowed by default) | No |
| `/kswhisper give <player>` | Gives a player a Whisperstone | `ks.whisperstone.admin` | Yes |
| `/kswhisper reload` | Reloads config, runes and texts | `ks.whisperstone.admin` | Yes |
| `/kswhisper demo` | Adds a test companion for you alone | `ks.whisperstone.admin` | No |
| `/kswhisper demo ring` | Your test companion calls you | `ks.whisperstone.admin` | No |
| `/kslang` | Shows or sets your language for all KyuubiSoft mods | none | No |

See [Permissions](./permissions) for what the nodes cover.

## /kswhisper

Opens the stone, the same as right-clicking the item. If you are in a call or someone is calling you, the stone opens on the call screen.

| Reply | Why |
|-------|-----|
| `You may not use the Whisperstone.` | `ks.whisperstone.user.use` is denied for you. |
| `You need a Whisperstone in your inventory for this.` | `commandNeedsItem` is `true` in `config.json` and you carry no stone. |

## /kswhisper give &lt;player&gt;

Puts a Whisperstone into the inventory of a player who is online. A player who already carries a stone gets no second one.

| Reply | Meaning |
|-------|---------|
| `<name> received a Whisperstone.` | Done. |
| `<name> already has a Whisperstone.` | Nothing was given. |
| `The inventory of <name> is full.` | Nothing was given. |
| `The Whisperstone could not be given to <name>.` | Something went wrong, see the server log. |
| `This player is not in a world right now.` | The player is between worlds at the moment, for example while loading. |

From the console the replies are in English.

## /kswhisper reload

Reloads `config.json`, `runes.json` and the language files. Running calls and hints keep going. The reply is `Whisperstone: config, runes and texts reloaded.`

`presenceTickMillis` is the only value that needs a server restart. See [Configuration](./configuration).

## /kswhisper demo

Adds the test companion **Aldric (Test)** to your companions, just for you, so you can try every screen alone. The reply is `Aldric (Test) is now your companion, just for you. Try /kswhisper demo ring.`

Aldric then:

- sends a greeting and shares a position about 142 blocks to the northeast of you,
- sends a sample Marketplace notice (`Iron Sword sold · +120 Gold`),
- answers each of your messages after 2 seconds, with four lines in turn,
- answers your call after 3 seconds.

He never appears in the player search, so nobody else can find him. He stays your companion after a restart until you remove him in the **Companions** list. Running `demo` again adds the greeting, the position and the notice once more.

## /kswhisper demo ring

Aldric calls you. The reply is `Aldric (Test) is calling you.` When you accept, you hear your own voice, as a voice test.

If he cannot call, the reply is `First run /kswhisper demo, and end any running call.`

With Aldric as a companion, the call screens also work on a server without voice, so you can look at them anyway.

## /kslang

Whisperstone shares the language choice of all KyuubiSoft mods. If no other KyuubiSoft mod registered `/kslang`, Whisperstone does.

| Command | What it does |
|---------|--------------|
| `/kslang` | Shows your current language, the available codes and how to change it |
| `/kslang <code>` | Sets your language, for example `/kslang de-DE` |
| `/kslang auto` | Follows your game language again |

If the server sets one language for everyone, `/kslang <code>` says so and changes nothing.