> 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/ladder-setup.md).

# Ladder Setup

Detailed ladder creation and setup workflow.

This guide is written as a safe step-by-step flow for first-time admins.

## Before you begin

Make sure:

* You can run `/setup`
* You already set lobby with `/practice lobby set`

## Default ladders created automatically

These are generated in `plugins/ZonePracticePro/ladders/`:

`archer`, `axe`, `battlerush`, `bedwars`, `boxing`, `bridges`, `builduhc`, `cart`, `crystal`, `diamondpotion`, `fireball`, `gapple`, `mace`, `mlgrush`, `netheritepotion`, `pearlfight`, `sg`, `skywars`, `soup`, `spearelytra`, `spearmace`, `spleef`, `sumo`, `sword`, `tntsumo`.

You can edit these or create new ladders.

## Step 1: Create a ladder

Run:

* `/ladder create <name>`

A ladder type selector GUI opens.

<figure><img src="https://644008262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3zbH5QR7hFYlPHpm5cin%2Fuploads%2FkNoSyVmFs9Nx1lO7i2bO%2Fezgif.com-reverse-2.gif?alt=media&amp;token=2b935e8e-0d46-4d2a-91fd-3e9f02604311" alt="Ladder type selector"><figcaption><p>Ladder type selector</p></figcaption></figure>

## Step 2: Choose a ladder type

Available types include:

* `BASIC`
* `BUILD`
* `SUMO`
* `TNT_SUMO`
* `BOXING`
* `PEARL_FIGHT`
* `SPLEEF`
* `SKYWARS`
* `BEDWARS`
* `FIREBALL_FIGHT`
* `MLG_RUSH`
* `BRIDGES`
* `BATTLE_RUSH`

After choosing type, the ladder setup GUI opens.

<figure><img src="https://644008262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3zbH5QR7hFYlPHpm5cin%2Fuploads%2FDIHqgP9l2glngAbUvPVR%2Fezgif.com-reverse-5.gif?alt=media&amp;token=8f579fb7-8ecb-4cc3-bcf6-95d916d59a50" alt="Ladder setup main GUI"><figcaption><p>Ladder setup GUI</p></figcaption></figure>

## Step 3: Set icon and display name

1. Hold the item you want as icon.
2. (Optional) Rename it with `/practice rename <name>`.
3. Run `/ladder set icon <ladder>`.

Tip: the item display name becomes the ladder display name in menus.

## Step 4: Set inventory and effects

Set inventory:

* `/ladder set inventory <ladder>`

Set effects:

* `/ladder set effect <ladder>`

Then adjust ladder settings in GUI.

<figure><img src="https://644008262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3zbH5QR7hFYlPHpm5cin%2Fuploads%2FVeQPwxQnBMFwumKa3aUT%2Fezgif.com-reverse-6.gif?alt=media&amp;token=074083cf-49f7-4e89-b30f-45d8e8fcb189" alt="Ladder settings GUI"><figcaption><p>Ladder settings</p></figcaption></figure>

## Step 5: Assign match types and final settings

In ladder settings GUI:

* Enable at least one match type
* Configure ranked/unranked behavior
* Configure type-specific options (for example SkyWars loot, Boxing hit goal)

### Per-ladder configurable settings

* **Hearts / Max Health** — custom health per ladder (`ladder max health`)
* **Match types** — select which match types are available (Duel, Party FFA, etc.)
* **Ender pearl cooldown** — override the global cooldown per ladder
* **Wind charge cooldown** — override per ladder
* **Golden apple cooldown** — override per ladder
* **Firework rocket cooldown** — override per ladder
* **Ranked/unranked** — enable or disable per weight class
* **Build limit** — override default arena build limit

Ladder type-specific options:

| Type            | Extra options                                    |
| --------------- | ------------------------------------------------ |
| BOXING          | Custom attack cooldown, hit goal                 |
| SKYWARS         | Chest loot configuration                         |
| BEDWARS         | Bed break mechanics                              |
| BRIDGES         | Regenerating arrow settings                      |
| AXE             | Shield stun mechanics                            |
| TNT\_SUMO       | Explosion physics (radius, multipliers, falloff) |
| FIREBALL\_FIGHT | Fireball speed, yield, explosion knockback       |

## Step 6: Enable and test

Before enabling, verify:

* Icon is set
* Inventory is set
* Match type is set
* Type-specific required options are complete

Then run test fights.

## Management commands

* `/ladder info <ladder>`
* `/ladder freeze <ladder>`
* `/ladder stop <ladder>`
* `/ladder delete <ladder>`

## Important safety notes

* Edit ladders while disabled whenever possible.
* If players are currently fighting, use `/ladder stop <ladder>` before major edits.

## Troubleshooting

If `/ladder set icon` fails:

* Hold a real item (not air)
* Make sure it has a display name

If inventory does not save:

* Confirm ladder is not enabled
* Re-run `/ladder set inventory <ladder>` and save properly