MMD表情注释帮助工具
这是用于在MMD实时显示表情给出相关注释的小工具，方便快速了解表情作用。
同时还可以保存表情数据 txt/vmd 文件，可公开分享。
还可以将表情预设文件读取并应用到MMD，省去了繁琐的步骤。
主程序 表情注释帮助工具 的主要特点：
- 实时显示出表情的名称、精确数值以及多语言注释
- 快照保存表情的数据导出 txt/vmd 文件
- 可加载预设表情文件应用到MMD
- 可调整窗口颜色和字体
- 支持多语言界面切换
副程序 表情配置文件生成工具 的特点：
- 支持导入读取 PMD/PMX 文件的模型名称和表情名称，可查看预览表情表格。
- 支持批量处理文件，一次性生成配置文件
- 程序多语言界面切换
youtube：https://youtu.be/vqRdOCW7_90
bilibili：https://www.bilibili.com/video/BV1Po4FzbEVZ/
请选择下面任意节点下载。
| 节点 | 链接 |
|---|---|
| Github | releases |
| Gitee | releases |
| bowlroll | 链接 |
| aplaybox | 链接 |
| lanzouu | 链接 密码:an4j |
操作系统要求：Windows 7 SP1 以及 更高系统版本
需要有 Microsoft .NET Framework 4.8 运行环境
下载：https://dotnet.microsoft.com/zh-cn/download/dotnet-framework/net48
我的开发环境：
系统：Windows 10
环境：Visual Studio 2022
框架：.NET Framework 4.8
需要安装Nuget包：
然后直接运行 MMD MorphNote Project.sln 编译即可。
或者其他方式编译，例如dotnet编译：
dotnet build MMD Morph NoteHelp.csproj --framework net48
dotnet build MMD MorphSettings Generate.csproj --framework net48
主程序【注释帮助工具】使用方法：
- 1、请先运行 MikuMikudance 程序，然后打开 MMD Morph NoteHelp.exe 程序即可。
- 2、此时在MMD中导入相关的PMX文件，请在模型操作栏切换到和
ModelList.ini内容有关的名称，当鼠标实时切换表情选项，表情标题和数值、注释内容会自动更新。 - 3、可根据需要点击“设置”按钮调整主窗口的背景色、字体颜色和大小、选择语言会同时改变界面的语言还有注释内容的语言。切换语言有延迟，需要再用鼠标切换表情选项即可自动更新。
- 4、还可以点击“保存”按钮输出 .txt 文件和 .vmd 文件，方便阅览，也可以用于公开分享。
- 需要注意的是只会保存实时监控当前模型的表情项目，鼠标没有经过的项目不会记录，切换到其他模型就要重新记录，要想全部保存只有一个个手动点击表情栏切换了。
- 5、点击“表情预设”按钮可以选取 Presets 文件夹下的 .vmd 文件，点击“应用”按钮可将预设文件注册到 MMD 的表情栏中，省去了手动点击的流程。也可以做删除文件操作。
- 在应用过程中，程序会模拟真实按键导入文件，这过程中不要操作键盘和鼠标，请耐心等待它自动完成。
- 如果出现应用失败，可能是延迟的问题，可以自己手动载入 .vmd 文件到MMD。
副程序【表情配置文件生成工具】使用方法：
- 点击运行 MMD MorphSettings Generate.exe 程序即可。
- 这里有两种模式，一个是单文件模式，一个批量文件模式。
- 单文件模式：
- 1、首先要导入 .pmd 或 .pmx 文件，也可以拖动文件到框内，会自动读取模型名称、表情列表。
- 2、然后选导出路径，默认是在data文件夹下，也可以手动自定义路径。
- 3、确认无误后就可以点击下面的“导出”按钮，会自动更新 ModelList.ini 的配置，就不用手动填写了。
- 批量文件模式：
- 1、首先设定好导出路径，默认是在 data 文件夹。
- 2、可以将多个 .pmd / .pmx 文件拖动到列表内容中，一行一个文件，也可以点击“添加文件”按钮来添加多个文件。
- 3、如果不想要某个文件，可以在列表选择其中一个文件，点击“删除”就可以了。
- 4、确认无误后就可以点击“导出”按钮输出文件了！它也会自动更新 ModelList.ini 的配置，
- 注意：
- 由于历史遗留和版本问题，.pmd 文件可能不会完全正常读取，如果遇到错误请手动将文件转换为 .pmx 文件再载入到程序即可。
- 生成后的模型配置ini文件需要自己去填写各语言翻译内容，请别忘记噢。
- 如果提示有文件没添加表情英文名称和翻译，请手动在 PmxEditor 添加英文名称，再重新生成即可，建议修改为和日语一样的名称。如果您使用的是英文版MMD，需要有英文表情，请务必手动添加。
data 文件夹内置的配置文件放了一些常见的渲染器和效果，可以打开 ModelList.ini 看看有没有你需要查看的模型，就去MMD加载相关的文件即可。
已做了Ray、ikPolishShader、PowerShader等常用的渲染器翻译。
Q：注释帮助打开内容是空白的
A：请检查 ModelList.ini 配置是否对应了模型名称和路径，以及 data 文件夹下是否有相关的文件，程序只会判断这些地方是否存在，如果不存在内容就会是空白的。或者是我没有做翻译配置，可以告知我名称，我去增加翻译。还有一种情况是表情名称太长，MMD只能看到当前显示的文本，无法获取被截断的后面文本，这个情况只能自己忽略这个问题或者修改文件的名称为短名称，这个不影响使用。
Q：配置生成工具无法导入 PMD 文件
A：这是因为有些 .pmd 文件太过古老，我不会做解析，请自行尝试在 PmxEditor 软件另存为新的PMX文件测试看看。
- 禁止任何商业性质行为
- 关于使用工具产生的任何问题，作者概不负责。
-
使用库：
-
AntdUI
-
AutoScaleHelper by:hlz2516
-
Costura.Fody by:geertvanhorrik,simoncropp
-
PMX Parser by:ikorin24
-
MMDFormats by:oguna
-
AI代码辅助：
-
DeepSeeK
-
ChatGPT
-
Github Copilot
-
Gemini
使用 MIT License 许可证