VoidSpawn+

插件

· 作者 melut

当玩家掉入虚空时,将其传送回出生点。一款简单轻量的插件,旨在防止虚空死亡并保持游戏流畅运行。

0 本站下载 0 关注 更新于 10 个月前

最新 1.2.0 · 26.2 · Bukkit / Folia

一键开服(送7天)

logo

? 概览

VoidSpawn 是一款高性能的 Paper/Spigot 插件,旨在将掉入虚空的玩家自动传送至安全区域。该插件会监控每个玩家的 Y 轴坐标,并在其低于可配置的阈值时,立即将其传送至指定的重生点。

工作原理

  1. 玩家掉落至其所在世界配置的 Y 轴阈值以下
  2. 插件瞬间检测到虚空坠落
  3. 玩家将传送到自定义重生点(通过 /vs setspawn 设置)
  4. 如果未设置自定义重生点,玩家将被传送至世界的默认重生点
  5. 平滑的渐隐动画和音效增强了体验效果

✨ 主要功能

? 核心功能

  • 多世界支持 - 为每个世界配置独立的 Y 轴阈值
  • 自定义重生点 - 设置具有精确朝向的特定传送位置
  • 默认重生点回退 - 若未设置自定义重生点,自动回退至世界重生点
  • 优化检测 - 即使玩家众多也能保持无卡顿的性能

? 玩家体验

  • 平滑渐隐效果 - 2 秒的屏幕淡入/淡出过渡效果
  • 可自定义消息 - 完全支持 & 格式的颜色代码
  • 音效反馈 - 可配置的传送音效
  • 冷却系统 - 防止传送滥用和漏洞利用

?️ 管理功能

  • 基于权限的访问控制 - 对命令和绕过权限进行细粒度控制
  • 热重载 - 无需重启服务器即可更新配置
  • 按世界配置 - 可按世界启用/禁用虚空保护
  • Minecraft 1.20+ - 完全兼容最新版本

? 安装

要求

  • Minecraft 服务器:Paper/Spigot/folia 1.20 或更高版本
  • Java:17 或更高版本

设置步骤

  1. 下载 VoidSpawn-1.0.0.jar
  2. 将文件放入服务器的 plugins/ 文件夹中
  3. 重启服务器
  4. 配置插件(文件会自动创建):
    • 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 用于切换虚空保护

?️ 设置重生点

初始设置(必需)

  1. 确保您拥有 OP 状态或 voidspawn.admin 权限
  2. 进入您要配置的世界
  3. 站在玩家应该生成的确切位置
  4. 面向玩家应该面对的方向
  5. 执行:/vs setspawn
  6. 将出现确认消息

保存内容?

  • 世界名称
  • X、Y、Z 坐标
  • Yaw(水平旋转角度)
  • Pitch(垂直旋转角度)

没有自定义重生点

如果未通过 /vs setspawn 设置自定义重生点,玩家将:

  1. 收到 spawn-not-set-message 消息
  2. 被传送至世界的默认重生点
  3. 仍然受益于虚空保护

? 高级用法

多个世界

为每种类型的世界配置不同的 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

? 技术支持

如需提交错误报告、功能请求或获取一般性支持,请联系开发团队。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源