Commands and Permissions
Every command is a subcommand of /oftrelics (alias /nr), plus /relics, a shortcut for /oftrelics menu. Command permissions follow the oftrelics.command.<name> pattern. Player commands are open to everyone by default and admin commands to operators; the defaults are listed under Permissions.
Commands
| Command | Description | Permission |
|---|---|---|
/relics [chest\|spatial\|admin] | Open a relic menu: chest (the equipment menu), spatial (the floating menu) or admin (the relic browser). Without a type it opens your /oftrelics style pick, or else menu.default-type | oftrelics.command.menu + oftrelics.command.menu.<type> |
/oftrelics menu [chest\|spatial\|admin] | Same as /relics | oftrelics.command.menu + oftrelics.command.menu.<type> |
/oftrelics | With no arguments, same as /relics (players only) | oftrelics.command.oftrelics + oftrelics.command.menu |
/oftrelics style [chest\|spatial\|admin\|default] | Choose which menu /relics opens for you. default goes back to the server default; with no argument it shows your current choice. Picking a type also needs that type's permission | oftrelics.command.style |
/oftrelics hud [on\|off] | Turn the relic HUD on or off for yourself; with no argument it toggles | oftrelics.command.hud |
/oftrelics give <player> <relic> [amount] | Give a relic to a player (amount defaults to 1). It goes to their inventory, or drops at their feet if it's full | oftrelics.command.give |
/oftrelics setlevel <player> <relic> <level> | Set the level of a relic the player has equipped, resetting its xp to 0 | oftrelics.command.setlevel |
/oftrelics givexp <player> <relic> <amount> | Give xp to a relic the player has equipped | oftrelics.command.givexp |
/oftrelics reload | Reload relics, recipes, slots, configuration and the resource pack | oftrelics.command.reload |
/oftrelics reloadpack | Rebuild and re-send only the resource pack | oftrelics.command.reloadpack |
/oftrelics sendpack [player] | Send the current resource pack to a player (yourself if no player is given) | oftrelics.command.sendpack |
Tab completion only suggests what you can use: menu types you have permission for, relics for give (except those with exclude-from-commands: true, which can still be typed in full), and only levelling relics for setlevel and givexp.
Permissions
| Permission | Description | Default |
|---|---|---|
oftrelics.* | Grants every OFTRelics permission | op |
oftrelics.command.* | Grants every command | op |
oftrelics.command.oftrelics | Use the base command | true |
oftrelics.command.menu | Use /relics and /oftrelics menu | true |
oftrelics.command.menu.* | Open every menu type | op |
oftrelics.command.menu.chest | Open the chest menu | true |
oftrelics.command.menu.spatial | Open the spatial menu | true |
oftrelics.command.menu.admin | Open the admin relic browser, which gives any relic | op |
oftrelics.command.style | Choose your own default menu | true |
oftrelics.command.hud | Toggle your HUD | true |
oftrelics.command.give | Give relics to players | op |
oftrelics.command.setlevel | Set an equipped relic's level | op |
oftrelics.command.givexp | Give xp to an equipped relic | op |
oftrelics.command.reload | Reload the plugin | op |
oftrelics.command.reloadpack | Rebuild and re-send the resource pack | op |
oftrelics.command.sendpack | Send the resource pack to a player | op |
oftrelics.craft.* | Craft every relic that has a recipe permission | op |
oftrelics.craft.<relic id> | Craft that relic (the bundled recipes use this pattern) | op |
oftrelics.slot.* | Unlock every permission-gated slot of the default config | op |
oftrelics.slot.<slot id> | Unlock that slot, from ring-3 to circlet-5 in the default config | op |
Crafting permissions
A crafting permission is whatever a relic's crafting.recipes.permission says; the bundled relics use oftrelics.craft.<relic id>. Every permission used by a loaded relic is registered on reload with an operator-only default and added to oftrelics.craft.*, so the wildcard works even with permission plugins that don't expand wildcards themselves. A relic without a permission can be crafted by anyone.
Slot permissions
The default config locks slots 3 to 5 of every type behind a permission named after the slot:
| Type | Permissions |
|---|---|
| Ring | oftrelics.slot.ring-3, oftrelics.slot.ring-4, oftrelics.slot.ring-5 |
| Amulet | oftrelics.slot.amulet-3, oftrelics.slot.amulet-4, oftrelics.slot.amulet-5 |
| Cube | oftrelics.slot.cube-3, oftrelics.slot.cube-4, oftrelics.slot.cube-5 |
| Belt | oftrelics.slot.belt-3, oftrelics.slot.belt-4, oftrelics.slot.belt-5 |
| Circlet | oftrelics.slot.circlet-3, oftrelics.slot.circlet-4, oftrelics.slot.circlet-5 |
This is only the default config's convention: each slot is unlocked by its own conditions: list, so you can rename these permissions or replace them with any other libreforge condition (see The Gameplay). If you add slots with new permissions, oftrelics.slot.* won't include them unless your permission plugin expands wildcards.
Where to go next
What these commands operate on: the How to Make a Relic guide.
Levelling admin tools in context: the Leveling reference.
The menus behind
/relics: Menus and HUD.