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

# Commands & Permissions

> A complete list of all commands and permission nodes available in SentryLore.

While SentryLore formats vanilla items automatically in the background, it provides a comprehensive suite of administration commands for managing custom items, opening GUIs, and configuring the plugin in-game.

## Administrator Commands

All administration commands branch off the primary `/sentrylore` command (Aliases: `/slore`, `/lore`).

<CardGroup cols={2}>
  <Card title="/lore save <id>" icon="floppy-disk" iconType="duotone">
    Saves the custom item you are currently holding in your main hand directly to the database registry under the specified `<id>`.
  </Card>

  <Card title="/lore give <player> <id>" icon="gift" iconType="duotone">
    Spawns a custom item from the registry and gives it to the specified player. This automatically assigns a unique NBT UUID to the item for Dupe Protection.
  </Card>

  <Card title="/lore edit" icon="pen-to-square" iconType="duotone">
    Opens the interactive **Lore Editor GUI** for the item currently in your main hand, allowing you to modify its stats, rarity, and description visually.
  </Card>

  <Card title="/lore registry" icon="box-archive" iconType="duotone">
    Opens the **Registry GUI**, allowing you to browse, manage, and delete all custom items currently saved in your database.
  </Card>

  <Card title="/lore settings" icon="gear" iconType="duotone">
    Opens the **Settings GUI**, allowing you to toggle core plugin features without opening the `config.yml` file.
  </Card>

  <Card title="/lore wipe" icon="trash-can" iconType="duotone">
    Opens the **Confirm Wipe GUI**. Use this with extreme caution, as it is used to wipe lore data from the database.
  </Card>

  <Card title="/lore reload" icon="rotate-right" iconType="duotone">
    Reloads the `config.yml` and `messages.yml` files from disk, applying changes immediately.
  </Card>

  <Card title="/lore docs" icon="book" iconType="duotone">
    Displays a clickable link in chat to your unique Sentry Studios license key and the official documentation site.
  </Card>
</CardGroup>

***

## Permission Nodes

SentryLore keeps its permission structure extremely simple to prevent permission bloat on your server.

| Permission Node    | Default | Description                                                                                                                                                    |
| :----------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sentrylore.admin` | `OP`    | Grants full access to all `/sentrylore` subcommands listed above, allowing administrators to use the editor GUIs, spawn custom items, and manage the registry. |

<Note>
  Regular players do **not** need any permission nodes for SentryLore to format the items they hold. The engine categorizes and formats items automatically across the entire server for everyone.
</Note>