Locked Floors

Free floors come first. Locked floors stack after them and can be bought in the lobby before the run starts.

Locks live on the floor slot, not on pack variants. Assigning a schematic pack to a locked floor still keeps that floor after free floors (normalizeFreeLockedOrder when adding layers). Runtime still rolls the pack by weight for that slot.

Staff how-to

1. In wand Floor Editor → select a floor → Access & locks.
2. Set currency type (Vault / SoapsAdmin / sigils) and/or item costs; optional Boss floor label.
3. Save the room. Costs are stored on the room YAML unlock block (and per-floor lock data from the editor).
4. Have a player host a lobby and buy floors to verify balances and items.

Player / host how-to

1. First joiner is the host.
2. In the lobby, open locked floors one by one (pays currency and/or items from the host).
3. Unbought locked floors are skipped when the run starts.
4. If auto-start is off, host runs /sf start after buying.
5. If the host leaves, a random remaining online non-spectator becomes host.

How a run uses locks

1. The host (first player to join) opens locked floors one by one in the lobby.
2. Each purchase takes the configured currency and/or items from the host.
3. Floors that were not bought are skipped.
4. The run ends after free floors plus the locked floors that were bought.
5. Instant-start debug uses free floors only.
6. When auto-start is off, the host runs /sf start after buying.

Floor Editor (wand hotbar)

Right-click the Floor Editor comparator to open the hub.

1. Select a floor in the top row.
2. Open Access & locks, Mob settings, Countdown, or Custom commands.
3. Use Back to return to the hub, then to the wand.

Boss floor is a label for climax floors. It does not change costs or mobs by itself.

Currency sources

Source	When it appears	Notes
SoapsAdmin	Economy module enabled	Lists every custom economy id
SoapsQuest sigils	SoapsQuest installed	Single sigil balance
Vault	Vault + economy provider	Primary Vault money
Items only	Always	No economy plugin required

Room YAML

unlock:
  currency-type: soapsadmin   # vault | soapsadmin | sigils
  currency-id: tokens         # required for soapsadmin
  currency-amount: 500
  items:
    - material: DIAMOND
      amount: 3

currency-type and currency-amount are both required for a money/sigil cost. SoapsAdmin also needs currency-id.

Host leave

If the host leaves, a random remaining online non-spectator becomes host. If nobody is left, the session ends.

---

Defaults: Default config.yml · Intent: Want locked floors · Soft deps: Integrations