Skip to main content

Commands and Permissions

Structory uses /structory as its main command.

Most commands are intended for administrators and are op by default.

Main command

CommandPermissionDescription
/structorystructory.cmd.useShows the main Structory command message.
/structory helpstructory.cmd.useShows the available command sections.
/structory reloadstructory.cmd.reloadReloads Structory configuration and systems.
caution

For production servers, a full restart is safer than /structory reload after large changes to structures, recipes, or dependencies.

Saved item commands

Saved items let you save a custom item from your hand and reuse it in recipes or results.

CommandPermissionDescription
/structory item save <name>structory.cmd.item.saveSaves the item in your main hand.
/structory item get <name>structory.cmd.item.getGives you a saved item.
/structory item replace <name>structory.cmd.item.replaceReplaces a saved item with the item in your main hand.
/structory item delete <name>structory.cmd.item.deleteDeletes 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/

Layout commands

Layout commands help you create a structure layout from an in-game region.

CommandPermissionDescription
/structory layout itemstructory.cmd.layout.itemTurns the item in your hand into the region selection tool.
/structory layout createstructory.cmd.layout.createExports the selected region as a layout file.

Basic flow:

  1. Hold any item.
  2. Run /structory layout item.
  3. Left-click the first corner of the region.
  4. Right-click the second corner of the region.
  5. Run /structory layout create.
  6. Copy the generated layout into your structure file and adjust it.

Admin GUI commands

The Admin GUI is intended for server owners and trusted staff members.

It helps you inspect saved items, loaded recipes and placed structure instances without manually typing every key.

CommandPermissionDescription
/structory adminstructory.cmd.admin.useOpens the main Admin GUI or shows the available admin sections.
/structory admin itemstructory.cmd.admin.itemOpens the saved item admin page.
/structory admin recipestructory.cmd.admin.recipeOpens the recipe admin page.
/structory admin instancestructory.cmd.admin.instanceOpens the structure instance admin page.

Recommended wildcard permissions:

PermissionDescription
structory.cmd.admin.*Gives access to every Admin GUI section.
structory.*Gives full Structory access. Use only for trusted administrators.

For a complete explanation, see the Admin GUI page.

Crate command

This command is part of the premium crate feature.

CommandPermissionDescription
/structory crate give <player> <crate>Administrator accessGives a crate item for the selected structure key.

Example:

/structory crate give Steve elder_altar

The crate key must match a structure that has the crate option configured.

Privacy commands

Privacy commands are part of the premium privacy feature.

CommandPermissionDescription
/structory option privacy set <instance-uuid> <type>Administrator accessChanges a structure instance privacy type.
/structory option privacy edit public owner <instance-uuid> <player>Administrator accessChanges the owner of a public structure by player name.
/structory option privacy edit public owneruuid <instance-uuid> <player-uuid>Administrator accessChanges the owner of a public structure by UUID.

Available privacy types:

TypeMeaning
OwnerOnlyOnly the owner can interact.
PublicPublic structure with an owner.
AllowAllAnyone can interact.

Permission groups

PermissionDescription
structory.cmd.*Gives access to the main command and standard item/layout commands.
structory.*Gives all Structory permissions declared by the plugin.
info

Some premium commands may use internal administrator checks even when they are not explicitly listed in plugin.yml. Give them only to trusted staff.