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
  mobs:
    extra-max-per-player: 1
    count-multiplier-per-player: 0.15
  health:
    multiplier-per-player: 0.20

Hard mode with falling hazard

falling-hazard:
  enabled: true
  speed: 1.5
  fall-interval: 60
  damage: 4.0
  particle: SOUL_FIRE_FLAME

anti-cheese:
  death-behavior: kick
  blacklisted-items:
    - ENDER_EYE
    - TOTEM_OF_UNDYING

Victory rewards with economy

victory:
  teleport-to-spawn: true
  teleport-delay: 5
  reward-commands:
    - "eco give {player} 250"
    - "broadcast <gold>{player}</gold> cleared <yellow>{room}</yellow> in <white>{time}</white>!"

Per-room reward table

1. Define table in rewards.yml:

tables:
  nether_dungeon:
    rolls: 2
    entries:
      - 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 editor, select floor 5, open Mob Settings, 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 room list
/sf room arena1
/sf room 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
# Adjust max players to 4, countdown to 15
/sf wand finish
/sf setreward crypt hard
/sf room crypt