creator-mods-suite

# Creator Mods Suite **Creator Mods Suite** 是一套专为 Minecraft 内容创作者、YouTuber 和主播打造的综合模组套件，面向 1.21.1 版本。它提供八项可独立开关的功能，用于增强录制时的游戏体验，并在同一套多加载器代码库中同时支持 NeoForge 与 Fabric。 ## 核心用途 该套件相当于 Minecraft 的“导演工具箱”，让创作者可以通过命令或按键绑定即时触发复杂事件、管理镜头角度并修改游戏规则。这样在录制过程中就无需暂停、退出到菜单或重启游戏，从而确保画面流畅且专业。 ## 主要功能 该套件包含八个独立模块，每个模块承担特定的创作功能： 1. **导演工具箱（`/toolkit`）**：录制辅助工具，提供屏幕上的场记板、镜头标记、生物/玩家冻结开关、波次生成器、竞技场快照、镜头书签以及干净画面 HUD 开关。它可精确控制录制条次。 2. **灰烬巨像（`/colossus`）**：由 GeckoLib 驱动的动画三阶段 Boss 战。包含冲击波猛击、熔岩雨、小怪波次以及火环狂暴阶段等机制。 3. **能力套件（`/power`）**：提供六种按键激活能力，如冲刺、火焰爆发、地面重击、末影牵引、护盾穹顶和生物冻结。包含服务器权威冷却时间以及通过快捷栏行显示的视觉反馈。 4. **规则引擎（`/rule`、`/shop`）**：允许实时修改游戏规则，提供十一种可叠加选项（例如随机掉落、合成倍增、熔岩地面、巨型生物）。支持数据包预设以便轻松切换。 5. **进化（`/evolve`）**：五阶段玩家变身系统，玩家在每个阶段都会获得体型、属性提升和被动能力，并伴有粒子效果和模型替换。 6. **事件导演（`/event`）**：触发定向世界事件，如血月、流星、围攻、幸运雨和虚空升起。事件基于阶段推进，可通过命令重新计时、跳过或停止。 7. **军械库（`/arsenal`）**：引入四种独特武器：抓钩刃、风暴弓、重力锤和灵魂镰刀，每种都有独特的机制互动。 8. **诅咒宝库（`/vault`）**：一个拼图式地牢结构，包含一座诅咒祭坛，可召唤小 Boss（宝库看守者），以及在其被击败后开启的封印宝箱。包含一键重置功能。 ## 面向创作者的设计 * **命令行控制**：每项功能都可通过聊天命令控制（例如 `/colossus phase 3`、`/event skip`），无需中断游戏即可实时调整。 * **静默模式**：命令可配置为仅向动作栏输出反馈，而不是聊天日志，从而避免录制画面中出现杂乱信息，同时让操作者仍能看到错误消息。 * **独立开关**：八项功能均可通过配置或命令单独启用或禁用。禁用后的功能不会在世界中注册任何内容，确保不使用时零性能开销或视觉干扰。 * **非侵入式 HUD**：所有自定义 HUD 层都遵循原版 F1 全屏模式，并可通过命令按玩家清理，便于多机位设置。 * **镜头安全**：处于创造或旁观模式的玩家会被敌对机制（Boss 攻击、环境危害）忽略，使摄影师可以安全地飞越场景。 ## 技术细节 * **兼容性**：支持 Minecraft 1.21.1，需 NeoForge 21.1.250+ 和 Fabric Loader 0.19.5+。需要 Java 21。 * **架构**：使用共享的 `common/` 模块处理游戏逻辑，并为平台特定入口点和 mixin 分别设置 `fabric/` 与 `neoforge/` 模块。这确保不同加载器之间行为一致。 * **配置**：通过单个 `config/creatormods.json` 文件管理。平衡数值为硬编码常量；动态数据使用 Minecraft 数据包。 * **测试**：项目包含大量测试，每个加载器有 486 个 JUnit 5 单元测试和 134 个世界内 GameTests，覆盖逻辑、网络和交互式游戏场景。 * **资源**：当前资源为程序化生成的占位资源（Python 纹理、ffmpeg 音频），以确保模组在缺少资源时也能运行。真实美术资源已计划加入，但尚未包含。 ## 安装 用户必须从源码构建模组，或使用提供的 JAR（如果有）。依赖项包括 GeckoLib（动画所需）和 Fabric API（用于 Fabric 构建）。为获得完整功能，模组必须同时安装在客户端和服务端。 ## 许可证 该项目采用 MIT 许可证，允许分叉、修改和私人服务器使用，且无需强制公开更改。