> For the complete documentation index, see [llms.txt](https://buildsystem.eintosti.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://buildsystem.eintosti.de/getting-started/getting-started.md).

# Overview

Install the plugin, create your first world, and find your way around.

Configure and run BuildSystem on Spigot, Paper, or compatible server software.

## Your First Ten Minutes

New here? Do these in order and you will have a working build server.

1. **Install it.** Drop the jar in `plugins/` and start the server on **Java 25**. The console reports where backups will be stored. Full requirements: [Installing BuildSystem](/getting-started/installing-buildsystem.md).
2. **Open the navigator.** Run `/worlds`. Three tabs ship by default: **Worlds**, **Archive**, and **Private**. They stay empty until you make a world.
3. **Create your first world.** Click the create item, choose a type, and name it. [Creating Worlds](/getting-started/creating-a-world.md) covers templates, custom generators, and seeds.
4. **Set its status.** In `/worlds edit`, click the status item. A world starts at *Not Started* and flips to *In Progress* by itself on the first block change. Status is what decides which navigator tab a world appears in.
5. **Let your builders in.** They need `buildsystem.navigator` for `/worlds` and `buildsystem.build` for build mode. To restrict one world to named people, add them with `/worlds addBuilder` and enable the builders toggle in `/worlds edit`. See [World Access](/permissions-and-access/restricting-worlds.md).

Once the defaults stop fitting, [Custom Statuses & Categories](/managing-worlds/custom-statuses-and-categories.md) shows how to add your own workflow stages and navigator tabs in `/setup`, and [World Backups](/managing-worlds/world-backups.md) covers scheduling backups to disk, S3, or SFTP.

{% hint style="warning" %}
Upgrading from v3? Read the [Migration Guide](/getting-started/migration-guide.md) first. Conversion is automatic but one-way, so copy `plugins/BuildSystem/` before you start.
{% endhint %}

***

## Navigation

* [**Installing BuildSystem**](/getting-started/installing-buildsystem.md): Server requirements, runtime versions, installation.
* [**Creating Worlds**](/getting-started/creating-a-world.md): Command and UI-driven world creation and importing.
* [**Migration Guide**](/getting-started/migration-guide.md): Upgrading from v3 to v4: requirements, automatic conversion, and API changes.

Then, by what you want to do:

* **Managing Worlds**: [the World Editor](/managing-worlds/world-editor.md) for per-world settings, [Statuses & Categories](/managing-worlds/custom-statuses-and-categories.md) for workflow stages and navigator tabs, [Folders](/managing-worlds/creating-a-folder.md) for grouping, [Custom Generators](/managing-worlds/custom-generators.md) for third-party terrain, and [Backups](/managing-worlds/world-backups.md).
* **Builder Tools**: [Player Settings](/builder-tools/player-settings.md), [the Scoreboard](/builder-tools/scoreboard.md), and [Custom Blocks](/builder-tools/custom-blocks.md).
* **Reference**: [every config key](/reference/config.md), [Common Issues](/reference/common-issues.md), and the [Changelog](/reference/changelog.md).