HVoidTeleport

HVoidTeleport

Never lose a player to the void again. When someone falls below a set height in one of your worlds, HVoidTeleport sends them to a location you choose, facing the direction you choose. They take no void damage and no fall damage.

Built for lobbies, hubs, skyblock, parkour and any world with open edges.

✨ Features

• Custom destination. X, Y, Z, yaw and pitch, in the same world or a different one.
• Per-world control. Turn it on only in the worlds you list. Each world can have its own spawn, height and message.
• Smart trigger height. auto follows the bottom of the world (0 on old versions, -64 on 1.18+), or use auto-10 or any number.
• Optional message. Show it in chat, the action bar or as a title, or turn it off. Supports & colors, &#RRGGBB hex colors (1.16+) and {player} / {world} placeholders.
• Optional sound on teleport.
• No damage. Void damage is cancelled, and fall distance and speed are reset on landing.
• Works in vehicles. Players are dismounted before the teleport.
• Bypass permission and ignored game modes (spectators are skipped by default).
• Lag-free on Paper and Folia. The target chunk loads in the background.
• Lightweight. No repeating tasks, no background threads, and nothing that grows as players come and go.

🖥️ Compatibility

One jar for Minecraft 1.0 up to the latest version. Newer features such as titles, action bars and hex colors are used when the server supports them, and fall back quietly when it doesn't. Requires Java 8 or newer.

⚙️ Configuration

Everything is in config.yml, and every option has a short comment. A defaults section applies to all worlds, and any world can override any single value:

defaults:
  trigger-y: auto
  target: { world: '', x: 0.5, y: 100.0, z: 0.5, yaw: 0.0, pitch: 0.0 }
  message:
    enabled: true
    type: CHAT        # CHAT, ACTIONBAR or TITLE
    text: '&bYou fell into the void and were saved!'

worlds:
  world:
    enabled: true
  lobby:
    target: { y: 120, yaw: 180 }
    message: { type: TITLE, text: '&cOops!' }
  '*':                # every other world
    message: { enabled: false }

If a value is wrong, the console tells you exactly which one, and the default is used instead.

🔧 Command & Permissions

📥 Installation

1. Drop the jar into your plugins folder.
2. Start the server once.
3. Edit plugins/HVoidTeleport/config.yml.
4. Run /hvt reload.