
? 概览
VoidSpawn 是一款高性能的 Paper/Spigot 插件,旨在将掉入虚空的玩家自动传送至安全区域。该插件会监控每个玩家的 Y 轴坐标,并在其低于可配置的阈值时,立即将其传送至指定的重生点。
工作原理
- 玩家掉落至其所在世界配置的 Y 轴阈值以下
- 插件瞬间检测到虚空坠落
- 玩家将传送到自定义重生点(通过
/vs setspawn 设置)
- 如果未设置自定义重生点,玩家将被传送至世界的默认重生点
- 平滑的渐隐动画和音效增强了体验效果
✨ 主要功能
? 核心功能
- 多世界支持 - 为每个世界配置独立的 Y 轴阈值
- 自定义重生点 - 设置具有精确朝向的特定传送位置
- 默认重生点回退 - 若未设置自定义重生点,自动回退至世界重生点
- 优化检测 - 即使玩家众多也能保持无卡顿的性能
? 玩家体验
- 平滑渐隐效果 - 2 秒的屏幕淡入/淡出过渡效果
- 可自定义消息 - 完全支持
& 格式的颜色代码
- 音效反馈 - 可配置的传送音效
- 冷却系统 - 防止传送滥用和漏洞利用
?️ 管理功能
- 基于权限的访问控制 - 对命令和绕过权限进行细粒度控制
- 热重载 - 无需重启服务器即可更新配置
- 按世界配置 - 可按世界启用/禁用虚空保护
- Minecraft 1.20+ - 完全兼容最新版本
? 安装
要求
- Minecraft 服务器:Paper/Spigot/folia 1.20 或更高版本
- Java:17 或更高版本
设置步骤
- 下载
VoidSpawn-1.0.0.jar
- 将文件放入服务器的
plugins/ 文件夹中
- 重启服务器
- 配置插件(文件会自动创建):
plugins/VoidSpawn/config.yml
plugins/VoidSpawn/spawns.yml
? 命令
管理员命令
| 命令 |
描述 |
所需权限 |
/vs setspawn |
在当前所在位置及面向方向设置当前世界的虚空重生点 |
voidspawn.admin |
/vs reload |
从磁盘重新加载配置 |
voidspawn.admin |
别名: /voidspawn 与 /vs 功能完全相同
? 权限
| 权限节点 |
描述 |
默认状态 |
voidspawn.admin |
访问所有 /vs 命令 |
仅限 OP |
voidspawn.bypass |
豁免玩家免受虚空检测(适用于测试) |
仅限 OP |
⚙️ 配置
config.yml 结构
# 渐隐效果设置
fade-effect-enabled: true # 启用/禁用屏幕渐隐动画
# 音效设置
teleport-sound: ENTITY_ENDERMAN_TELEPORT # 传送时播放的音效(设为 'none' 以禁用)
# 冷却设置
teleport-cooldown: 3 # 玩家可以再次被传送前的等待秒数
# 消息(支持 & 颜色代码)
teleport-message: "&a您已被传送至安全区域!"
spawn-not-set-message: "&e未设置自定义重生点。正在传送至世界重生点..."
cooldown-message: "&c请等待后再尝试传送。"
# 世界特定设置
worlds:
world:
y-level: -64 # 低于此 Y 轴等级的玩家将被传送
enabled: true # 启用/禁用此世界的虚空保护
world_nether:
y-level: -64
enabled: true
world_the_end:
y-level: -64
enabled: true
配置选项
视觉效果
- fade-effect-enabled:
true/false
- 在传送期间启用平滑的屏幕渐隐效果
- 持续时间:总共 2 秒(1 秒淡出,1 秒淡入)
音频设置
- teleport-sound: 音效名称或
none
- 默认值:
ENTITY_ENDERMAN_TELEPORT
- 必须是有效的 Bukkit Sound 枚举名称
- 设置为
none 以禁用音效
防滥用保护
- teleport-cooldown: 整数(秒)
- 防止重复的快速传送
- 默认值:3 秒
- 有助于防止恶意滥用
世界配置
对于每个世界,请配置:
- y-level: Y 轴坐标阈值(低于此值的玩家将被传送)
- enabled:
true/false 用于切换虚空保护
?️ 设置重生点
初始设置(必需)
- 确保您拥有 OP 状态或
voidspawn.admin 权限
- 进入您要配置的世界
- 站在玩家应该生成的确切位置
- 面向玩家应该面对的方向
- 执行:
/vs setspawn
- 将出现确认消息
保存内容?
- 世界名称
- X、Y、Z 坐标
- Yaw(水平旋转角度)
- Pitch(垂直旋转角度)
没有自定义重生点
如果未通过 /vs setspawn 设置自定义重生点,玩家将:
- 收到
spawn-not-set-message 消息
- 被传送至世界的默认重生点
- 仍然受益于虚空保护
? 高级用法
多个世界
为每种类型的世界配置不同的 Y 轴等级:
worlds:
survival_world:
y-level: -64
enabled: true
creative_world:
y-level: -128
enabled: false # 在创造模式下禁用
mining_world:
y-level: -64
enabled: true
自定义消息
使用 & 配合 Minecraft 颜色代码:
teleport-message: "&b&l虚空救援 &r&7» &a您已获救!"
spawn-not-set-message: "&e&l⚠ &7使用默认重生点..."
cooldown-message: "&c&l✖ &7请在下次传送前等待 {cooldown}s"
性能调优
插件默认已针对性能进行了优化,但您可以:
- 禁用渐隐效果以减少开销
- 调整冷却时间以减少事件频率
- 在创造/旁观者世界中禁用该功能
? 性能信息
VoidSpawn 以性能为优先构建:
- 优化事件处理:仅处理相关的玩家移动事件
- 内存高效:在玩家断开连接时自动清理
- 无刻延迟:尽可能进行异步处理
- 极低开销:即使拥有 100 多名玩家,CPU 占用率通常也低于 1%
最佳实践
- 设置合适的 Y 轴高度(不要设置过高)
- 使用合理的冷却时间(推荐 3-5 秒)
- 在不需要虚空保护的世界中禁用此功能
❓ 故障排除
玩家未被传送
- 检查 config.yml 中是否已为该世界启用虚空保护
- 确认 Y 轴高度设置正确
- 确保玩家没有
voidspawn.bypass 权限
- 查看服务器控制台是否有报错信息
重生点无法正常工作
- 确认已通过
/vs setspawn 命令设置了重生点
- 检查
spawns.yml 中是否存在该世界的条目
- 尝试重新设置重生点
- 验证世界名称是否完全匹配
性能问题
- 如果遇到卡顿,请禁用淡入淡出效果
- 增加冷却时间
- 检查是否存在冲突的插件
- 使用
/tps 命令检查服务器的 TPS
? 技术支持
如需提交错误报告、功能请求或获取一般性支持,请联系开发团队。

? Overview
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.
How It Works
- Players fall below the configured Y-level threshold for their world
- The plugin instantly detects the void fall
- Players are teleported to a custom spawn point (set via
/vs setspawn)
- If no custom spawn exists, players are sent to the world's default spawn
- A smooth fade animation and sound effect enhance the experience
✨ Key Features
? Core Functionality
- Multi-World Support - Configure unique Y-levels for each world
- Custom Spawn Points - Set specific teleport locations with exact orientation
- Default Spawn Fallback - Automatic fallback to world spawn if custom spawn not set
- Optimized Detection - Lag-free performance even with many players
? Player Experience
- Smooth Fade Effect - 2-second fade-in/fade-out screen transition
- Customizable Messages - Full color code support with
& formatting
- Sound Effects - Configurable teleport sounds
- Cooldown System - Prevents teleport spam and exploitation
?️ Administration
- Permission-Based Access - Granular control over commands and bypass
- Hot Reload - Update configuration without server restart
- Per-World Configuration - Enable/disable void protection per world
- Minecraft 1.20+ - Full compatibility with latest versions
? Installation
Requirements
- Minecraft Server: Paper/Spigot/folia 1.20 or newer
- Java: 17 or higher
Setup Steps
- Download
VoidSpawn-1.0.0.jar
- Place the file in your server's
plugins/ folder
- Restart your server
- Configure the plugin (files created automatically):
plugins/VoidSpawn/config.yml
plugins/VoidSpawn/spawns.yml
? Commands
Administrator Commands
| Command |
Description |
Permission Required |
/vs setspawn |
Sets the void spawn point for current world at your location and facing direction |
voidspawn.admin |
/vs reload |
Reloads the configuration from disk |
voidspawn.admin |
Alias: /voidspawn works identically to /vs
? Permissions
| Permission Node |
Description |
Default |
voidspawn.admin |
Access to all /vs commands |
OP only |
voidspawn.bypass |
Exempts player from void detection (useful for testing) |
OP only |
⚙️ Configuration
config.yml Structure
# Fade Effect Settings
fade-effect-enabled: true # Enable/disable screen fade animation
# Sound Settings
teleport-sound: ENTITY_ENDERMAN_TELEPORT # Sound played on teleport (use 'none' to disable)
# Cooldown Settings
teleport-cooldown: 3 # Seconds before player can be teleported again
# Messages (supports & color codes)
teleport-message: "&aYou have been teleported to safety!"
spawn-not-set-message: "&eNo custom spawn set. Teleporting to world spawn..."
cooldown-message: "&cPlease wait before being teleported again."
# World-Specific Settings
worlds:
world:
y-level: -64 # Players below this Y-level are teleported
enabled: true # Enable/disable void protection for this world
world_nether:
y-level: -64
enabled: true
world_the_end:
y-level: -64
enabled: true
Configuration Options
Visual Effects
- fade-effect-enabled:
true/false
- Enables smooth screen fade during teleportation
- Duration: 2 seconds total (1s fade out, 1s fade in)
Audio Settings
- teleport-sound: Sound name or
none
- Default:
ENTITY_ENDERMAN_TELEPORT
- Must be valid Bukkit Sound enum name
- Set to
none to disable sound
Anti-Spam Protection
- teleport-cooldown: Integer (seconds)
- Prevents repeated rapid teleportations
- Default: 3 seconds
- Helpful for preventing abuse
World Configuration
For each world, configure:
- y-level: Y-coordinate threshold (players below this are teleported)
- enabled:
true/false to toggle void protection
?️ Setting Up Spawn Points
Initial Setup (Required)
- Ensure you have OP status or
voidspawn.admin permission
- Enter the world you want to configure
- Stand at the exact location where players should spawn
- Face the direction players should be facing
- Execute:
/vs setspawn
- Confirmation message will appear
What Gets Saved?
- World name
- X, Y, Z coordinates
- Yaw (horizontal rotation)
- Pitch (vertical rotation)
Without Custom Spawn
If no custom spawn is set via /vs setspawn, players will:
- Receive the
spawn-not-set-message
- Be teleported to the world's default spawn point
- Still benefit from void protection
? Advanced Usage
Multiple Worlds
Configure different Y-levels for each world type:
worlds:
survival_world:
y-level: -64
enabled: true
creative_world:
y-level: -128
enabled: false # Disable in creative
mining_world:
y-level: -64
enabled: true
Custom Messages
Use Minecraft color codes with &:
teleport-message: "&b&lVOID RESCUE &r&7» &aYou've been saved!"
spawn-not-set-message: "&e&l⚠ &7Using default spawn point..."
cooldown-message: "&c&l✖ &7Wait {cooldown}s before next teleport"
Performance Tuning
The plugin is optimized by default, but you can:
- Disable fade effects for minimal overhead
- Adjust cooldowns to reduce event frequency
- Disable in creative/spectator worlds
? Performance Information
VoidSpawn is built with performance as a priority:
- Optimized Event Handling: Only processes relevant player movement events
- Memory Efficient: Automatic cleanup on player disconnect
- No Tick Lag: Asynchronous processing where possible
- Minimal Overhead: Typically <1% CPU usage even with 100+ players
Best Practices
- Set appropriate Y-levels (don't set too high)
- Use reasonable cooldowns (3-5 seconds recommended)
- Disable in worlds where void protection isn't needed
❓ Troubleshooting
Players aren't being teleported
- Check if void protection is enabled for that world in config.yml
- Verify the Y-level is set correctly
- Ensure players don't have
voidspawn.bypass permission
- Check server console for errors
Spawn point not working
- Confirm spawn was set with
/vs setspawn
- Check
spawns.yml for the world entry
- Try setting the spawn again
- Verify world name matches exactly
Performance issues
- Disable fade effects if experiencing lag
- Increase cooldown duration
- Check for conflicting plugins
- Review server TPS with
/tps command
? Support
For bug reports, feature requests, or general support, please contact the development team.
评论 0
登录后参与评分
还没有评论,来抢沙发吧