> For the complete documentation index, see [llms.txt](https://rareitemhunter.gitbook.io/rareitemhunter-remaster/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rareitemhunter.gitbook.io/rareitemhunter-remaster/configuration/commands.md).

# Commands

The main command is configurable in `config.yml`. Examples below use `/rih`, but `/boss` remains available as a fallback alias.

## Public Commands

| Command                  | Description                             |
| ------------------------ | --------------------------------------- |
| `/rih recipe <property>` | Show the recipe and info for a property |
| `/rih info <property>`   | Alias of `recipe`                       |

## Admin Commands

### Eggs and Bosses

| Command                                                          | Permission                  | Description              |
| ---------------------------------------------------------------- | --------------------------- | ------------------------ |
| `/rih egg <boss\|random> <here\|random> [region] [world region]` | `rareitemhunter.admin.egg`  | Spawn a boss egg         |
| `/rih eggs`                                                      | `rareitemhunter.admin.egg`  | List active boss eggs    |
| `/rih eggs tp <index>`                                           | `rareitemhunter.admin.egg`  | Teleport to a listed egg |
| `/rih spawn <boss> <here\|random>`                               | `rareitemhunter.admin.boss` | Spawn a boss directly    |

### Items and Crafting

| Command                          | Permission                     | Description                                          |
| -------------------------------- | ------------------------------ | ---------------------------------------------------- |
| `/rih get <property>`            | `rareitemhunter.admin.crafter` | Give yourself the legendary component for a property |
| `/rih ingredients <property>`    | `rareitemhunter.admin.crafter` | Give yourself a property's crafting ingredients      |
| `/rih craft <property> <level>`  | `rareitemhunter.admin.crafter` | Apply a property to the item in your main hand       |
| `/rih essence [player]`          | `rareitemhunter.admin.essence` | Give a Rare Essence                                  |
| `/rih matter [player]`           | `rareitemhunter.admin.essence` | Give Dark Matter                                     |
| `/rih diamond [player]`          | `rareitemhunter.admin.essence` | Give a Cursed Diamond                                |
| `/rih tribute [player]`          | `rareitemhunter.admin.essence` | Give a Legendary Tribute                             |
| `/rih compass [player]`          | `rareitemhunter.admin.compass` | Give a Legendary Compass                             |
| `/rih compass enhanced [player]` | `rareitemhunter.admin.compass` | Give a Legendary Compass Enhanced                    |
| `/rih remover [player]`          | `rareitemhunter.admin.remover` | Give a Boss Remover admin tool                       |
| `/rih itemValidate`              | `rareitemhunter.admin.crafter` | Validate the item in your hand                       |

### Utility

| Command                   | Permission                                            | Description                                                      |
| ------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------- |
| `/rih timer`              | `rareitemhunter.admin.timer`                          | Show time until the next automatic spawn attempt                 |
| `/rih reload`             | `rareitemhunter.admin.reload`                         | Reload plugin files                                              |
| `/rih pools list`         | `rareitemhunter.admin.pools`                          | List regional boss pools and their current status. Alias: status |
| `/rih pools validate`     | `rareitemhunter.admin.pools`                          | Validate the pools config file and report any errors             |
| `/rih pools spawn <pool>` | rareitemhunter.admin.pools + rareitemhunter.admin.egg | Force an immediate spawn attempt for the named pool              |

## `/rih egg` Usage

```
/rih egg <boss|random> here
/rih egg <boss|random> random
/rih egg <boss|random> random <region>
/rih egg <boss|random> random <world> <region>
```

Notes:

* `random` as the boss name chooses a random configured boss.
* `here` ignores random-region restrictions and spawns at your location.
* `random` chooses a valid surface location within the configured random radius.
* If no world and region are provided, the plugin uses `defaultRandomEggWorld` and `defaultRandomEggRegion`.
* From console, random spawning requires explicit world and region arguments.

## Special Items Exposed by Commands

* `Legendary Compass`: tracks the nearest boss egg
* `Legendary Compass Enhanced`: tracks the nearest boss egg and shows distance
* `Boss Remover`: admin-only tool that cleanly removes a tracked boss