VoidProtectionLite — User Documentation

What VoidProtectionLite Does
VoidProtectionLite prevents players from dying when falling into the void by rescuing them with a smooth cinematic teleport instead of an instant glitchy TP.

Players experience:
Fade → short suspense → safe return
This makes rescues feel intentional, immersive, and polished.

Installation

1. Download the plugin .jar
2. Place it in your server’s /plugins folder
3. Restart the server
4. A config.yml file will be generated

Requirements

• Minecraft 1.19+
• Java 17+
• Paper / Spigot

⚙️ Basic Configuration
Open config.yml:

settings:
language: EN
detection-mode: BOTH
update-last-safe-every-ticks: 10
cooldown-seconds: 3
keep-inventory: true
keep-xp: true
allowed-gamemodes: ["SURVIVAL", "ADVENTURE"]

Detection Modes
Controls how the plugin detects a void fall:

Mode Description Recommended
DAMAGE Triggers only on void damage ⚠️ Less reliable
Y_THRESHOLD Triggers when player goes below Y level ✅
BOTH Uses both systems ⭐ Best default
detection-mode: BOTH

Multi-World Setup
You can configure each world separately:

worlds:
world:
enabled: true
void-y: -64
mode: LAST_SAFE
custom-location: ""

world_nether:
enabled: true
void-y: 0
mode: SPAWN

Per-world options:
Option Meaning
enabled Enable or disable protection
void-y Height at which rescue triggers
mode Rescue behavior
custom-location Custom teleport destination

Rescue Modes
Mode Behavior
LAST_SAFE Teleports to last safe ground
SPAWN Teleports to world spawn
CUSTOM Teleports to custom saved location

Setting a Custom Rescue Location
In-game command:

/voidprotect setspawn [world]

• If no world is provided → saves current world
• Player location becomes the rescue destination

Cooldown (Anti-Spam)
cooldown-seconds: 3
Cooldown prevents:

• rescue spam
• teleport loops
• message spam
• performance waste

Example:
If cooldown = 3, a player can only be rescued once every 3 seconds.

Allowed Game Modes
Only certain gamemodes can be rescued:

allowed-gamemodes: ["SURVIVAL", "ADVENTURE"]

Creative and Spectator are ignored by default.

Language & Messages
Set your server language:

settings:
language: EN

Supported languages:

• EN
• ES
• FR
• DE
• IT

Message example:
messages:
EN:
saved-from-void: "&bYou were rescued from the void."

Cinematic Rescue Behavior
By default, rescue includes:

• Sound effect
• Portal particles
• Short fade-to-black
• Delayed teleport
• Recovery message

This avoids a glitchy instant teleport feel.

Permissions
Permission Purpose
voidprotectionlite.admin Access admin commands
voidprotectionlite.bypass Player is NOT rescued
⚠️ Important — OP Behavior
Server operators (OP) are usually excluded because they often have bypass permissions.

If OP is not being rescued:

• Remove bypass permission
• Or test with a non-OP player

This is intentional, not a bug.

️ Admin Commands
Command Description
/voidprotect reload Reload config
/voidprotect status View plugin status
/voidprotect toggle <world> Enable/disable protection
/voidprotect setspawn [world] Save custom rescue location

MultiVerse Compatibility
VoidProtectionLite works with MultiVerse.

Each world can have:

• different void height
• different rescue mode
• enabled or disabled behavior
  New worlds must be added manually to config.yml.

BungeeCord Compatibility
VoidProtectionLite works on BungeeCord networks.

Important:
Install the plugin on each backend server, not on the proxy.

Each server has:

• its own config
• its own cooldowns
• independent world settings

Performance Notes
VoidProtectionLite is optimized:

• No heavy schedulers
• No unnecessary async tasks
• Tick-limited movement tracking
• Safe memory cleanup on player quit
• Designed for servers with many players

❓ Troubleshooting
Players are not being rescued
Check:

• They are not OP or bypassing
• World is enabled in config
• Gamemode is allowed
• void-y is correct
• Plugin is installed on the correct server

Rescue triggers too often
Increase cooldown:
cooldown-seconds: 5

Rescue happens too late / too early
Adjust:
void-y: -64

Best Practice Presets
Survival / SMP
mode: LAST_SAFE
cooldown-seconds: 3

SkyBlock
mode: SPAWN
cooldown-seconds: 2

Hardcore
mode: LAST_SAFE
cooldown-seconds: 6

Philosophy
VoidProtectionLite is designed to:

• do one job
• do it well
• avoid unnecessary features
• stay lightweight

Support
If you report a bug, include:

• Minecraft version
• Server type (Paper / Spigot)
• Config file
• Steps to reproduce