# FAQ

## The stone

### How do I get a Whisperstone?

Every player gets one on their first join. You can also craft one at the Workbench from 3 `Ingredient_Crystal_Blue`, 2 `Ingredient_Bar_Copper` and 4 `Ingredient_Fibre`, or an admin gives you one with `/kswhisper give <player>`. See [Getting Started](./getting-started#getting-a-stone).

### I lost my stone. Do I lose my messages?

No. Messages, companions and settings belong to the player, not to the item. A new stone shows the same things, and `/kswhisper` opens the stone without the item, unless the server set `commandNeedsItem` to `true`.

### I did not get a stone on my first join

- Your inventory was full. You get it the next time you join or change worlds.
- You already carried a stone. Nobody gets a second one this way.
- The server switched `giveOnFirstJoin` off.

### Does a call end when I close the stone?

No. A running farcall keeps going when the stone is closed, and the call card at the lower right shows it. Open the stone again to mute or hang up.

## Companions and messages

### Why can I not write to or call a player?

Messages, farcalls and shared positions only work between companions. Send a request under **Companions** → **Find companions** and wait until the other player accepts it.

### The player I want does not show up in the search

- The search only lists players who are online right now.
- Players you blocked, or who blocked you, do not show up.
- The search matches the start of the name.

### My request says "Player not found."

The player went offline, or they do not take requests from you. Try again when they are online.

### What happens to messages while my companion is offline?

They wait in the stone. When your companion logs in, they get a hint such as `3 new messages waited for you.` In your list, an offline companion shows `Last seen … · The raven waits until <name> is back`.

### How long are messages kept?

30 days, and at most 200 per conversation. Notices from other mods are kept for 7 days, at most 50 per player. Admins can change this in [Configuration](./configuration#messages).

### What does blocking do?

It ends the companionship, open requests in both directions, a running call and the positions you shared with each other. The blocked player cannot find you in the search, and their requests say `Player not found.` The conversation is hidden for you and comes back if you unblock them under **Stone** → **Blocked**. Unblocking does not make you companions again.

## Farcalls

### Why is there no Farcall rune?

- The server has no voice module, or voice is switched off on the server. The log then says `No voice module on this server, calls are off` (for a missing module).
- Your permission `ks.whisperstone.user.call` is denied.

### Does a call work across worlds?

Yes. Your companion only has to be online. The voice has the same volume at any distance.

### Do the players around me hear my call?

No. During a call only your companion hears you. You still hear the people around you.

### My companion cannot hear me

- You clicked **Mute**. The line then says `Your microphone is muted`.
- You are dead. Nobody hears you in a call then.
- You have a voice ban in VoiceHub. It also keeps you silent in calls.

### A companion "is not taking calls right now"

The other player switched off **Accept farcalls**, has **Silence** on, or may not make calls.

### Does the call work with VoiceHub?

Yes. A call goes before a VoiceHub channel: while you are in a call, only your companion hears you, even inside a channel or a moderated channel where you may not speak. A VoiceHub voice ban still counts. See [VoiceHub](https://wiki.kyuubisoft.com/hytale/voicehub/).

## Star Map

### My companion is not on my world map

- Markers only show companions in your own world.
- You and your companion both need **Visible on the map** switched on.
- Your permission `ks.whisperstone.user.map` is denied.

### My companion only shows "Here in this world" without a distance

They switched off **Visible on the map**. Then nobody sees their distance and direction.

### How long does a shared position stay?

30 minutes. **×** in the Star Map removes it earlier.

## Runes

### A rune is missing

- Its mod is not installed or not running.
- Your permission for that mod's command is denied. See [Permissions](./permissions#runes-of-other-mods).
- More than 18 runes: two pages hold 18 tiles. The server log names the runes that did not fit.
- An entry in `runes.json` has a bad or reserved `id` or no `command`. The log says `Ignored rune in runes.json`.

### "This rune cannot be opened right now."

The command of the rune is not registered on the server. The server log names the command. Fix the `command` in `runes.json` and run `/kswhisper reload`.

### The Voice Channels rune is missing after an update

Whisperstone adds new runes to an older `runes.json` once. If your file already has the newest `runesVersion` and you removed the rune earlier, it stays removed. Add it back by hand; the entry is on the [Configuration](./configuration#default-runes) page.

### How do I add my own rune?

Add an entry to `runes.json` and run `/kswhisper reload`. See [Adding your own rune](./configuration#adding-your-own-rune). Mods can also add runes with the [API](./api#registerrune).

## Hints at the screen edge

### I do not see any hints

- **Hints at the screen edge** is off, or **Silence** is on, in the stone's settings.
- A window is open. The game hides the cards while any window is open; the hints wait until you close it.
- With KyuubiSoft Core installed, the cards also hide while the world map is open.

### The call card covers my quest tracker

A very long quest tracker can reach the ring and call cards at the lower right. The cards then lie on top of it.

## Admins

### How do I test everything alone?

`/kswhisper demo` adds the test companion **Aldric (Test)** for you. He answers your messages, shares a position and sends a notice. `/kswhisper demo ring` makes him call you, and accepting plays your own voice back to you. See [Commands](./commands#kswhisper-demo).

### Does Whisperstone need KyuubiSoft Core?

No. With Core installed, the stone shows real player heads in conversations and on the call screens, and hides its cards while the world map is open.

### Where is the data stored?

In `mods/kyuubisoft_whisperstone/whisperstone.db`, an SQLite file. See [Configuration](./configuration#database).