Skip to main content

Structure Options

Options live under a structure's options: section. They control what a structure does when it is created, used, crafted at or broken.

my_altar:
name: "My Altar"
check-block: AMETHYST_BLOCK
options:
notify:
message: "<aqua>Altar activated!"
privacy:
type: OwnerOnly
layout:
levels:
level0:
level: 0
type: STANDARD
checkers:
types:
A: AMETHYST_BLOCK
main:
- "A"

Choose an option​

KeyPurposeEdition
notifyMessage, actionbar or title on eventsFree
fireworksFireworks when a structure is createdFree
craftingRecipes, physical slots, recipe GUIFree
particleSound, particles, shapes and timed effectsFree / Premium shapes
commandPlayer or console commandsPremium
cratePlaceable structure itemsPremium
privacyOwnership and access permissionsPremium
bagUse structure blocks as ingredient inputsPremium
storageNamed internal inventories (current limitations apply)Premium
blockdisplayJSON display models and animationsPremium
rebuildRebuild steps when the structure is brokenPremium
validworldsLimit structures to selected worldsPremium
statesEffects for idle, active, crafting and other statesPremium

For a first test, start with notify and a minimal layout. Add one option at a time so it's clear which part is causing a problem.

Not every option represents a continuously running feature. For example, states.idle plays when that state starts, while particle.ambient.schedule: true creates a repeated effect. See the particle guide for the difference.