二次开发 开源 PullUp+ | 为MC的鞘翅飞行添加自定义警报 2026-06-23

[MD] # 🛩️ PullUp+ **PullUp+** 是一款为鞘翅飞行提供**高度可自定义语音警报**和 **HUD 视觉提示**的 Minecraft 模组。 本模组为 Minecraft 中的鞘翅飞行提供可自定义的语音警告。你可以基于本地配置文件、服务器同步配置文件或通过 PullUp 云端编辑器生成的配置文件，来定义不同的触发逻辑、HUD 文本和音频效果。 本模组基于 `MUYU_Twilighter/pullup_fabric` 开发，并持续进行维护与更新。 ## 核心特性 - **智能状态检测**：支持使用数学表达式精准检测玩家的飞行状态（高度、速度、俯仰角、碰撞距离等）。 - **立体声语音警报**：当触发相应规则时，自动播放自定义音效（例如经典的 “*Pull up!*”、“*Terrain ahead!*”、“*Sink rate!*”）。 - **视觉 HUD 提示**：支持在屏幕中央弹出高亮文本提示，颜色和透明度均可自定义。 - **多源配置支持**：支持**本地配置**、**服务器同步**以及从**云端编辑器**一键导入。 - **高兼容性**：支持 Fabric、Forge 和 NeoForge。 ## 快速开始 1. 将对应游戏版本的模组 `.jar` 文件放入 `mods` 文件夹中。 2. 首次启动游戏后，模组会自动在 `config/pullup/` 目录下生成主配置文件和示例配置文件。 3. **在单人游戏或客户端中**：输入 `/pullupclient gui` 打开配置管理界面。 4. **在多人游戏中**：如果服务器也安装了该模组，客户端只需输入 `/pullupclient grab` 即可自动获取并同步服务器的飞行警报规则。 > **提示：** > > 本模组完全可以作为**纯客户端**模组使用。但如果安装在服务器上，则可以实现服务器规则同步功能。 ## 指令 ### 客户端 - `/pullupclient gui` — 打开直观的配置 GUI 管理界面。 - `/pullupclient status` — 查看当前启用状态、已加载规则数量以及云端连接状态。 - `/pullupclient load <文件名>` — 加载指定的本地配置文件。 - `/pullupclient load default` — 恢复并加载内置的默认配置。 - `/pullupclient grab` — 主动请求并同步当前的服务器配置。 ### 服务器 - `/pullupserver load <文件名>` — 为全服加载指定的配置文件。 - `/pullupserver enablesend` — 允许向加入的客户端广播并应用服务器配置。 ## 可视化编辑器 觉得手动修改 JSON 配置文件太繁琐？我们提供了可视化编辑器！ 1. 在游戏内输入 `/pullupclient cloud edit`，系统将为你生成专属的编辑链接。 2. 在浏览器中打开该链接，即可通过可视化界面轻松编辑你的规则、警报音效、触发范围和 HUD 文本。 3. 编辑完成后点击发布，并复制生成的**短码**。 4. 在游戏内输入 `/pullupclient cloud import <短码>`，即可将规则保存至本地并立即应用！ > 编辑器网址：https://pullup.akihito.dpdns.org/ ## 开源协议 - **开源协议**：本分支基于 `GPL-3.0-only` 协议开源。 - **上游项目**：特别感谢上游作者的杰出工作：[MUYU_Twilighter/pullup_fabric](https://github.com/MUYUTwilighter/pullup_fabric) (MIT)。 [/MD]