> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.mrerrorx.dev/primaxbattleroyalex/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Worlds and Borders in world-settings.yml

> Set up world generation, initial border size, shrink intervals, shrink target, and spawn heights for Battle Royale matches in world-settings.yml.

<Warning>
  **Server requirements:** PrimaxBattleRoyaleX generates a fresh world for every match and deletes it once the match ends. World generation runs on the server's main thread, so a weak CPU or low RAM will cause noticeable lag. A quality managed Minecraft host or a dedicated VPS with a strong single-thread CPU and ample RAM is strongly recommended. Shared or budget hosting is not suitable.
</Warning>

`world-settings.yml` controls how match worlds are generated and how the world border behaves throughout a match. This includes terrain generation settings, the starting border size, how quickly and how far the border shrinks, and the Y level at which players drop in at match start.

**File location:** `plugins/PrimaxBattleRoyaleX/world-settings.yml`

***

## World Generation

PrimaxBattleRoyaleX creates a fresh world for every match and deletes it automatically when the match ends.

<Info>
  Worlds are created fresh for every match and automatically cleaned up afterwards. You do not need to pre-create or manage any worlds manually.
</Info>

### TerraformGenerator Integration

If the [TerraformGenerator](https://www.spigotmc.org/resources/terraformgenerator-alpha.75132/) plugin is installed on your server, PrimaxBattleRoyaleX will **automatically use it** to generate more varied and visually interesting terrain for each match.

If TerraformGenerator is not installed, the plugin falls back to standard Minecraft terrain generation — no additional configuration is needed either way.

Match worlds are fully deleted once the match concludes.

***

## Border Settings

The world border starts large and gradually shrinks over the course of the match, forcing players into closer combat. All border values are measured in **blocks (radius)**.

| Setting           | Description                                                                      |
| ----------------- | -------------------------------------------------------------------------------- |
| `initial-size`    | The starting border radius in blocks at the beginning of the match.              |
| `shrink-to`       | The final border radius the border shrinks down to over the course of the match. |
| `shrink-interval` | How often (in seconds) the border shrinks by `shrink-amount`.                    |
| `shrink-amount`   | How many blocks the border radius decreases each time it shrinks.                |

```yaml world-settings.yml theme={null}
border:
  initial-size: 2500
  shrink-to: 50
  shrink-interval: 120
  shrink-amount: 25
```

***

## Spawn Height

| Setting        | Description                                                                                                                        |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `spawn-height` | The Y level at which players spawn at the start of a match. Set this above the terrain so players can glide in using their elytra. |

```yaml world-settings.yml theme={null}
spawn-height: 200
```

<Tip>
  A `spawn-height` above the terrain combined with `elytra-enabled: true` in `game-settings.yml` creates a classic Battle Royale drop-in experience — players glide down from above and choose their landing spot.
</Tip>