FAQ

Quick answers to common questions. If your question is not here, see Support.

Players cannot join. What is wrong?

The host world or region is probably not set. Run /zfb admin setworld <world>, then /zfb admin setbounds at two opposite corners of an open area. See Installation.

/zfb join says all matches are full, but none are running. Why?

Almost always your marked area is too small. Each match needs room for a full arena plus a buffer, so the two setbounds corners must be far apart, at least about 170 blocks in both directions with the default arena size. Re-run /zfb admin setbounds and make the box much wider. The plugin warns you the moment the area is too small and tells you the minimum size it needs. See Installation.

Do I have to redo the setup after updating the plugin?

No. The host world, the marked region, the lobby point, and all other settings are kept when you replace the jar, and your config.yml is migrated automatically when a new version adds settings. If the plugin ever says the world is not set right after an update, check the console for a line saying the host world has not loaded yet, and make sure you only replaced the jar and did not delete the plugins/zFrostBoats folder.

Can the host world be a world from Multiverse or another world manager?

Yes. The plugin finds the world by name whenever it needs it, so it does not matter if your world manager loads that world after zFrostBoats starts.

Do I need a resource pack?

No. The game uses normal concrete and concrete powder blocks for ground and trails, so it works with any client.

Do I have to build the arenas myself?

No. The plugin builds and clears every arena for you. You only pick one host world and mark a region once.

Can many matches run at the same time?

Yes. Matches share a single host world. The plugin places each one, and can stack them by height if floor space runs low. See Multiple Arenas.

The first start downloaded some files. Is that normal?

Yes. On the first run the plugin downloads a few small helper files for the default SQLite storage. Let it finish. This needs internet on the first start only. The separate MySQL driver is downloaded only if you switch storage to MySQL.

How do I change how slippery the boats are?

Edit ice-physics.decay-coefficient in config.yml. Higher is more slippery, lower is grippier. See Boats and Ice.

How do I change how a match is won?

Set game.win-condition in config.yml to LAST_STANDING, TIME_LIMIT, RACE_TO_PERCENT, or HYBRID, then run /zfb admin reload. See Win Conditions.

Are player stats saved?

Yes, automatically. By default they save to a local file, so there is nothing to set up. To share stats across servers, switch to MySQL on the Storage page.

Can I translate the messages?

Yes. Set general.language in the config and edit the file in the lang folder. English is the fallback. See Messages and Language.

Do I need FastAsyncWorldEdit?

No. It makes arenas build and clear faster, but the plugin works without it. See Installation.

A change to the config did nothing. Why?

Run /zfb admin reload after editing. Some changes, like storage settings, need a full server restart instead.

Does it work with PlaceholderAPI?

Yes. If PlaceholderAPI is installed, zFrostBoats adds %zfrostboats_...% placeholders for stats, live match info, and the top players. See Placeholders.

Which Minecraft versions are supported?

Spigot and Paper 1.21 and newer, on Java 21.