# FAQ

**Version:** 1.0.0

## Guilds and members

### Can I be in two guilds?

No. A player is in at most one guild. To join another one, leave yours first.

### Why can't I invite anyone?

- Your rank needs the right **Invite members** (Member and up by default).
- The guild may be full. The number of slots comes from the guild level (10 at level 1).
- The player may already be in a guild.
- The player must have been on the server at least once since Guilds was installed; otherwise "Player not found" comes back.

### My invitation expired

Invitations are valid for 10 minutes (`general.inviteMinutes`, up to 1440). Invite again; inviting the same player while the old invitation is still open only renews it. Players who are offline see open invitations when they log in, and with KyuubiSoft Whisperstone they also get a message on their whisper stone.

### How do I leave as the leader?

Hand over the leadership first (**Hand over the lead**, or `/ksguild transfer <member> confirm`); you become Officer and can then leave. A leader who is alone in the guild disbands it instead.

### What happens when a member leaves or is removed?

- Their private locks stay theirs.
- Guild locks stay with the guild, also the ones they set.
- The experience they earned stays with the guild.
- With KyuubiSoft Claims, claims of theirs that were guild land stop being guild land.
- With KyuubiSoft VoiceHub, they are moved out of the guild voice channel.

If they join again later, the 24-hour wait for experience starts again. Their daily limit for taking items out of the storage is not reset by leaving and joining.

### What happens when a guild is disbanded?

Only the leader can disband (or an admin in the admin window).

- **The storage must be empty**, and nobody may have it open. An admin can disband anyway; the storage then goes to `lager/archive/<guild id>.json` in the data folder.
- **All guild locks become private locks of the last leader.** Nothing suddenly stands open.
- **Guild land** goes back to the owners of the claims as normal land.
- **The guild voice channel** of VoiceHub is removed.
- **Every member** gets a notice, offline members at their next login.

---

## Locks

### What can be locked?

Containers (chests, barrels, cupboards, crates and other blocks that hold items) and doors and gates, double doors included. The admin can switch containers or doors off. Look at the block within 10 blocks and type `/ksguild lock`. Other blocks answer "... cannot be locked. Containers and doors can."

### Can I lock a chest that someone else placed?

Not if the game knows who set it down. Then only that player can lock it, plus admins and guild members with the right **Change and remove other members' guild locks** when that player is in the same guild. Chests that came with the world, and doors, have no known owner; anyone who finds them unlocked can lock them.

With KyuubiSoft Claims 2.0, you can only lock blocks inside a claim if you may use them there.

### What does a lock protect against?

| | Protected |
|---|---|
| Opening, using and carrying the block | Yes, except for players with access |
| Breaking and damaging it | Yes, except for those allowed to break it |
| Creatures | Yes, always |
| Explosions | Yes (`locks.explosions`) |
| The block it stands on | Yes (`locks.surroundings`) |
| A second chest or door of the same kind right next to it | Refused for strangers (`locks.surroundings`) |
| Workbenches that would take material from it | Refused for strangers (`locks.benchesAskLock`) |
| Fire that spreads by itself | **No.** It can still burn wooden chests and doors, and the contents fall out |

### Who may open, change and break a lock?

| | Private lock | Guild lock |
|---|---|---|
| Open | The owner and the players added to it | Members from the lock's rank, and the players added to it |
| Change or remove | The owner | Whoever set it (while still in the guild) and members with **Change and remove other members' guild locks** |
| Break the block | The owner | Whoever set it (while still in the guild), Officers and the Leader |

`ks.guilds.admin` may change, remove and break every lock. `ks.guilds.admin.bypass` opens every lock. See [Permissions](./permissions).

### How many locks can we have?

Guild locks depend on the guild level: 50 at level 1, up to 300 at level 9 and 10. Each player can have 50 private locks. A double chest or a double door counts once. The **Locks** tab shows both counts.

### What happens to a lock when I make the chest bigger or break it?

When an allowed player turns a locked chest into a double chest, the lock moves to the double chest; when one half is broken again, it moves back to the remaining chest. When the locked block is broken by someone allowed to, the lock is removed. A lock whose block disappeared in another way (for example burned) is cleaned up by itself.

### Do locks run out?

Not by default. With `locks.expiryDays` above 0, a private lock falls away when its owner has not been on the server for that many days, and a guild lock when the guild has been inactive that long. The check runs once an hour. Admins see long-unused locks under **Abandoned** in the admin window (more than 60 days).

### Can I lock new chests automatically?

Yes: `/ksguild autolock private` or `/ksguild autolock guild`, or the switch on the **Settings** tab. Guild locks made this way open from rank Member. The admin can switch automatic locking off for the server.

---

## Levels and experience

### How is experience earned?

Members earn experience for their guild:

| Source | Default |
|--------|--------:|
| A creature the world spawned | 2 |
| A boss from the boss list | 50 |
| An ore block nobody placed | 1 |
| A finished quest (KyuubiSoft Quests) | 25 |
| An unlocked achievement (KyuubiSoft Achievements) | 40 |
| 10 minutes of play with movement | 5 |

Arrows count for the shooter, and a pet's hit that the pet mod books on its owner counts for the owner. Creatures from spawn eggs, commands or other mods do not count, and neither do tamed animals, pets and NPCs of KyuubiSoft mods. Standing still earns no play time.

### How is experience capped?

- **Daily limit:** each member adds at most 500 experience a day. The day starts at 00:00 server time. The **Level** tab shows how much you added today.
- **New members:** experience only counts after 24 hours in the guild.
- **Farm brake:** after 20 creatures (or 60 ore blocks) within 8 blocks and 2 minutes, only every 4th one still counts. Bosses are never slowed down.
- **Placed ores:** ore blocks a player placed earn nothing when mined.

All values can be changed, see [Configuration](./configuration#experience).

### Why does the guild not level up although the experience bar is full?

From level 3, a level also needs building materials. The **Level** tab says "Experience for level N reached – build material is still missing". Members hand in the materials with **Hand in from inventory** or `/ksguild contribute`; only what is still missing is taken. The level comes as soon as experience and material are both complete.

### Can a guild lose a level?

No. A guild never loses a level by itself. Admins can set any level in the admin window; the build-up for the next level then starts fresh.

### What do the levels unlock?

More member slots, storage pages and guild locks; the guild home at level 2 and a second one at level 7; the Veteran rank at level 6; colours and crest symbols at levels 2 to 5; a silver crest frame at level 8, a gold one at level 9; and the hall of fame at level 10. The full table is on [Configuration](./configuration#the-level-table).

### What if the admin switches the level system off?

Every guild then gets fixed limits (30 members, 200 guild locks, 3 storage pages, 1 guild home), all colours and crests and the Veteran rank. Material can no longer be handed in. The level table stays saved.

---

## Storage and home

### Someone else has the storage page open

Only one person at a time can change a storage page. You can look meanwhile; the page frees up when that person closes the window, switches the page, changes the world or leaves. Other pages stay usable.

### I cannot take anything out of the storage

- Your rank needs **Take items from the guild storage** (not Novices by default).
- Each rank has a daily limit: Officer 256, Veteran 128, Member 64, Novice 0 items; the leader has none. **Your rights** on the **Storage** tab shows what is left today.
- If your inventory is full, the rest drops on the ground next to you.

### Why does the trip to the guild home stop?

The trip starts after 5 seconds of standing still. Moving more than one block, taking damage or leaving the world cancels it. After a trip you wait 10 minutes before the next. A home can only be set on solid ground with two blocks of air, and not in instance worlds.

---

## Chat and combat

### How does the guild chat work?

`/gc <text>` writes to all online members. `/gc` alone switches your normal chat to the guild and back. Your guild tag stands in front of your name in every chat line, in the guild colour.

### Can guild members hurt each other?

Not by default. "No damage between members" is on for new guilds and also stops arrows. The leader can switch it off on the **Settings** tab, and the admin can forbid the setting for the whole server. Combat pets are not covered: a [combat pet](https://wiki.kyuubisoft.com/hytale/pets/) can still hit members of its owner's guild.

---

## Other KyuubiSoft mods

### What do other KyuubiSoft mods add?

Guilds works on its own. These mods add a part when they are installed:

| Mod | What it adds |
|-----|--------------|
| [Core](https://wiki.kyuubisoft.com/hytale/core/) | The **Guilds** tile in the `/ksadmin` hub; a currency for the optional founding fee; guild cards share Core's card row with the other mods |
| [Claims](https://wiki.kyuubisoft.com/hytale/claims/) 2.0.0+ | Guild land: your own claim becomes land of the guild with `/ksguild land add`; members from a chosen rank may build and use blocks there. The **Guild land** tab. Only players who may use a block in a claim can lock it there |
| [VoiceHub](https://wiki.kyuubisoft.com/hytale/voicehub/) 2.0.3+ | A voice channel "Guild: <name>" per guild, only for its members. It follows renames and goes away when the guild is disbanded |
| [Quests](https://wiki.kyuubisoft.com/hytale/quest-system/) | 25 guild experience per finished quest. From 2.1.9, quest objectives `guild_join`, `guild_create`, `guild_level`, `guild_lock` and `guild_donate` for your own quests |
| [Achievements](https://wiki.kyuubisoft.com/hytale/achievement-system/) | 40 guild experience per unlocked achievement. From 3.1.7, the same five types as achievement triggers |
| [Nameplates](https://wiki.kyuubisoft.com/hytale/nameplates/) | The guild tag above the head |
| ChatPlus | The guild tag as a chat prefix through ChatPlus; without it Guilds shows the tag itself |
| [Whisperstone](https://wiki.kyuubisoft.com/hytale/whisperstone/) | Invitations reach offline players as a message on their whisper stone |

The **Overview** of the admin window shows which of them are connected right now.

### What do the guild objectives count?

| Type | Counts |
|------|--------|
| `guild_join` | Joining a guild, once per player. Founding counts as joining |
| `guild_create` | Founding a guild, once per player |
| `guild_level` | The guild reaching a level; the target is the level number. Levels already reached count again on joining and login, so goals made later can still be met |
| `guild_lock` | Setting a guild lock, once per spot and player |
| `guild_donate` | Handing in building material; the target is the item id, the amount is the number of pieces |

Guilds adds no quests or achievements of its own. Admins build their own on these types.

---

## Admin

### How do I change settings?

In the admin window (`/ksguild admin`) under **Levels**, **Rules** and **Names**; changes apply at once. A few options are only in `config.json` (boss list, ignored creatures, farm brake, default rank rights); edit the file while the server is stopped. There is no reload command. See [Configuration](./configuration).

### Can I open a locked chest as an admin?

Only with `ks.guilds.admin.bypass`. `ks.guilds.admin` alone lets you remove the lock (`/ksguild unlock`, or **Remove** in the admin window), but not open the chest while it is locked.

### Can I get a disbanded guild's items back?

When an admin disbanded the guild, its storage was moved to `mods/kyuubisoft_guilds/lager/archive/<guild id>.json`. There is no command to restore it. A leader can only disband with an empty storage, so nothing is archived then.