\n—
\n<\/p>\n
# \ud83d\udcdd Overview<\/p>\n
VoidSpawn is a high-performance Paper\/Spigot plugin designed to automatically teleport players to safety when they fall into the void. The plugin monitors each player’s Y-coordinate and instantly teleports them to a designated spawn point when they fall below a configurable threshold.<\/p>\n
### How It Works<\/p>\n
1. Players fall below the configured Y-level threshold for their world
\n2. The plugin instantly detects the void fall
\n3. Players are teleported to a custom spawn point (set via `\/vs setspawn`)
\n4. If no custom spawn exists, players are sent to the world’s default spawn
\n5. A smooth fade animation and sound effect enhance the experience<\/p>\n
—<\/p>\n
## \u2728 Key Features<\/p>\n
### \ud83c\udfaf Core Functionality
\n– **Multi-World Support** – Configure unique Y-levels for each world
\n– **Custom Spawn Points** – Set specific teleport locations with exact orientation
\n– **Default Spawn Fallback** – Automatic fallback to world spawn if custom spawn not set
\n– **Optimized Detection** – Lag-free performance even with many players<\/p>\n
### \ud83c\udfa8 Player Experience
\n– **Smooth Fade Effect** – 2-second fade-in\/fade-out screen transition
\n– **Customizable Messages** – Full color code support with `&` formatting
\n– **Sound Effects** – Configurable teleport sounds
\n– **Cooldown System** – Prevents teleport spam and exploitation<\/p>\n
### \ud83d\udee1\ufe0f Administration
\n– **Permission-Based Access** – Granular control over commands and bypass
\n– **Hot Reload** – Update configuration without server restart
\n– **Per-World Configuration** – Enable\/disable void protection per world
\n– **Minecraft 1.20+** – Full compatibility with latest versions<\/p>\n
—<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
### Requirements
\n– Minecraft Server: Paper\/Spigot\/folia 1.20 or newer
\n– Java: 17 or higher<\/p>\n
### Setup Steps<\/p>\n
1. Download `VoidSpawn-1.0.0.jar`
\n2. Place the file in your server’s `plugins\/` folder
\n3. Restart your server
\n4. Configure the plugin (files created automatically):
\n – `plugins\/VoidSpawn\/config.yml`
\n – `plugins\/VoidSpawn\/spawns.yml`<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands<\/p>\n
### Administrator Commands<\/p>\n
| Command | Description | Permission Required |
\n|———|————-|———————|
\n| `\/vs setspawn` | Sets the void spawn point for current world at your location and facing direction | `voidspawn.admin` |
\n| `\/vs reload` | Reloads the configuration from disk | `voidspawn.admin` |<\/p>\n
**Alias:** `\/voidspawn` works identically to `\/vs`<\/p>\n
—<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
| Permission Node | Description | Default |
\n|—————-|————-|———|
\n| `voidspawn.admin` | Access to all `\/vs` commands | OP only |
\n| `voidspawn.bypass` | Exempts player from void detection (useful for testing) | OP only |<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### config.yml Structure<\/p>\n
“`yaml
\n# Fade Effect Settings
\nfade-effect-enabled: true # Enable\/disable screen fade animation<\/p>\n
# Sound Settings
\nteleport-sound: ENTITY_ENDERMAN_TELEPORT # Sound played on teleport (use ‘none’ to disable)<\/p>\n
# Cooldown Settings
\nteleport-cooldown: 3 # Seconds before player can be teleported again<\/p>\n
# Messages (supports & color codes)
\nteleport-message: “&aYou have been teleported to safety!”
\nspawn-not-set-message: “&eNo custom spawn set. Teleporting to world spawn…”
\ncooldown-message: “&cPlease wait before being teleported again.”<\/p>\n
# World-Specific Settings
\nworlds:
\n world:
\n y-level: -64 # Players below this Y-level are teleported
\n enabled: true # Enable\/disable void protection for this world
\n world_nether:
\n y-level: -64
\n enabled: true
\n world_the_end:
\n y-level: -64
\n enabled: true
\n“`<\/p>\n
### Configuration Options<\/p>\n
#### Visual Effects
\n– **fade-effect-enabled**: `true\/false`
\n – Enables smooth screen fade during teleportation
\n – Duration: 2 seconds total (1s fade out, 1s fade in)<\/p>\n
#### Audio Settings
\n– **teleport-sound**: Sound name or `none`
\n – Default: `ENTITY_ENDERMAN_TELEPORT`
\n – Must be valid Bukkit Sound enum name
\n – Set to `none` to disable sound<\/p>\n
#### Anti-Spam Protection
\n– **teleport-cooldown**: Integer (seconds)
\n – Prevents repeated rapid teleportations
\n – Default: 3 seconds
\n – Helpful for preventing abuse<\/p>\n
#### World Configuration
\nFor each world, configure:
\n– **y-level**: Y-coordinate threshold (players below this are teleported)
\n– **enabled**: `true\/false` to toggle void protection<\/p>\n
—<\/p>\n
## \ud83d\uddfa\ufe0f Setting Up Spawn Points<\/p>\n
### Initial Setup (Required)<\/p>\n
1. Ensure you have OP status or `voidspawn.admin` permission
\n2. Enter the world you want to configure
\n3. Stand at the exact location where players should spawn
\n4. Face the direction players should be facing
\n5. Execute: `\/vs setspawn`
\n6. Confirmation message will appear<\/p>\n
### What Gets Saved?
\n– World name
\n– X, Y, Z coordinates
\n– Yaw (horizontal rotation)
\n– Pitch (vertical rotation)<\/p>\n
### Without Custom Spawn
\nIf no custom spawn is set via `\/vs setspawn`, players will:
\n1. Receive the `spawn-not-set-message`
\n2. Be teleported to the world’s default spawn point
\n3. Still benefit from void protection<\/p>\n
—<\/p>\n
## \ud83d\udd27 Advanced Usage<\/p>\n
### Multiple Worlds
\nConfigure different Y-levels for each world type:<\/p>\n
“`yaml
\nworlds:
\n survival_world:
\n y-level: -64
\n enabled: true
\n creative_world:
\n y-level: -128
\n enabled: false # Disable in creative
\n mining_world:
\n y-level: -64
\n enabled: true
\n“`<\/p>\n
### Custom Messages
\nUse Minecraft color codes with `&`:<\/p>\n
“`yaml
\nteleport-message: “&b&lVOID RESCUE &r&7\u00bb &aYou’ve been saved!”
\nspawn-not-set-message: “&e&l\u26a0 &7Using default spawn point…”
\ncooldown-message: “&c&l\u2716 &7Wait {cooldown}s before next teleport”
\n“`<\/p>\n
### Performance Tuning
\nThe plugin is optimized by default, but you can:
\n– Disable fade effects for minimal overhead
\n– Adjust cooldowns to reduce event frequency
\n– Disable in creative\/spectator worlds<\/p>\n
—<\/p>\n
## \ud83d\udcca Performance Information<\/p>\n
VoidSpawn is built with performance as a priority:<\/p>\n
– **Optimized Event Handling**: Only processes relevant player movement events
\n– **Memory Efficient**: Automatic cleanup on player disconnect
\n– **No Tick Lag**: Asynchronous processing where possible
\n– **Minimal Overhead**: Typically <1% CPU usage even with 100+ players\n\n### Best Practices\n- Set appropriate Y-levels (don't set too high)\n- Use reasonable cooldowns (3-5 seconds recommended)\n- Disable in worlds where void protection isn't needed\n\n---\n\n## \u2753 Troubleshooting\n\n### Players aren't being teleported\n- Check if void protection is enabled for that world in config.yml\n- Verify the Y-level is set correctly\n- Ensure players don't have `voidspawn.bypass` permission\n- Check server console for errors\n\n### Spawn point not working\n- Confirm spawn was set with `\/vs setspawn`\n- Check `spawns.yml` for the world entry\n- Try setting the spawn again\n- Verify world name matches exactly\n\n### Performance issues\n- Disable fade effects if experiencing lag\n- Increase cooldown duration\n- Check for conflicting plugins\n- Review server TPS with `\/tps` command\n\n---\n\n## \ud83d\udcde Support\n\nFor bug reports, feature requests, or general support, please contact the development team.\n<\/p>\n","protected":false},"excerpt":{"rendered":"
Teleports players to spawn when they fall into the void. Simple and lightweight plugin designed to prevent void deaths and keep gameplay smooth.<\/p>\n","protected":false},"featured_media":167543,"template":"","meta":{"_minecraft_slug":"voidspawn+","_minecraft_project_id":"EWR3hxnq","_minecraft_author":"melut","_minecraft_license":"CC-BY-NC-4.0","_minecraft_downloads":1741,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"voidspawn+.zip","_minecraft_size_bytes":136832,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T06:50:28.934109Z","_minecraft_date_created":"2025-11-13T00:47:14.609978Z","_minecraft_date_modified":"2026-01-02T08:42:55.888888Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/voidspawn+","_minecraft_icon_attachment_id":167543,"_minecraft_imported_at":"2026-06-09T19:06:22+00:00","_minecraft_import_hash":"14ac9ecbdf04683fe339cd0f8fe11ba7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,127,128,129,123,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-167542","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n