> For the complete documentation index, see [llms.txt](https://zone-developement.gitbook.io/zonepractice-pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zone-developement.gitbook.io/zonepractice-pro/setup-guides/arena-setup.md).

# Arena Setup

Detailed arena creation and setup workflow.

Set up ladders first, then arenas.

## Step 1: Create a new arena

Run:

* `/arena create <name>`

Pick arena type in the GUI.

<figure><img src="https://644008262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3zbH5QR7hFYlPHpm5cin%2Fuploads%2Fg7nfgYrvoTPcvefuTlQc%2FScreenshot%202024-10-10%20at%2022.01.02.png?alt=media&amp;token=2b0f4912-0cb9-4c89-bf3e-01a461eae6cb" alt="Arena type selector"><figcaption><p>Arena type selector</p></figcaption></figure>

After type selection, arena setup GUI opens.

<figure><img src="https://644008262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3zbH5QR7hFYlPHpm5cin%2Fuploads%2Ff2CBLxVXeKtJ50bYEiFx%2FScreenshot%202024-10-10%20at%2022.09.25.png?alt=media&amp;token=49008ae7-919c-4fc1-bcb6-05379915c612" alt="Build arena setup GUI"><figcaption><p>Build arena setup</p></figcaption></figure>

<figure><img src="https://644008262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3zbH5QR7hFYlPHpm5cin%2Fuploads%2FKQHIrx0EGUxGMvJF9YTE%2FScreenshot%202024-10-10%20at%2022.14.17.png?alt=media&amp;token=cfa5d142-0786-420b-98ad-dbb3752885ac" alt="FFA arena setup GUI"><figcaption><p>FFA arena setup</p></figcaption></figure>

## Step 2: Set arena icon

1. Hold item for icon.
2. (Optional) Rename item with `/practice rename <name>`.
3. Run `/arena set icon <arena>`.

## Step 3: Build/paste map into `arenas` world

Use your build tool (FAWE recommended), then run setup.

## Step 4: Start setup wand mode

Run:

* `/arena setup <arena>`

You receive a setup wand. Use it to configure region and points.

Wand usage basics:

* Left/Right click to set positions depending on current mode
* Shift + click to switch setup mode
* Drop wand (Q) to exit

For region selection, make sure the whole map is inside your 2 corners.

<div align="left"><figure><img src="https://644008262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3zbH5QR7hFYlPHpm5cin%2Fuploads%2Fd7MtyTmWMWzaHQ8k9UjT%2F68747470733a2f2f776f726c64656469742e656e67696e656875622e6f72672f656e2f6c61746573742f5f696d616765732f6375626f69642e706e67.webp?alt=media&amp;token=e0a37c46-9e94-4489-be45-bbefe51e5046" alt="Cuboid corner selection"><figcaption><p>Corner selection example</p></figcaption></figure></div>

## Step 5: Assign ladder types/ladders

In the arena setup GUI:

1. Assign allowed ladder types.
2. Review auto-assigned ladders.
3. Remove any ladder you do not want in this arena.

<div data-full-width="true"><figure><img src="https://644008262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3zbH5QR7hFYlPHpm5cin%2Fuploads%2FoSTNUog85sl8bjfutGNf%2FScreenshot%202023-09-24%20at%2011.07.50.png?alt=media&amp;token=72f2e9a2-f5af-44b3-bb7c-dfa9fb277334" alt="Arena ladder type assignment" width="563"><figcaption><p>Assign ladder types</p></figcaption></figure></div>

<figure><img src="https://644008262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3zbH5QR7hFYlPHpm5cin%2Fuploads%2FhuJ7uid2fw3kF7LMW4S4%2FScreenshot%202023-09-24%20at%2011.16.11.png?alt=media&amp;token=921b38b1-3804-459f-97bf-e4b920d2b277" alt="Arena ladder assignment list" width="563"><figcaption><p>Fine-tune ladder assignments</p></figcaption></figure>

## Step 6: Type-specific setup

If your arena is bed-based:

* Set required bed positions through setup modes

If your arena is portal-based:

* Set required portal regions through setup modes

## Step 7: Optional advanced settings

### Portal Protection

**Command:** `/arena set portalprot <arena> <radius>`

Protects the area around portals (goal zones) on Portal-type maps (Bridge, Pit, etc.).

**Radius:** 0–20 blocks from the portal center.

**What it prevents inside the protected zone:**

* Block placing and breaking
* Bucket emptying (lava/water)
* Liquid flow into the area

This stops players from blocking the opponent's portal or griefing it with lava/water.

### Other settings

* Side build limit: `/arena set sidebuildlimit <arena> <value>`
* Party FFA center: `/arena set partyffacenter <arena>`

### Making arena copying faster

By default, ZonePractice copies arenas using its own built-in method. For large maps, you can speed this up significantly:

1. **Enable fast copy** — set `ARENA.FAST-COPY.ENABLED: true` in config.yml. This uses more server resources but copies much faster.
2. **With FAWE** — if you have FastAsyncWorldEdit installed, set `ARENA.FAST-COPY.USE-FAWE: true` for even faster performance.

```yaml
ARENA:
  FAST-COPY:
    USE-FAWE: true      # requires FAWE plugin
    ENABLED: true       # enables fast copy mode
    MULTIPLIER: 10      # speed multiplier (higher = faster but more lag)
```

Start with `MULTIPLIER: 10` and increase carefully if your server can handle it.

## Step 8: Enable and test

Enable only after:

* Icon set
* Region corners set
* Spawn points set
* Required bed/portal points set (if needed)
* At least 1 compatible ladder assigned

Then run test matches.

## Build arena copies

Build arenas use async copy generation in `arenas_copy`.

<figure><img src="https://644008262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3zbH5QR7hFYlPHpm5cin%2Fuploads%2FOmkhLZWySbkYKKUQPFhB%2Fezgif.com-reverse.gif?alt=media&amp;token=0a999ab9-2d27-4052-a3b0-2e8fdb755bc6" alt="Arena asynchronous copy creation"><figcaption><p>Asynchronous arena copy creation</p></figcaption></figure>

## Management commands

* `/arena info <arena>`
* `/arena teleport <arena>`
* `/arena enable <arena>`
* `/arena disable <arena>`
* `/arena freeze <arena>`
* `/arena stop <arena>`
* `/arena delete <arena>`

## Troubleshooting

If setup wand does not appear:

* Confirm arena is disabled
* Confirm you have `zpp.setup`
* Re-run `/arena setup <arena>`

If arena cannot be enabled:

* Re-check required points for this arena type
* Re-check ladder assignment
* Confirm region corners are valid