Commands and Permissions
Structory uses /structory as its main command.
Most commands are intended for administrators and are op by default.
Main commands
| Command | Permission | Edition | Description |
|---|---|---|---|
/structory | structory.cmd.use | Free/Premium | Shows the main Structory command message. |
/structory help | structory.cmd.help | Free/Premium | Shows the command help message. |
/structory reload | structory.cmd.reload | Free/Premium | Reloads Structory by disabling and enabling the plugin again. |
For production servers, a full restart is safer than /structory reload after large changes to structures, recipes, dependencies or placed instances.
Saved item commands
Saved items let you save a custom item from your hand and reuse it in recipes or results.
| Command | Permission | Edition | Description |
|---|---|---|---|
/structory item save <name> | structory.cmd.item.save | Free/Premium | Saves the item in your main hand. |
/structory item get <name> | structory.cmd.item.get | Free/Premium | Gives you a saved item. |
/structory item replace <name> | structory.cmd.item.replace | Free/Premium | Replaces a saved item with the item in your main hand. |
/structory item delete <name> | structory.cmd.item.delete | Free/Premium | Deletes a saved item. |
Examples:
/structory item save strangeapple
/structory item get strangeapple
/structory item replace strangeapple
/structory item delete strangeapple
Saved items are stored in:
plugins/Structory/customitem/
Premium layout commands
Layout commands help you create a structure layout from an in-game region.
| Command | Permission | Edition | Description |
|---|---|---|---|
/structory layout item | structory.cmd.layout.item | Premium | Turns the item in your hand into the region selection tool. |
/structory layout create | structory.cmd.layout.create | Premium | Exports the selected region as a layout file. |
Basic flow:
- Hold any item.
- Run
/structory layout item. - Left-click the first corner of the region.
- Right-click the second corner of the region.
- Run
/structory layout create. - Copy the generated layout into your structure file and adjust it.
Premium admin/editor commands
The Admin GUI is intended for server owners and trusted staff members.
| Command | Permission | Description |
|---|---|---|
/structory editor | structory.cmd.admin.editor | Opens the main editor dashboard directly. |
/structory admin editor | structory.cmd.admin.editor | Opens the main editor dashboard through the admin branch. |
/structory admin item | structory.cmd.admin.item | Gives/marks the admin inspection item. |
/structory admin instances | structory.cmd.admin.instances | Opens the placed instance list. |
/structory admin instance <uuid> | structory.cmd.admin.instances | Opens one placed instance. |
/structory admin recipes | structory.cmd.admin.recipes | Opens the loaded recipe list. |
/structory admin recipe <name> | structory.cmd.admin.recipes | Opens one recipe. |
/structory admin structures | structory.cmd.admin.structures | Opens the loaded structure list. |
/structory admin structure <name> | structory.cmd.admin.structures | Opens one structure template. |
/structory admin guis | structory.cmd.admin.guis | Opens GUI definition tools. |
/structory admin gui | structory.cmd.admin.guis | Alias for GUI definition tools. |
/structory admin validate | structory.cmd.admin.validate | Runs the health/validation report. |
/structory admin health | structory.cmd.admin.validate | Alias for the health/validation report. |
For a complete explanation, see the Admin GUI page.
Premium option commands
Some Premium systems expose commands through the option command tree.
The most common public use is privacy administration.
| Command | Edition | Description |
|---|---|---|
/structory option privacy set <instance-uuid> <type> | Premium | Changes a structure instance privacy type. |
/structory option privacy edit public owner <instance-uuid> <player> | Premium | Changes the owner of a public structure by player name. |
/structory option privacy edit public owneruuid <instance-uuid> <player-uuid> | Premium | Changes the owner of a public structure by UUID. |
Available privacy types:
| Type | Meaning |
|---|---|
OwnerOnly | Only the owner can interact. |
Public | Public structure with an owner. |
AllowAll | Anyone can interact. |
Permission groups
| Permission | Description |
|---|---|
structory.cmd.admin.* | Gives access to every Premium Admin GUI section. |
structory.cmd.* | Gives access to the main Structory command groups declared by the plugin. |
structory.* | Gives all Structory permissions declared by the plugin. Use only for trusted administrators. |
Some internal Premium command branches may use administrator checks that are not meant for normal players. Give broad permissions only to trusted staff.