FAQ

General

What Minecraft version is supported?

Paper 26.1+. Paper 1.21.x also works. Spigot 1.21.x is supported (secondary).

What Java version is required?

Java 25+ on Paper 26.1+. Java 21+ on Paper 1.21.x.

Does SoapsFloor support Folia?

No.

What plugins are required?

SoapsCommon 1.3.0+ is required. WorldEdit is needed to build rooms. MythicMobs is optional.

Where is data stored?

plugins/SoapsFloor/. Rooms in rooms/, schematics in schematics/, player stats in data/.

Rooms and building

Schematics are not showing in the browser.

Add .schem files to plugins/SoapsFloor/schematics/. Run /sf reload. Check console for WorldEdit errors.

I cannot finish my room.

You need a starter box (pos1 and pos2), entry/exit points, and at least one floor. Run /sf wand status to check the current step.

Can I rename a room?

Yes: /sf wand rename <old> <new>. Room cannot be in use or under edit.

Floor drops misaligned.

Use the Starter Gap and Floor Gap adjusters in the editor with previews enabled. Defaults are in default-room-settings.

Gameplay

Players cannot join an active run.

allow-join-in-progress defaults to false. Set it to true globally or per room.

Room says full but only 2 players are inside.

Check max-players in global config and per-room settings from the wand editor.

Mobs are not spawning.

Confirm mob type is valid. For MythicMobs, use the exact internal ID. Check floor has spawn locations and spawn-delay-ticks is not stuck with a server lag spike.

Players keep their items on death.

Set dont-drop-inventory: true in config.yml if you want to keep inventory on death inside rooms.

GUI and commands

/sf menu says GUI is disabled.

Set gui.enabled: true in config.yml and reload.

Settings button missing from main hub.

The Settings item requires soapsfloor.admin.gui in gui.yml. Player feedback toggle is also available via /sf settings toggle feedback if you grant soapsfloor.player.settings.

Console cannot run player commands.

Only /sf reload and /sf help work from console. All gameplay and editor commands need a player.

Permissions

Builders cannot use the wand.

Grant soapsfloor.admin.wand or specific children like soapsfloor.admin.wand.create.

Admins cannot break blocks in rooms.

Grant soapsfloor.bypass.protection.

Performance

Large schematic preview crashes clients.

Lower editor-mode.schematic-preview-max-blocks (default 5000). Keep schematic-preview-glow: false.

Falling hazard causes lag.

Lower particle-density and raise render-interval in falling-hazard.

Rewards

Reward table not giving items.

Confirm table name with /sf setreward <room> <table>. Check rewards.yml syntax. Commands run as console: ensure economy/item plugins match your command format.

Weakness vote never appears.

Check weaknesses.yml → enabled: true. At least one weakness entry must have enabled: true.

Updates

Will my schematics be overwritten on update?

No. Bundled schematics only extract if the file does not already exist.

How do I reload after editing configs?

/sf reload reloads config, messages, gui, weaknesses, rewards, and schematic cache.