Installing BuildSystem

Requirements, setup, and what the first startup creates.

Requirements

Ensure your server meets the following version requirements before installation:

• Java Version: Java 25 minimum. The plugin will not load on older runtimes and will throw unsupported class version errors.

• Minecraft Version: Supports Minecraft 26.1 and newer.

• Server Software: Spigot, Paper, or a fork of either.

Optional Integrations

None of these are required. BuildSystem detects each at startup and simply skips the integration when it is absent.

Plugin	What it adds
LuckPerms	A buildsystem:build-mode context you can key permissions off.
PlaceholderAPI	%buildsystem_...% placeholders for other plugins and scoreboards.
WorldEdit / FastAsyncWorldEdit	World edits respect BuildSystem's per-world protection.
AxiomPaper	Axiom edits respect the same protection.

---

Installation Steps

1. Download the BuildSystem.jar file from SpigotMC or a verified channel.

2. Place the .jar file into the server's plugins/ directory.

3. Start the server to generate default configuration directories and files.

4. Stop the server by running the stop command in the console.

5. Modify plugins/BuildSystem/config.yml and messages.yml as needed.

6. Restart the server.

---

What the First Startup Creates

Inside plugins/BuildSystem/:

File	Contents
config.yml	Global settings. Versioned and migrated automatically on later upgrades.
messages.yml	Every player-facing string.
worlds.yml	The world registry: status, visibility, builders, and per-world data.
folders.yml	Folder definitions and their world membership.
statuses.yml	The world statuses, seeded with the six built-ins.
categories.yml	The navigator categories, seeded with the built-ins.
templates/	Drop world folders here to offer them as creation templates.

---

Verifying the Install

Run /worlds in-game. The navigator should open with the default categories. If the command is not found, check the console for a startup error; if it opens but is empty, no worlds have been created or imported yet.

Upgrading rather than installing fresh? Read the Migration Guide first. The plugin converts its data on first boot and the conversion is one-way.