Vivecraft Spigot Extensions - (VR服务端扩展)

Vivecraft Spigot Extensions

Vivecraft Spigot Extensions (VSE) 是专为 Java 版《我的世界》VR 模组 Vivecraft 设计的配套插件。它适用于 Spigot、Paper 和 Folia 服务器，为 VR 玩家提供了多项增强功能与优化。

💡核心功能

• 全身动作同步：Vivecraft 玩家可以看到其他 Vivecraft 玩家的头部、手臂和腿部动作。
• 双手射箭支持：支持 Vivecraft 的双手射箭功能。
• VR 玩家权限组：可为 VR 玩家分配独立的权限组。
• 实体与弹道修正：修复 VR 玩家投掷的弹射物和掉落物。
• 可配置的平衡性调整：

- 可调整苦力怕对 VR 玩家的爆炸半径（默认从 3 米缩小至 1.75 米）。

- 可减少生物对 VR 玩家的近战攻击范围（默认减少 0.4 米）。

• 多项 Vivecraft 功能支持（均可开关）：

- 房间尺度格挡 (Roomscale Blocking)

- 双持 (Dual Wielding)

- Climbey 攀爬工具 (Climbey Tools)

- 快速破坏方块 (Faster Block Breaking)

• 可配置功能：支持 Vivecraft 的弓箭爆头机制 (Arrow Headshots)，伤害倍率可调。
• 服务器限制：可选择将服务器限制为仅允许 Vivecraft 玩家加入。

配置说明

所有可用的配置选项均可在首次运行插件后生成的 config.yml 文件中查看，或参阅 配置 Wiki 条目。

🎮安装与版本

安装步骤

• 从 Modrinth 或 发布页面 下载最新版本。
• 将下载的 .jar 文件放入服务器的 /plugins 文件夹中。
• 重启服务器。

版本说明

插件的版本号由两部分组成

• 第一部分：表示插件所支持的 Vivecraft 模组的功能版本。
• 第二部分：表示插件的发布版本号，随问题修复或支持新的 Minecraft 版本而递增。

示例：版本 1.3.3-0 表示此插件支持 Vivecraft 1.3.3 的功能，并且是该支持版本的首个发布。

🔧使用代理服务器

当服务器架构中包含代理服务器（如 BungeeCord 或 Velocity）时，您可能需要在代理端安装兼容插件，以确保 VSE 的数据能被正确转发到后端的 Spigot/Paper/Folia 服务器。

目前我们提供以下扩展

• BungeeCord：Vivecraft BungeeCord Extensions
• Velocity：Vivecraft Velocity Extensions

✨开发者信息

从源码构建

目前构建流程较为复杂，需要按特定顺序执行 Gradle 任务：

• 运行 gradlew generateAccessors (takenaka -> generateAccessors)
• 运行 gradlew rebuildStubs (generate -> rebuildStubs)
• 如果您使用 IDE，请现在重新加载 Gradle 项目，因为上一步生成了一些子项目。
• 运行 gradlew build (build -> build)

元数据 (Metadata)

VSE 在 Spigot 的 Player 对象上提供了元数据，以便其他插件能基于此提供对双手交互等功能的特殊支持。如果您不熟悉元数据，请查阅 Spigot 文档。

请注意，API 支持多个插件使用相同的元数据键，因此请确保通过我们的插件名称 (Vivecraft-Spigot-Extension) 进行筛选。有关可用数据的详细信息，请参阅 Wiki。

API

我们还提供了更强大的 API，可用于访问所有可用身体部位的历史数据等。有关 API 的更多详情，请参阅 Wiki。

❓旧版本支持

1.7.10 版本

如果您需要适用于 Spigot 1.7.10 的 VSE 版本，可以在版本历史标签页或我们的 GitHub 页面 此处 下载。