Structory

Structory is a Minecraft server plugin for creating custom multi-block structures.

A structure is a build made from multiple blocks, such as an altar, forge, portal, generator, storage device, or any other custom construction you want players to build in the world. When the player builds the correct shape and activates it, Structory can recognize it and run the configured behavior.

Structory is mainly configured with YAML files. You do not need to write code to create structures or recipes.

Structory 26.1 is split into two editions:

• Structory Free, the public/free plugin with the core structure and crafting features;
• Structory Premium, the private/premium plugin with advanced options, integrations and in-game editor tools.

Both editions share the same core logic, but Premium adds the larger administration and automation layer.

What Structory can do

Structory can be used to create:

• multi-block structures built directly in the world;
• custom crafting systems attached to structures;
• physical item slots around a structure;
• recipe selection GUIs;
• effects such as messages, titles, sounds, particles, and fireworks;
• protected structure instances that cannot be broken normally;
• crate items that place structures automatically;
• owner-based or public structure access;
• storage and bag-style block inputs;
• structure rebuilding;
• integrations with custom item and economy plugins.

Typical use cases

Server owners usually use Structory for:

• custom altars;
• special crafting stations;
• forge systems;
• generators;
• ritual or magic systems;
• advanced item upgrades;
• reward structures;
• premium structures delivered through crate items.

Free and Premium features

The free version focuses on structure-based crafting.

The premium version adds advanced systems such as:

• in-game editor dashboard with /structory editor;
• unlimited saved custom items;
• crate placement;
• structure privacy;
• block display support;
• rebuild behavior;
• command actions;
• storage and bag features;
• world restrictions;
• more advanced integrations.

For a detailed comparison, see the Free vs Premium page.

Some premium features require optional external plugins. Structory only enables integrations when the required plugin is installed and enabled on your server.

Basic workflow

The usual workflow is:

1. Install Structory on your server.
2. Start the server once so the plugin creates its folders.
3. Create or edit a file inside the structures folder.
4. Create or edit recipes inside the recipes folder.
5. Restart the server, or use /structory reload while testing.
6. Build the structure in-game and activate it with Shift + Right Click on the configured check block.

Premium users can also start from:

/structory editor

This opens the editor dashboard for structures, instances, recipes, config files, GUI definitions and health checks.

Important folders

Structory stores its files in the plugin data folder:

plugins/Structory/

The most important folders are:

Folder or file	Purpose
config.yml	Main plugin settings.
messages.yml	Player-facing messages.
gui.yml	GUI-related text and item settings.
structures/	Structure definitions.
recipes/	Recipe definitions.
customitem/	Saved custom items created with commands.
instances/	Saved structures that players created in the world.
blockdisplay/	Block display models used by the premium block display option.

Recommended editor

Use an editor that supports YAML indentation, such as VS Code or Notepad++.

YAML is indentation-sensitive. Most configuration errors are caused by missing spaces, wrong indentation, or tabs. Use spaces, not tabs.