Skip to main content

Updating from 1.5 to 26.1

Structory 26.1 is a larger update than the version number jump makes it look.

The plugin is still Structory, but the project layout and the admin tooling changed a lot.

Before updating​

Stop the server and back up the whole folder:

plugins/Structory/

Back up at least:

  • config.yml;
  • messages.yml;
  • gui.yml;
  • structures/;
  • recipes/;
  • customitem/;
  • instances/.

Do not update by copying only one file at a time. Keep a full copy of the old setup until the server has been tested.

Version numbers​

Structory 26.1 expects the default config to contain:

version: 26.1

If your old config still says 1.5.0 or another 1.x version, Structory may create a backup and generate the new default config.

That message is not automatically an error. It means Structory found an older config format.

Free and Premium are now separate​

The Free and Premium codebases are no longer managed as two branches of the same project.

Free contains the public core/free plugin.

Premium depends on the shared core and keeps the Premium-only features in the private Premium project.

For server owners, the practical rule is simple:

  • install the Free jar for Free servers;
  • install the Premium jar for Premium servers;
  • do not install both at the same time.

Particle effects moved out of crafting​

Old configs may define visual effects directly inside the crafting option:

options:
  crafting:
    consume:
      type: particle
      particle: FLAME

New configs should put reusable visual effects in the particle option:

options:
  crafting:
    recipe: ["default"]
  particle:
    consume:
      type: particle
      particle: FLAME
      amount: 8

This keeps crafting behavior and visual decoration separated.

If the console says something like:

Please move 'consume' section particle of crafting option inside of particle option

move that section under options.particle.

Admin editor command​

Premium now has a direct editor command:

/structory editor

The old admin path also works:

/structory admin editor

Use the editor to inspect structures, instances, recipes, loaded options, config files, GUI definitions and health checks.

ActionBar behavior​

Structory 26.1 uses an updated DadaPlatform build.

ActionBar messages should now appear in the action bar area instead of normal chat.

If they still appear in chat, make sure your server is loading the new Structory jar and not an older copy.

Folia​

Structory 26.1 declares Folia support.

This means Structory's own scheduling was moved to the newer DadaPlatform scheduler layer.

Optional dependencies still matter. If a recipe uses CraftEngine, Oraxen, MMOItems, ItemsAdder, Vault, CoinsEngine, EcoItems or ExecutableItems, that dependency must also work correctly on your server platform.

Suggested test after updating​

After installing the new jar:

  1. Start the server once.
  2. Check the console for config backup or parser warnings.
  3. Run /structory.
  4. If using Premium, open /structory editor.
  5. Test one existing structure.
  6. Test one recipe with simple Bukkit items.
  7. Test one recipe that uses saved items.
  8. Test optional dependency recipes last.
  9. Only after that, test crates, storage, privacy and heavy particles.