HomeJavaModsWorldSafe
WorldSafe
WorldSafe
Lightweight, world-scoped protection for Bukkit, Spigot and Paper. Prevent selected entities and game mechanics from damaging your worlds, with separate options for cancelling explosions entirely or protecting blocks while keeping damage.

Current stable release: 1.1.0
English documentation | 中文文档 | Support and bug reports

Compatibility
Verification boundary: The 1.1.0 release passed 71 automated tests, API compatibility checks and release-JAR verification. API compilation is not real-server event testing across every version or custom dimension. The Tested Major MC Versions field is not a complete list of supported versions.

Installation and upgrading
  1. Stop the server. For upgrades, back up the existing WorldSafe JAR and configuration.
  2. Put WorldSafe-1.1.0.jar in the plugins directory and remove the old WorldSafe JAR from that directory. Do not keep multiple versions installed.
  3. Start the server, then edit plugins/WorldSafe/config.yml with the exact names of the worlds to protect.
  4. Use /worldsafe reload after configuration changes.
Existing configuration files are not overwritten. A failed reload keeps the previous working settings active.

Configuration
The default configuration includes only the main switch, the bStats switch, and creeper/TNT block-protection examples. Add other feature keys below as needed. Omitted features are disabled.
Code (Text):

enabled: true
enabled-bstats: true

creeperExplosionProtection:
  - world
  - world_nether
  - world_the_end

tntExplosionProtection:
  - world
  - world_nether
  - world_the_end
 
Set enabled-bstats to false to disable plugin metrics. To enable another protection, add its exact camel-case key followed by a list of world names. If you enable full explosion cancellation, you do not also need its block-protection counterpart.

Commands and permission
Command messages are in English. Documentation and configuration comments are available in English and Simplified Chinese.

Feature availability
Use the groups at or below your server version. Exact configuration keys are shown below.

Spoiler: Minecraft 1.8.8+
Direct explosion cancellation
  • bedExplosionCancel - Prevent bed explosions. Do not add overworld worlds to this option.
  • tntExplosionCancel - Fully prevent TNT and TNT minecart explosions.
  • creeperExplosionCancel - Fully prevent creeper explosions.
  • endCrystalExplosionCancel - Fully prevent end crystal explosions.
  • ghastExplosionCancel - Prevent ghast fireball explosions and damage.
  • witherExplosionCancel - Fully prevent wither and wither skull explosions.
Protect blocks while keeping damage
  • bedExplosionProtection - Protect surrounding blocks; the bed itself may still disappear. Meaningful pre-explosion snapshots take precedence. Without one, a two-second interaction cache associates both verified bed halves using facing and head/foot data; without that data, only the clicked position is tracked. Custom dimension bed rules are not inferred from datapacks.
  • tntExplosionProtection - Protect blocks from TNT and TNT minecart explosions.
  • creeperExplosionProtection - Protect blocks from creeper explosions.
  • endCrystalExplosionPrevention - Protect blocks from end crystal explosions.
  • ghastExplosionProtection - Protect blocks from ghast fireballs while keeping damage.
  • witherExplosionProtection - Protect blocks from withers and wither skulls.
Other map protections
  • cropTrampleProtection - Prevent farmland from being trampled into dirt.
  • dragonEggTeleportationPrevention - Prevent dragon eggs from teleporting when touched.
  • fireSpreadPrevention - Prevent fire from spreading and burning nearby blocks.
  • fireIgnitionPrevention - Prevent fireballs, lightning, explosions, end crystals and burning arrows from igniting blocks.
  • enderDragonBlockDestructionProtection - Prevent the Ender Dragon from destroying blocks.
  • enderManBlockPickupProtection - Prevent endermen from picking up or moving blocks.
  • silverfishBlockChangeProtection - Prevent silverfish from entering or breaking infested blocks.
  • rabbitCropEatingProtection - Prevent rabbits from eating crops.
  • sheepGrassEatingProtection - Prevent sheep from eating grass.
  • villagerCropModificationProtection - Prevent villagers from harvesting or planting crops.
  • mobDoorBreakProtection - Prevent mobs from breaking doors.
  • snowGolemSnowTrailPrevention - Prevent snow golems from leaving snow trails.

Spoiler: Minecraft 1.13+
  • phantomDamagePrevention - Prevent phantoms from damaging players or other entities.

Spoiler: Minecraft 1.14+
  • ravagerBlockDestructionProtection - Prevent ravagers from destroying blocks.
  • foxBerryHarvestProtection - Prevent foxes from harvesting sweet berries.
  • witherRoseFormationPrevention - Prevent wither roses from forming.

Spoiler: Minecraft 1.16+
  • respawnAnchorExplosionCancel - Prevent charged respawn anchors from exploding outside the Nether.
  • respawnAnchorExplosionPrevention - Protect blocks from respawn anchor explosions while keeping damage.

Spoiler: Minecraft 1.20.3+
  • decoratedPotProjectileProtection - Prevent projectiles from breaking decorated pots.

Spoiler: Minecraft 1.21+
  • windChargeBlockDestructionProtection - Protect decorated pots, chorus flowers and pointed dripstone from player and breeze wind charges through explosion lists and direct-hit block-change events, while keeping impact damage and knockback. Does not require decoratedPotProjectileProtection and does not cancel the entire projectile hit. Coverage depends on events exposed by the server; a path without native destruction is not evidence of protection.
  • breezeWindChargeImpactCancel - Cancel breeze wind-charge impacts without affecting player-fired wind charges. On non-Paper servers this is best-effort: damage or knockback may remain because Spigot does not expose the required early explosion hook.
  • weavingCobwebFormationPrevention - Prevent the weaving effect from creating cobwebs.

Spoiler: Minecraft 26.2+
  • sulfurCubeExplosionCancel - Prevent sulfur cube explosions caused by consumed TNT. On non-Paper servers this is best-effort: damage or knockback may remain because Spigot does not expose the required early explosion hook.
  • sulfurCubeExplosionProtection - Protect blocks from sulfur cube explosions while keeping damage.

Support and source
For bug reports, include your WorldSafe version, exact server software/version, relevant configuration and steps to reproduce. Remove private information before sharing logs.
Report an issue | Source code | 1.1.0 release notes and checksums

[​IMG]

Developed by Eric.乐乐 / 追求at. Licensed under the MIT License.

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

WorldSafe is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 70 times (via Spigot). Download it and open it directly in the game.

Explore more