# Schematics

## 🧭 Overview

The plugin loads schematics directly from [**WorldEdit**](https://dev.bukkit.org/projects/worldedit) / [**FastAsyncWorldEdit**](https://www.spigotmc.org/resources/fastasyncworldedit.13932/)’s folders.

To be recognized:

* **Lobby schematics must start with:** `al_lobby_<id>`
* **Arena schematics must start with:** `al_arena_<id>`

***

## 🛠 Creating Games

#### 1️⃣ Build Your Maps

Create:

* **One lobby**
* **One or more arenas**

#### 2️⃣ Place the`[LOCATION]` Signs

Before saving your schematics, place the needed [location signs](#lobby-setup).

#### 3️⃣ Save the Schematic

Use WorldEdit or FAWE: `/schem save <name>`

ArenaLegends will automatically detect:

* `al_lobby_<id>*.schem`
* `al_arena_<id>*.schem`

from:

* `plugins/WorldEdit/schematics/`
* `plugins/FastAsyncWorldEdit/schematics/`

#### 4️⃣ Create the Game

Once your schematics exist: `/al creategame <id>`

The plugin will link lobby and arena schematics to the game automatically.

#### 5️⃣ Done — Game is Ready

The plugin loads, pastes, and unloads maps on demand with no extra steps.

#### 6️⃣ Manage Your Game

Use the in-game menu to adjust everything: `/al gamemanager`

{% hint style="info" %}

* Keep maps small for faster paste times.
* You can replace any schematic at any moment.
* Simply **reload the plugin** to apply new maps.
  {% endhint %}

***

## 🏠 Lobby Setup

Each **lobby** schematic must include these `[LOCATION]` signs:

| Sign                                                       | Purpose                                    |
| ---------------------------------------------------------- | ------------------------------------------ |
| <p><code>\[LOCATION]</code><br><code>JOIN</code></p>       | Where players spawn when joining the lobby |
| <p><code>\[LOCATION]</code><br><code>END</code></p>        | Teleport location when the match ends      |
| <p><code>\[LOCATION]</code><br><code>SHOPKEEPER</code></p> | Where the shop NPC should spawn            |
| <p><code>\[LOCATION]</code><br><code>TEAM</code></p>       | Team spawn points in the lobby             |

{% hint style="success" %}
Once finished, save the region as a schematic and place it in `/maps/lobby/`.
{% endhint %}

***

## ⚔️ Arena Setup

Each **arena** schematic must include these `[LOCATION]` signs:

| Sign                                                   | Purpose                                                        |
| ------------------------------------------------------ | -------------------------------------------------------------- |
| <p><code>\[LOCATION]</code><br><code>CENTER</code></p> | Center point of the map                                        |
| <p><code>\[LOCATION]</code><br><code>TEAM</code></p>   | <p>Spawn locations for Teams<br>⚠️ Two spawns are required</p> |

{% hint style="success" %}
Once finished, save the region as a schematic and place it in `/maps/arena/`.
{% endhint %}
