> For the complete documentation index, see [llms.txt](https://obey.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://obey.gitbook.io/wiki/tools/features/admin-management.md).

# Admin Management

Documentation for CrownTools administrative commands, permissions, and giving tools.

CrownTools includes an intuitive administrative command system (`/tools`) that allows server administrators to spawn custom tools for players, reload configuration files, and execute tool repairs.

***

## Command Overview & Permission

* **Primary Command**: `/tools` (aliases: `/tool`)
* **Permission**: `command.tools`

***

## Subcommands

### 1. Giving Custom Tools

```bash
/tools give <player> <tool_type> <usage_type> <value>
```

Spawns a customized tool and adds it directly into the target player's inventory.

#### Parameters:

* **`<player>`**: The name of an online target player.
* **`<tool_type>`**: The type of custom tool to issue.
  * `DRILL`
  * `EXCAVATOR`
  * `MULTI_TOOL`
  * `INSTANT_AXE`
  * `INFINITY_ROCKET`
  * `ENDLESS_BUCKET`
* **`<usage_type>`**: Durability mode for the tool:
  * `USES`: The tool has a set number of uses.
  * `TIME`: The tool has a timed expiration duration.
* **`<value>`**:
  * **For `USES`**: Set the total number of uses (e.g. `100`, `5000`). Pass `-1` for **unlimited** uses.
  * **For `TIME`**: Specify duration in standard duration format (e.g., `1d` for 1 day, `12h` for 12 hours, `30m` for 30 minutes, `45s` for 45 seconds), milliseconds as a plain number, or `-1` for **unlimited** time duration.

#### Example Commands:

```bash
# Give Obey a Drill with 500 uses
/tools give Obey DRILL USES 500

# Give Obey an Instant Axe valid for 7 days
/tools give Obey INSTANT_AXE TIME 7d

# Give Obey an Endless Bucket with unlimited uses
/tools give Obey ENDLESS_BUCKET USES -1
```

***

### 2. Repairing Tools

```bash
/tools repair
```

Repairs the broken custom tool held in the player's main hand.

* Requires the held item to be a valid broken custom tool.
* Checks if `repairable: true` is enabled in `config.yml` for that tool and usage type.
* Deducts the configured `repair-price` from the player's Vault economy balance before restoring the tool to 100% durability.

***

### 3. Reloading Configuration

```bash
/tools reload
```

Reloads `config.yml`, `messages.yml`, and `sounds.yml` from disk without requiring a server restart, and re-verifies license credentials asynchronously.