VoidSpawn - 虚空传送

当玩家坠入虚空时，此插件会自动将其传送回出生点。这对于拥有开放虚空区域、玩家常会跳入其中的大厅服务器尤为实用。

💡核心功能

• 当玩家进入虚空时，将其传送至安全地点。
• 支持多种传送与处理模式。
• 支持多世界。
• 防止玩家死亡。
• 支持空岛插件（ASkyblock、IslandWorld、uSkyBlock、BentoBox 或 SuperiorSkyblock）。

🎮版本支持

• Spigot 1.18 或更高版本：仅支持 VoidSpawn 的最新版本。
• Spigot 1.17 或更低版本：必须使用 1.19.5 或更低的 VoidSpawn 版本。
• Spigot 1.12 或更低版本：必须使用 1.16.1 或更低的 VoidSpawn 版本。

> 旧版本可从版本历史页面下载。请注意，仅最新版本提供官方支持，旧版本仅用于兼容旧服务端。

🔧命令

所有命令均以 /vs 或 /voidspawn 开头。

• /vs - 显示插件基本信息。
• /vs help - 显示所有命令列表。
• /vs info [world] - 获取指定世界或当前世界的 VoidSpawn 信息。
• /vs mode (mode) [world] - 为当前世界或指定世界设置模式。
• /vs modes - 列出所有可用模式。
• /vs set [world] - 为当前世界或指定世界设置“spawn”模式的传送点。
• /vs remove [world] - 移除当前世界或指定世界的传送点。
• /vs reload - 重载插件配置。
• /vs toggle - 切换当前玩家进入虚空时是否被传送。
• /vs detector (detector) [world] - 设置世界检测器，默认为 Void。
• /vs option (set/clear) (option) [value...] - 为模式或检测器设置/清除选项。

> 命令参数说明：() 内为必填参数，[] 内为可选参数。

命令变量

在“command”模式下，可在命令前添加 op: 前缀以 OP 身份执行。同时支持以下变量：

• ${player.name} - 玩家名称。
• ${player.uuid} - 玩家 UUID。
• ${player.coord.x} - 玩家的 X 坐标。
• ${player.coord.y} - 玩家的 Y 坐标。
• ${player.coord.z} - 玩家的 Z 坐标。
• ${player.coord.world} - 玩家所在的世界名称。

示例命令：op:effect ${player.name} minecraft:strength 45

⭐权限

• vs.player.toggle - 允许使用 /vs toggle 命令。
• vs.enable - 允许玩家在进入虚空时被传送（默认所有玩家拥有）。
• vs.admin.* - 授予所有 VoidSpawn 管理命令权限。
• vs.admin.set - 允许使用 /vs set 命令。
• vs.admin.reload - 允许使用 /vs reload 命令。
• vs.admin.remove - 允许使用 /vs remove 命令。
• vs.admin.mode - 允许使用 /vs mode 命令。
• vs.admin.help - 允许使用 /vs help 命令。
• vs.admin.detector - 允许使用 /vs detector 命令。
• vs.admin.info - 允许使用 /vs info 命令。
• vs.admin.option - 允许使用 /vs option 命令。
• vs.* - 授予所有 VoidSpawn 权限。
• color-logs - 启用/禁用彩色日志（控制台权限）。

✨可用选项

以下选项可通过 /vs option 命令进行配置。请注意，并非所有模式或检测器都支持全部选项。

• sound : 检测到玩家进入虚空时播放的音效。
• sound_volume : 音效音量。
• sound_pitch : 音效音高。
• hybrid : 是否启用混合模式（同时执行模式和命令）。
• keep_inventory : 玩家是否保留物品栏。
• message : 检测到玩家进入虚空时发送的消息。
• command : 在“command”模式或“hybrid”模式下执行的命令。
• inc_death_stat : 是否增加死亡统计次数。
• vertical_offset : 从世界顶部传送玩家的垂直偏移量。
• keep_velocity : 传送后是否保持玩家的速度矢量。
• damage : 玩家进入虚空时受到的伤害值。
• bounce : 在激活模式前，将玩家从虚空弹起的次数。
• min_bounce_velocity : 弹起玩家时的最小速度。
• void_height : 检测虚空的高度（默认略低于虚空）。
• roof_height : 在顶部检测的高度（默认 128，用于下界检测器）。

> 所有世界的模式及其他设置均保存在 worlds.yml 配置文件中。

❓模式说明

• Spawn - 将玩家传送至预设的出生点。
• Touch - 将玩家传送回最后一次接触地面的位置。
• None - 移除该世界的任何模式（即禁用）。
• Island - 将玩家传送回自己的空岛。需要安装 ASkyblock、IslandWorld、uSkyBlock、BentoBox 或 SuperiorSkyblock 之一。
• Command - 当玩家进入虚空时，执行预设的命令。

❓检测器说明

• Void - 当玩家进入虚空时激活。（默认）
• Nether - 当玩家进入虚空 或 穿过下界顶部（Y=128）的基岩时激活。

🔧支持与反馈

• 如需报告问题或提问，最快的方式是在 GitHub 上提交新的工单。开发者不常查看 SpigotMC 页面。
• 欢迎在 GitHub 上提交新功能建议。

重要提示

• Spigot 1.17 或更低版本的非官方支持：VoidSpawn 最新版仅支持 Spigot 1.18+。旧版插件在旧服务端上仍可工作，但不再获得官方支持。
• 针对 1.12.2 或更低版本：如果插件不工作，且您在权限中使用了 *，请务必在权限配置中否定 vs.override 权限（例如 -vs.override）。