Options Overview

Options are placed inside a structure under the options section.

They decide what the structure does when it is created, used, or interacted with.

Example

elder_altar:
  name: "Elder Altar"
  check-block: CAULDRON
  orientation: false
  options:
    notify:
      message: "<white>You have created <light_purple>%structure%"
    fireworks:
      type: RANDOM
      amount: 3
      power: 2
    crafting:
      recipe: ["god_apple"]
      recipe-slots:
        offsets:
          - "0 1 0"
  layout:
    levels:
      level0:
        level: 0
        type: STANDARD
        checkers:
          types:
            C: CAULDRON
          main:
            - "C"

Available options

Option key	Feature	Availability
notify	Sends messages, titles, subtitles, or action bars.	Free
fireworks	Launches fireworks when the structure is created.	Free
particle	Plays scheduled and event-based particles or sounds.	Free/Premium depending on decoration type
crafting	Enables structure crafting.	Free
command	Runs console or player commands.	Premium
crate	Creates an item that can place the structure.	Premium
privacy	Controls who can interact with the structure.	Premium
storage	Adds storage behavior to the structure.	Premium
bag	Lets blocks in the structure act as ingredients.	Premium
blockdisplay	Shows custom block display models.	Premium
rebuild	Rebuilds or repairs the structure from a builder layout.	Premium
validworlds	Restricts structure creation to selected worlds.	Premium

Internal or not-yet-stable options

Some option keys may exist in the code before they are ready as public features.

At the moment, data is treated as an internal/advanced placeholder and is not documented as a stable server-owner feature. Do not build production configs around it unless a later release explicitly documents its final behavior.

Configuration style

Each option uses this format:

options:
  option_key:
    setting: value

You can use multiple options on the same structure:

options:
  notify:
    actionbar: "<yellow>Structure created"
  crafting:
    recipe: ["forge"]
  validworlds:
    worlds:
      - "world_nether"

Recommended approach

When creating a new structure, start with only:

1. notify
2. a simple layout
3. optional fireworks

Add crafting, crates, privacy, and advanced options only after the base structure is detected correctly.

Editing options from the Premium GUI

In Premium 26.1, options can describe how their own values should be edited.

When an option provides editor metadata, the Admin GUI uses that information to build a more useful editor. If no specific editor exists, Structory can fall back to a generic value-map editor.

This keeps option editing modular: the crate option, privacy option, crafting option and particle option do not need to be hardcoded into one giant editor.