Examples

Practical setup snippets for common server setups.

Solo-friendly dungeon

# config.yml
default-room-settings:
  min-players: 0
  max-players: 1
  waiting-timer-enabled: false
  auto-start-enabled: true
  countdown-seconds: 5

Players join and the run starts immediately.

4-player co-op with scaling

default-room-settings:
  min-players: 2
  max-players: 4
  waiting-timer-seconds: 45

party-scaling:
  enabled: true
  base-players: 1
  max-extra-players: 0
  mobs:
    extra-max-per-player: 1
    count-multiplier-per-player: 0.15
  health:
    multiplier-per-player: 0.20
    apply-to-vanilla: true
    apply-to-mythic: true

Hard mode with falling hazard

Enable Falling Hazard on the room in the wand (magma cream), set a lower fall-interval for pressure, and higher damage. Shift-click Particle to type a Bukkit name if needed. Example room YAML:

falling-hazard:
  enabled: true
  start-mode: after_delay
  start-delay-seconds: 5
  speed: 1.0
  fall-interval: 60
  damage: 4.0
  particle: SOUL_FIRE_FLAME
  hit-mode: damage
  above-mode: instant_kill

# config.yml
anti-cheese:
  death-behavior: kick
  blacklisted-items:
    - ENDER_EYE
    - TOTEM_OF_UNDYING

Use death-behavior: respawn if you want hazard deaths to retry on the same floor instead of ending the run for that player.

Victory rewards with economy

victory:
  teleport-to-exit: true
  teleport-delay: 5
  reward-commands:
    - "eco give {player} 250"
    - "broadcast:&e{players} &7cleared &6{room} &7in &a{time}&7 · &c{total_kills} &7kills"
    - "message:&7Your kills this run: &a{kills}"

Per-room reward table

1. Define table in rewards.yml:

tables:
  nether_dungeon:
    rolls: 2
    unique-rolls: true
    entries:
      - guaranteed: true
        message: "<#9ca3af>Clear bonus.</#9ca3af>"
        commands:
          - "eco give {player} 50"
      - weight: 60
        commands:
          - "eco give {player} 100"
      - weight: 40
        commands:
          - "give {player} blaze_rod 3"

1. Assign after building the room:

/sf setreward nether_dungeon nether_dungeon

Disable weaknesses for casual runs

# weaknesses.yml
enabled: false

MythicMobs floor boss

In the wand Floor Editor, open Mob settings for floor 5, then type in chat:

mythicmobs:DungeonBoss

Set min and max mobs to 1 with the hotbar adjusters.

Custom floor start command

Use Custom Commands on floor 3:

effect give {player} strength 30 1
title {player} title {"text":"Boss Floor","color":"red"}

GUI disabled server

gui:
  enabled: false

Players use:

/sf list
/sf join arena1
/sf leave
/sf help

Debug testing room

debug-mode:
  enabled: true
  instant-start: true
  instant-floor-drop: true
  instant-mob-spawn: true

Run /sf debug in game to confirm status. Turn off before production.

Sample room build session

/sf wand create crypt
# Select starter box, set entry/exit
# Shift+right-click wand → pick ROOM schematic → 5 layers
# Room Settings (nether star): max players 4, countdown 15 (default is 3)
# Floor Editor / Falling Hazard as needed
/sf wand finish
/sf setreward crypt hard
/sf join crypt