# MMD_Morph_NoteHelp

**Repository Path**: sarakale/MMD_Morph_NoteHelp

## Basic Information

- **Project Name**: MMD_Morph_NoteHelp
- **Description**: MMD Morph NoteHelp MMD表情注释帮助工具 MMD表情註釋幫助工具 MMD表情注釈ヘルプツール
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-11
- **Last Updated**: 2025-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">MMD Morph NoteHelp</h1>

<p align="center">
<font size="10px">MMD表情注释帮助工具</font><br />
</p>
 
<p align="center">
  <img src="image/Preview_sc.jpg" align="middle" width = "700"/>
    <br /><br />
    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-dfd.svg"></a>
    <a href="https://github.com/SaraKale/MMD_Morph_NoteHelp/releases"><img src="https://img.shields.io/github/v/release/SaraKale/MMD_Morph_NoteHelp?color=ffa"></a>
    <a href=""><img src="https://img.shields.io/badge/NET Framework-4.8-aff.svg"></a>
    <a href=""><img src="https://img.shields.io/badge/os-win-blue.svg"></a>
</p>

<p align="center">
language：<a href="README_en.md">English</a> | <a href="README_tc.md">繁體中文</a>  | <a href="README_jp.md">日本語</a>
</p>

## 介绍

这是用于在MMD实时显示表情给出相关注释的小工具，方便快速了解表情作用。  
同时还可以保存表情数据 txt/vmd 文件，可公开分享。  
还可以将表情预设文件读取并应用到MMD，省去了繁琐的步骤。  

## 主要特点

主程序 表情注释帮助工具 的主要特点：
- 实时显示出表情的名称、精确数值以及多语言注释
- 快照保存表情的数据导出 txt/vmd 文件
- 可加载预设表情文件应用到MMD
- 可调整窗口颜色和字体
- 支持多语言界面切换

副程序 表情配置文件生成工具 的特点：
- 支持导入读取 PMD/PMX 文件的模型名称和表情名称，可查看预览表情表格。
- 支持批量处理文件，一次性生成配置文件
- 程序多语言界面切换

## 视频教程

youtube：https://youtu.be/vqRdOCW7_90  
bilibili：https://www.bilibili.com/video/BV1Po4FzbEVZ/

## 下载

请选择下面任意节点下载。

|   节点    |                                 链接                                 |
| :------: | :-----------------------------------------------------------------: |
|  Github  | [releases](https://github.com/SaraKale/MMD_Morph_NoteHelp/releases) |
|  Gitee   | [releases](https://gitee.com/sarakale/MMD_Morph_NoteHelp/releases)  |
| bowlroll |               [链接](https://bowlroll.net/file/343376)               |
| aplaybox |     [链接](https://www.aplaybox.com/details/model/a6vY7fXWcf3K)      |
| lanzouu  |         [链接](https://wwiu.lanzouu.com/b0rancfkd) 密码:an4j         |

## 运行环境

操作系统要求：Windows 7 SP1 以及 更高系统版本

需要有 Microsoft .NET Framework 4.8 运行环境  
下载：https://dotnet.microsoft.com/zh-cn/download/dotnet-framework/net48

## 编译构建

我的开发环境：  
系统：Windows 10  
环境：[Visual Studio 2022](https://visualstudio.microsoft.com/)  
框架：.NET Framework 4.8  

需要安装Nuget包：  
 - [AntdUI](https://gitee.com/AntdUI/AntdUI)
 - [AutoScaleHelper](https://github.com/hlz2516/AutoScaleHelper)
 - [Costura.Fody](https://github.com/Fody/Costura)
 - [PMX Parser](https://github.com/ikorin24/PMXParser)
 - [MMDFormats](https://github.com/oguna/MMDFormats)

然后直接运行 `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等常用的渲染器翻译。

## 问题解答 FAQ

Q：注释帮助打开内容是空白的  
A：请检查 ModelList.ini 配置是否对应了模型名称和路径，以及 data 文件夹下是否有相关的文件，程序只会判断这些地方是否存在，如果不存在内容就会是空白的。或者是我没有做翻译配置，可以告知我名称，我去增加翻译。还有一种情况是表情名称太长，MMD只能看到当前显示的文本，无法获取被截断的后面文本，这个情况只能自己忽略这个问题或者修改文件的名称为短名称，这个不影响使用。  

Q：配置生成工具无法导入 PMD 文件  
A：这是因为有些 .pmd 文件太过古老，我不会做解析，请自行尝试在 PmxEditor 软件另存为新的PMX文件测试看看。

## 使用事项

 - 禁止任何商业性质行为
 - 关于使用工具产生的任何问题，作者概不负责。

## 来源

- 使用库：
- AntdUI  
- https://gitee.com/AntdUI/AntdUI  
- AutoScaleHelper	by:hlz2516  
- https://github.com/hlz2516/AutoScaleHelper  
- Costura.Fody		by:geertvanhorrik,simoncropp  
- https://github.com/Fody/Costura  
- PMX Parser		by:ikorin24  
- https://github.com/ikorin24/PMXParser  
- MMDFormats		by:oguna  
- https://github.com/oguna/MMDFormats  

- AI代码辅助：
- DeepSeeK  
- ChatGPT  
- Github Copilot  
- Gemini  


## 许可证

使用 [MIT License](LICENSE) 许可证