Configuration

Last updated Jul 6, 2026

Main file: plugins/SoapsFloor/config.yml. Messages and GUI layouts are separate files.

File	Purpose
`config.yml`	Gameplay, protection, hazards, editor
`messages.yml`	MiniMessage text
`gui.yml`	Menu layouts
`weaknesses.yml`	Weakness voting
`rewards.yml`	Reward tables

Reload all with /sf reload.

General

Key	Default	Description
`gui.enabled`	`true`	Master switch for inventory GUIs
`dont-drop-inventory`	`false`	Keep inventory and XP on death inside rooms

Applied to new rooms. Each room can override these in its saved YAML or via the wand editor.

Key	Default	Description
`max-floors-per-room`	`50`	Floor cap per room
`void-y-level`	`-64`	Y level that fails the run
`starter-to-floor-gap`	`5`	Blocks between starter and floor 1
`floor-to-floor-gap`	`3`	Blocks between floors
`countdown-seconds`	`10`	Pre-drop countdown in starter
`countdown-sound`	`BLOCK_NOTE_BLOCK_PLING`	Tick sound
`countdown-sound-volume`	`1.0`	Tick volume
`countdown-sound-pitch`	`1.0`	Tick pitch (rises each tick)
`countdown-final-sound`	`ENTITY_ENDER_DRAGON_GROWL`	Sound at GO
`countdown-final-volume`	`1.0`	Final sound volume
`countdown-final-pitch`	`1.2`	Final sound pitch
`floor-drop-delay`	`3`	Seconds after mob clear before drop
`auto-start-enabled`	`true`	Start flow when a player enters starter
`waiting-timer-enabled`	`true`	Lobby timer before lock
`waiting-timer-seconds`	`30`	Lobby wait time
`min-players`	`1`	Minimum players to lock (`0` = disabled)
`max-players`	`4`	Session cap (`0` = unlimited)
`allow-join-in-progress`	`false`	Join active runs

Locked when the waiting timer ends. Per-room opt-out: party-scaling.enabled: false in room settings YAML.

Key	Default	Description
`enabled`	`true`	Global party scaling
`base-players`	`1`	Scaling starts above this count
`lock-at-room-lock`	`true`	Snapshot player count at lock
`mobs.extra-min-per-player`	`0`	Extra min mobs per extra player
`mobs.extra-max-per-player`	`1`	Extra max mobs per extra player
`mobs.count-multiplier-per-player`	`0.15`	Mob count multiplier
`health.multiplier-per-player`	`0.20`	HP multiplier per extra player
`health.apply-to-vanilla`	`true`	Scale vanilla mob HP
`health.mythic-level-per-player`	`1`	Mythic level bump per player
`rewards.roll-multiplier-per-player`	`0.10`	Extra reward roll chance

Players with soapsfloor.bypass.protection skip protection.

Key	Default	Description
`pvp-enabled`	`false`	PvP inside dungeons

Admins with soapsfloor.admin skip these rules.

Key	Default	Description
`disable-elytra`	`true`	Block elytra flight
`block-ender-pearls`	`true`	Block ender pearls
`block-chorus-fruit`	`true`	Block chorus fruit teleport
`block-flying`	`true`	Block creative flight
`fall-damage-multiplier`	`0.0`	`0.0` = none, `1.0` = vanilla
`remove-invisibility-on-join`	`true`	Strip invisibility on join
`force-survival`	`true`	Force survival; restore gamemode after run
`death-behavior`	`respawn`	`kick`, `spectate`, or `respawn`
`blacklisted-items`	`ENDER_EYE`	Materials blocked in sessions

See Falling Hazard for behavior details.

Key	Default	Description
`teleport-to-spawn`	`true`	Teleport winners to world spawn
`teleport-delay`	`3`	Seconds before teleport
`title-enabled`	`true`	Show victory title
`title`	MiniMessage	Title text
`subtitle`	MiniMessage	Subtitle (`{time}` placeholder)
`title-fade-in`	`10`	Title fade in ticks
`title-stay`	`70`	Title stay ticks
`title-fade-out`	`20`	Title fade out ticks
`sound`	`entity.player.levelup`	Victory sound
`sound-volume`	`1.0`	Sound volume
`sound-pitch`	`1.0`	Sound pitch
`victory-particle`	`FIREWORK`	Particle effect
`victory-particle-count`	`100`	Particle count
`reward-commands`	list	Console commands on win

Victory placeholders: {player}, {room}, {time}, {kills}, {floors}.

Key	Default	Description
`enable-previews`	`true`	Ghost block previews
`enable-glow-outline`	`true`	Glow on previews
`preview-view-range`	`1.0`	Chunk render distance
`show-particle-borders`	`false`	Particle borders
`particle-type`	`END_ROD`	Border particle
`particle-interval`	`10`	Border update ticks
`schematic-preview-max-blocks`	`5000`	Max preview blocks
`schematic-preview-blocks-per-tick`	`30`	Preview spawn rate
`schematic-preview-glow`	`false`	Glow on schematic preview
`wand-selection.show-particles`	`true`	Selection outline
`wand-selection.max-selection-volume`	`100000`	Max selection volume
`wand-selection.max-selection-dimension`	`200`	Max axis length
`restore-location`	`true`	Restore position on editor exit
`restore-gamemode`	`true`	Restore gamemode on exit
`prevent-block-break`	`true`	Block break in editor
`prevent-block-place`	`true`	Block place in editor
`show-actionbar-hints`	`true`	Editor actionbar hints
`actionbar-interval`	`60`	Hint interval ticks

Key	Default	Description
`floor-removal-inset`	`1`	Blocks kept on floor edge at drop
`spawn-height-offset`	`2.0`	Blocks above floor for mob spawn

Not for production. Toggle only in config, then /sf reload.