> ## Documentation Index
> Fetch the complete documentation index at: https://pumpkings.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# NxShards Commands: Full Player and Admin Reference

> Complete reference for every NxShards command — player balance, shop, leaderboard, pay, plus admin zone management, give, take, wand, and reload.

NxShards exposes all of its functionality through the `/shards` command and its subcommands. Player commands have no permission requirement; admin commands require `nxshards.admin`.

## Player Commands

| Command                         | Description                                                                                   |
| ------------------------------- | --------------------------------------------------------------------------------------------- |
| `/shards`                       | Displays your current Shards balance.                                                         |
| `/shards shop`                  | Opens the GUI shop where you spend Shards on configured items.                                |
| `/shards top`                   | Shows the leaderboard of players with the most Shards.                                        |
| `/shards pay <player> <amount>` | Safely transfers Shards to another player, respecting the configured maximum transfer amount. |

## Admin Commands

All admin subcommands require the `nxshards.admin` permission.

| Command                                                  | Description                                                          |
| -------------------------------------------------------- | -------------------------------------------------------------------- |
| `/shards give <player> <amount>`                         | Adds Shards to a player's account.                                   |
| `/shards take <player> <amount>`                         | Removes Shards from a player's account.                              |
| `/shards wand`                                           | Gives you the selection wand used to mark AFK zone corners.          |
| `/shards zone create <name> [interval_seconds] [shards]` | Creates a new AFK Zone using the area selected with the wand.        |
| `/shards zone delete <name>`                             | Permanently deletes an existing AFK Zone.                            |
| `/shards reload`                                         | Reloads `config.yml`, all messages, and the in-memory zone registry. |

## Examples

**Create an AFK zone called `lobby_afk` paying 2 Shards every 30 seconds:**

```text theme={null}
/shards zone create lobby_afk 30 2
```

**Give 500 Shards to a player:**

```text theme={null}
/shards give Steve 500
```

**Transfer 1000 Shards to a friend:**

```text theme={null}
/shards pay Alex 1000
```

<Note>
  When `interval_seconds` or `shards` is omitted from `/shards zone create`, NxShards falls back to `zones.default-interval-seconds` and `zones.default-amount` from `config.yml`.
</Note>