天晴动作工具组（NDToolsBox / 天晴盒子）的 3ds Max 动画重定向 开源工具。

用于不同命名、不同链接结构的骨架之间复制/烘焙动画，支持 FBX ↔ Biped 映射、一键创建 Biped、批量重定向 FBX，以及蒙皮权重替换等。通过 NDToolsBox 安装后可在菜单中启动。

内容概览

文件 / 模块	说明
BipedAinmPicker_FBXmap.py	主界面入口（约 v0.49）
BipedAnimPick_FBXMap_struat.ms	重定向核心 MaxScript（直接 filein）
FBX批量转BIp.ms	FBX 批量转 BIP 界面（batch_fbx_to_bip_tools，按需 filein）
UIMap.py	骨骼映射与 UI 模板读写
MaxHelpPlus.py	MaxPlus 辅助（约 Max 2015–2020）
MaxHelpRT.py	pymxs / qtmax 辅助（约 Max 2021+）
getMotionbuildertemp.py	MotionBuilder 模板解析与 HIK→Biped 映射
templateHIK2Bip.json	HIK 到 Biped 的默认映射模板
template_struct.ms	模板数据结构（MaxScript）
_archive/	历史 UI/MS 备份、测试与草稿脚本

主要功能

• 两个不同命名标准、不同链接结构的骨架互相复制 / 烘焙动画
• 保存与加载骨骼映射模板；智能拾取 Biped 命名标准骨架
• 按模板一键创建与体型匹配的 Biped
• 批量重定向 FBX 资源、快捷导入 FBX
• 批量替换蒙皮权重、恢复到蒙皮姿势

兼容版本说明

本工具兼容 3ds Max 2015 – 3ds Max 2024（Windows）。启动时按 Max 版本自动选择 Qt / API 辅助模块，无需分版本安装多套脚本。

3ds Max	Python / Qt	辅助模块	说明
2015 – 2017	Python 2.7 + PySide + MaxPlus	MaxHelpPlus.py	旧版嵌入窗口与 MaxScript 求值
2018 – 2020	Python 2.7 + PySide2 + MaxPlus	MaxHelpPlus.py	Qt 切换为 PySide2，API 仍为 MaxPlus
2021 – 2024	Python 3 + PySide2 + pymxs / qtmax	MaxHelpRT.py	MaxPlus 不可用，改用 pymxs / qtmax

补充说明：

• 菜单入口统一：add_menu_v3.ms → BipedAinmPicker_FBXmap.py，不再按 Max 年号分子目录。
• 核心重定向逻辑为同目录 BipedAnimPick_FBXMap_struat.ms，各版本共用。
• 2025 及以上未在兼容范围内验证；若需使用，请自行测试 pymxs / qtmax 行为。
• 具体功能以当前脚本与 NDToolsBox 工具列表配置为准。

安装说明

方式一：官网 / 天晴盒子（推荐）

1. 从 下载安装 (opens new window) 或天晴盒子 / NDToolsBox 安装器部署工具。
2. 资源默认安装到：

C:\ProgramData\Autodesk\ApplicationPlugins\NDToolsBox\Joe_Anim_Picker\

3. 安装完成后，在 3ds Max 菜单 NDBox → 动画重定向 启动（以盒子实际菜单为准）。

方式二：从本仓库手动部署

适用于开发调试或自行更新脚本。

1. 部署文件
   以管理员身份运行仓库根目录的 deploy_install.bat（UAC 点「是」）。
   脚本会将必需文件复制到上述安装目录，并校验是否齐全。

2. 注册菜单
   打开 3ds Max，在 Listener / MaxScript 编辑器中执行：

filein @"C:\ProgramData\Autodesk\ApplicationPlugins\NDToolsBox\Joe_Anim_Picker\add_menu_v3.ms"

或直接拖拽 add_menu_v3.ms 到视口执行。成功后菜单栏出现 NDBox → 动画重定向。

3. 启动工具
   点击 NDBox → 动画重定向，或在 Max 中执行：

python.ExecuteFile @"C:\ProgramData\Autodesk\ApplicationPlugins\NDToolsBox\Joe_Anim_Picker\BipedAinmPicker_FBXmap.py"

4. 更新
   修改源码后再次运行 deploy_install.bat 覆盖安装目录即可；一般无需重复注册菜单。

5. 卸载

   • 去掉菜单：在 Max 中 filein 安装目录下的 remove_menu_v1.ms
   • 删除安装目录：以管理员身份运行 uninstall_install.bat（确认输入 Y）
   • 若资源管理器提示无权限：关闭 3ds Max 后，用管理员命令提示符执行
     rd /s /q "C:\ProgramData\Autodesk\ApplicationPlugins\NDToolsBox\Joe_Anim_Picker"

使用文档

• 3ds Max 动画重定向工具 (opens new window)
• FBX 批量转 BIP (opens new window)

开发说明

• MaxHelpRT.py / MaxHelpPlus.py 启动时 filein BipedAnimPick_FBXMap_struat.ms。
• FBX批量转BIp.ms 在点击「批量重定向」时按需加载；若已定义 batch_fbx_to_bip_tools 则直接 CreateDialog。

已知未入库的安装资源

完整安装包（NDanim_Pack / NDToolsBox）中可能还包含本仓库未收录的文件，例如：

• master/（批量转 BIP 相关资源）
• UE5_Python/IKrig-1.py

缺失时部分菜单/导出功能可能不可用，以安装目录实际文件为准。

相关

• 资源包仓库：NDanim_Pack 资源包
• 3ds Max 插件客户端：NDToolsBox 插件客户端

Git 仓库

• GitHub：https://github.com/4698to/ND_Anim_Picker (opens new window)
• Gitee：https://gitee.com/to4698_admin/ND_Anim_Picker (opens new window)

开源组织

本项目由以下组织开源：

• 网龙网络公司
• 福建天晴数码有限公司

开源协议

本项目采用 Apache License 2.0 (opens new window) 开源协议。

你可以自由使用、修改和分发本软件，包括用于商业用途，但须遵守该协议的要求，例如保留版权与许可声明，并在修改时注明变更。软件按「原样」提供，不附带任何明示或暗示的担保。