# Permissions

**Version:** 2.0.1

KyuubiSoft Graveyard checks two permission nodes. Command syntax is on the [Commands](./commands) page.

---

## Permission nodes

| Permission | Default | Gates |
|------------|---------|-------|
| `ks.graveyard.user.use` | allowed | `/ksgraveyard menu`, `list` and `locate` |
| `ks.graveyard.admin` | not granted | Every admin subcommand: `admin_list`, `admin_clear`, `admin_remove`, `admin_tp`, `admin_stats`, `design_give`, `design_revoke`, `particle_give`, `particle_revoke`, `reload` |

**How the defaults work:**

- `ks.graveyard.user.use` is checked as "allowed unless set". In addition, the plugin adds it to Hytale's `Default` group on every start. A player whose node is set to `false` gets "No permission." for the three player commands.
- `ks.graveyard.admin` is the only admin node. Grant it to your staff; a wildcard such as `*` covers it too.
- The console can run every admin command except `admin_tp`, which needs a player.
- `/kslang` has no permission.

---

## What the nodes do not cover

- **Opening gravestones.** Pressing **F** on a gravestone has no permission check. Who may loot is decided by ownership and the protection time (`protectionTimerSeconds`).
- **The menu's buttons.** Selecting and buying designs and particles, **Send coordinates** and **Teleport** have no node of their own. Only `ks.graveyard.user.use` (to open the menu) and the config (`allowTeleportToGravestone`, prices) control them.
- **Dying.** Every player outside creative mode gets a gravestone, unless the world is in `excludedWorlds`.

---

## LuckPerms examples

### Staff gets the admin commands

```
/lp group admin permission set ks.graveyard.admin true
```

### Take the commands away from a group

```
/lp group guest permission set ks.graveyard.user.use false
```

Guests then cannot open the menu or use `list` and `locate`. They still get gravestones and can loot them with **F**.

---

## Note for older setups

- Up to 1.3.1 the admin subcommands also checked the old node `graveyard.admin`, so admins needed `ks.graveyard.admin` **and** `graveyard.admin`. Since 2.0.0 only `ks.graveyard.admin` is checked; `graveyard.admin` can be removed.
- Earlier versions of this page described split admin nodes such as `ks.graveyard.admin.list`. They do not exist in KyuubiSoft Graveyard.