Minecraft 故事模组

Minecraft 故事模组

添加MCSM头部和面部情感动画及更多内容

冒险

🇷🇺 俄语描述

🎭 Minecraft Story Mod by ErrorGhostX

Minecraft Story Mod by ErrorGhostX — 这是一个受 Minecraft Story Mode S1/2 启发的模组,试图将原作游戏中独特的氛围带入原版 Minecraft!

⚠️ 注意(BETA): 模组处于早期测试阶段。许多功能仍在积极开发中!


✨ 功能

🗣️ 面部动画与麦克风(PlasmoVoice 与 Simple Voice Chat)

模组彻底改变了玩家的面部,添加了动画 3D 头部。但我们不仅限于基础表情!

  • 工作原理: 模组与 PlasmoVoice(以及 SVC)深度集成。拦截器实时直接从你的麦克风捕获声音(PCM 采样)。模组分析声音并生成正确的嘴型(视位)。最终,你的角色会完全根据你的语音张开嘴巴!

🌐 在原版服务器上的 "ProxLib" 数据传输

在无法安装此模组的原版服务器上玩?没关系。

  • 工作原理: 我们尝试实现基于 ProxLib 的数据传输协议。如果服务器上没有该模组,客户端会使用 ProxLib 的“邻近”通道直接交换数据。如果你和你的朋友在客户端安装了模组,即使在普通原版服务器上,你们仍然能看到彼此的表情和口型同步!

🧩 自定义菜单

你不再局限于单一的标准外观!

  • 使用方法: 在游戏中按 C 键打开自定义界面。
  • 那里有 MCSM 风格的界面在等着你。你可以独立选择头部形状、发型、帽子、肤色和服装。组装你独特的虚拟形象,服务器会立即将其同步给其他玩家。

Head Editor Menu [玩家自定义菜单界面,带有发型/面部选择]

🧠 表情菜单

无需言语表达情感!

  • 使用方法: 在游戏中按 O 键打开环形表情菜单。
  • 你可以使用 12 种独特的表情(快乐、悲伤、愤怒、惊讶、大笑、痛苦等)。菜单中心还有一个切换按钮,可以快速开启或关闭你的 3D 头部显示。

emotions menu 带有中心切换按钮的 12 按钮环形表情菜单]

🤖 Story Mode 生物(开发中)

游戏中将出现 Story Mode 的生物(杰西、佩特拉),它们会在世界中游荡。

  • 当前状态: 生物生成时带有动态的情绪和表情,会对伤害和附近的朋友做出反应。添加了基础的声望系统(攻击生物会降低声望)。
  • 注意: 高级机制,如从地上拾取物品、穿戴盔甲和进食,已列入计划,但在当前测试版中尚未实现。

Jetra and Pesse [NPC 佩特拉和杰西站在一起,脸上带着表情]


⚙️ 技术部分

  • OBJ 模型: 模组使用 OBJ 格式的自定义 3D 模型来渲染头部。这允许平滑插值和更改面部几何结构(mesh)以适应不同表情,而无需僵硬的逐帧动画。
  • 语音分析: 我们通过 PlasmoVoice/SVC 拦截来自麦克风的原始音频帧(PCM 16-bit 48kHz),实时计算音量和频率,以生成精确的视位(嘴型)。
  • P2P 网络: 使用 ProxLib 库可以将视位和表情打包成紧凑的字节负载,并在可见范围内(proximity)直接在客户端之间传输。即使在没有插件的情况下,这也能正常工作!

🎭 表情表

表情 作用
中性 标准面部
快乐 微笑,扬起眉毛
悲伤 下垂的眉毛,悲伤的样子
愤怒 阴沉的表情,攻击性的目光
惊讶 张开的嘴,睁大的眼睛
恐惧 颤抖的目光(颤抖的眼睛)
痛苦 角色皱眉
坚定 专注、严肃的目光
说话 根据语音的嘴唇运动动画
以及:大笑、困惑、坏笑!

🗺️ 未来计划 (Roadmap)

功能 状态 优先级
3D 面部动画 ✅ 完成 高
PlasmoVoice 集成 ✅ 完成 高
通过 ProxLib 的 P2P 网络 ⚠️ 测试版 中
NPC 基础表情 ✅ 完成 中
背包与进食 (NPC) ❌ 已计划 高
Story Mode 对话 UI ❌ 已计划 中

📜 作者

  • 作者: ErrorGhostX
  • 项目灵感来自 Minecraft Story Mode。

⚠️ 免责声明: 这是一个粉丝项目,与 Mojang、Microsoft 或 Telltale Games 没有任何关联。所有权利归其所有者所有。

🎭 Minecraft Story Mod by ErrorGhostX

Minecraft Story Mod by ErrorGhostX 是一个受 Minecraft Story Mode S1/2 启发的模组,试图将原版 Minecraft 带入该游戏独特的氛围!

⚠️ 测试版警告: 此模组目前处于早期测试阶段。许多功能仍在积极开发中!


✨ 功能

🗣️ 语音激活的口型同步(PlasmoVoice 与 Simple Voice Chat)

该模组通过添加动画 3D 头部彻底改变了玩家的面部。但它不仅限于预定义的表情!

  • 工作原理: 我们与 PlasmoVoice(以及 SimpleVoiceChat)深度集成。模组实时分析你麦克风的实时音频帧(PCM 采样),计算你声音的音量和语音形状,并即时生成逼真的嘴型(视位)。你的角色会完全同步地张开嘴巴!

🌐 "ProxLib" 原版网络

在无法安装模组的原版服务器上玩?没问题。

  • 工作原理: 我们尝试使用 ProxLib 库实现无缝的原版数据传输。如果服务器上没有安装模组,客户端将使用 ProxLib 直接在玩家之间弹跳动画数据和本地化的邻近数据。只要你和你的朋友在客户端安装了模组,即使在普通原版服务器上,你们也能看到彼此的面部动画和口型同步!

🧩 自定义菜单

你不再局限于一种外观!混合搭配角色部件。

  • 使用方法: 在游戏中按 C 键打开自定义界面。
  • 我们的 MCSM 风格网格 UI 允许你独立更改模型的头部、发型、帽子、皮肤和服装。组装你独特的 Story Mode 虚拟形象,服务器会立即将其同步给其他人。

Head Editor Menu [自定义菜单 UI,显示角色部件网格]

🧠 表情菜单

无需言语表达自己!

  • 使用方法: 在游戏中按 O 键打开表情轮盘。
  • 从 12 种不同的表情中选择(快乐、悲伤、愤怒、惊讶、恐惧、得意、大笑、困惑、痛苦、坚定、说话、中性)。菜单中心还有一个切换按钮,可以立即开启或关闭你的 3D 头部。

emotions menu [表情菜单轮盘,显示 12 个表情按钮和中心切换按钮]

🤖 Story Mode NPC(开发中)

遇见在你的世界中游荡的全功能 Story Mode NPC(如杰西和佩特拉)。

  • 当前状态: 生物生成时带有动态的情绪和表情,会对伤害或靠近朋友做出反应。存在基础的声望系统(攻击它们会降低声望,与它们交谈可以改变声望)。
  • 注意: 高级行为,如 NPC 动态拾取物品、装备盔甲和进食,已计划但在当前测试版中尚未实现。

Jetra and Pesse [佩特拉和杰西 NPC 站在一起,脸上带着表情]


⚙️ 技术细节

  • OBJ 模型: 模组原生解析并渲染 OBJ 格式的 3D 模型,允许使用自定义网格在角色表情之间进行连续平滑的过渡。
  • 语音分析: 我们拦截实时的 16-bit 48kHz PCM 音频流,分析频率以即时将你的真实声音转换为准确的渲染视位。
  • P2P 网络: 利用 ProxLib,模组通过邻近通道传递包含视位和情绪数据的紧凑字节负载,无需专门的服务器端处理。

🎭 表情表

表情 描述
中性 默认面部
快乐 微笑的脸,扬起眉毛
悲伤 皱眉和下垂的眉毛
愤怒 攻击性的表情和紧锁的眉头
惊讶 张开的嘴和睁大的眼睛
恐惧 颤抖的表情,睁大的眼睛
痛苦 痛苦的表情
坚定 专注、严肃的表情
说话 动态口型同步动画
此外:得意、大笑、困惑!

🗺️ 路线图与计划

功能 状态 优先级
3D 面部动画 ✅ 完成 高
PlasmoVoice 集成 ✅ 完成 高
ProxLib P2P 同步 ⚠️ 测试版 中
NPC 基础表情 ✅ 完成 中
NPC 背包与进食 ❌ 已计划 高
Story Mode 对话 UI ❌ 已计划 中

📦 需求

依赖 版本
Minecraft 1.21.11
Fabric Loader ≥ 0.18.4
Fabric API 必需
Fabric Language Kotlin ≥ 1.13.9
PlasmoVoice(可选) 支持
Simple Voice Chat(可选) 支持

📜 鸣谢

  • 作者: ErrorGhostX
  • 灵感来源: Telltale Games 的 Minecraft Story Mode 第 1 季和第 2 季。

⚠️ 免责声明

这是一个粉丝制作的项目,与 Mojang Studios、Microsoft 或已解散的 Telltale Games 没有任何关联、认可或联系。所有商标均为其各自所有者的财产。