Troubleshooting
- Latest version
- 2.6.4
- Minecraft
- 26.1.x, 26.2.x, 26.3.x
- Platforms
- Spigot, Paper, Purpur
- Minimum Java version
- 25+
MysteryZones — Troubleshooting
- Plugin does not load: check Java 25, a compatible server API and the first startup error. Verify optional integration versions.
- No automatic zones: check Generating, enabled definitions, positive spawn_weight, online and per-world player minimums, disabled worlds, active limits and available locations. Strict distances, region filters, unloaded chunks or the border can leave no valid position.
- Zone does not activate: check PermissionRequired, the current shrinking radius, vertical range and spectator mode. A successful entry may already be consumed. Repeat activation needs multiple-entry enabled, leaving/re-entering and an expired cooldown.
- Missing definition: search logs for Skipping invalid zone. Check YAML indentation, required name/type, materials, effects and valid reward entries. COMMAND requires one nonblank command string.
- No money or region restriction: verify Vault plus an active economy provider, or WorldGuard plus WorldEdit. Check exact world/region names and reload after those worlds are available.
- High particle load or delayed effects: increase particle steps or render/terrain intervals gradually. Keep player checks responsive. Allowing LOAD_UNLOADED_CHUNKS can increase search cost. Test changes with new zones. Restarts remove temporary active zones.