# cmrig_scriptFor3DMax

**Repository Path**: RiggerLiuqi/cmrig_scriptFor3DMax

## Basic Information

- **Project Name**: cmrig_scriptFor3DMax
- **Description**: 3DMax 脚本工具
- **Primary Language**: 其他
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CMRig Script For 3ds Max

这是一个给 3ds Max 用的 CMRig 工具菜单项目。目标是和 `cmrig-script` 类似：工具脚本放在项目里，3ds Max 启动时自动注册 `CMRig` 菜单，后续插件统一从菜单或 Plugin Manager 打开。

## 安装

1. 打开 3ds Max。
2. 菜单 `Scripting > Run Script...`。
3. 选择 `Q:\cmrig_scriptFor3DMax\installers\install_cmrig_max.ms`。
4. 如果菜单没有立刻出现，重启 3ds Max。

不要优先复制安装脚本到 Listener/脚本管理器执行。`Run Script...` 会让 MaxScript 知道安装脚本文件的位置，路径最稳。当前 installer 也兼容复制执行，但前提是项目仍在 `Q:\cmrig_scriptFor3DMax`。

安装后入口：

- `CMRig > Plugin Manager`
- `CMRig > Skin Tools > Import Maya Skin Weights`

## Skin 工具

`Import Maya Skin Weights` 已接入从 `Q:\cmrig-script\tools\3dsmax\importSkinWeightFromMaya.ms` 迁移来的脚本。

基本流程：

1. 在 3ds Max 里选择要接收权重的模型。
2. 打开 `CMRig > Skin Tools > Import Maya Skin Weights`。
3. 选择 Maya 导出的 `.envASCII` 文件夹。
4. 点击 `导入选中模型权重`。

## 后续加插件

1. 把 MaxScript 放进 `scripts\cmrig_max\tools\...`。
2. 在 `scripts\cmrig_max\core.ms` 的 `CMRig_Max_RegisterDefaultTools()` 里注册工具。
3. 如果只需要从管理器打开，不需要新增菜单项。
4. 如果需要固定菜单项，再在 `macros.ms` 和 `menu.ms` 增加一个 macro/action。

## 验证

本项目提供 batch 验证脚本：

```powershell
powershell -ExecutionPolicy Bypass -File .\tools\run_validation.ps1
```

它会尝试用本机的 3ds Max 2025、2024、2020 执行 `tools\validate_importer.ms`，验证启动加载、插件登记、Skin 导入脚本加载，以及部分权重解析/归一化函数。

注意：`3dsmaxbatch.exe` 需要能正常检出 3ds Max 许可证。当前环境里 2024 batch 在执行脚本前返回过 `License Startup Error / ADLSDK_STATUS_LICENSE_NOT_CHECKED_OUT`，这种情况需要先在本机完成 Max 授权后再跑。