# Dagor Damages Setup Tool
## 安装
[安装脚本](installation.md) 按照提供的说明进行作。
```{important}
此脚本需要 3ds Max 2013 或更高版本才能运行。
```
## 访问Damage Setup Tool
1. 导航到 **Gaijin Tools** {bdg-dark-line}`1` **> Damage Objects Setup...** {bdg-dark-line}`2`。这将打开 Dagor Damages Setup {bdg-dark-line}`3`的主窗口。
2. 要验证脚本的版本，请前往 **Gaijin Tools** {bdg-dark-line}`1` **> About**。**About**窗口将显示当前版本。定期检查以确保您的脚本是最新的，这一点很重要。
```{note}
确保插件版本至少为 `1.4`。
```
## 配置 Damage Setup Tool
下载以下测试场景：
{download}`dmg_example.max <_examples/dmg_example.zip>`
，然后在 3ds Max 中打开下载的项目。
```{note}
此文件支持的最低版本为 3ds Max 2018。
```
打开实用程序窗口：
**参数:**
- **Visible Object Parameters** {bdg-dark-line}`1`: 定义将在游戏中直观显示的对象数据块的参数。默认设置针对大多数情况进行了优化，但可以根据需要进行自定义。
- **Collision Object Parameters** {bdg-dark-line}`2`: 为该工具生成的碰撞设置参数。这些是针对常见使用案例预先配置的，但您可以修改它们以满足特定要求。
- **Collision Rotation** {bdg-dark-line}`3`: 调整生成的碰撞的旋转限制，以创建更自然的破坏效果。
- **Max Points in Collision** {bdg-dark-line}`4`: 指定生成的碰撞中的最大点数。仅当选择凸包作为碰撞类型时，此选项才处于活动状态。
- **Collision Surface Displacement** {bdg-dark-line}`5`: 定义碰撞曲面相对于对象曲面的位移。此设置也仅在使用凸包碰撞类型时处于活动状态。
- **Collision Name Postfix**{bdg-dark-line}`6`: 为生成的碰撞的名称添加后缀，以便于将它们与其他对象区分开来。
- **Collision Type** {bdg-dark-line}`7`: 选择要生成的碰撞类型。默认值为长方体，但其他选项包括 sphere、capsule 和 convex hull。
- **Overwrite Existing Parameters** {bdg-dark-line}`8`: 确定是否覆盖"Visible Object Parameters"和"Collision Object Parameters"中的现有参数。如果未选中，则所有现有参数都将被删除并替换为新参数。
- **Generate Collisions** {bdg-dark-line}`9`: 选择要为其生成碰撞的对象后，单击此按钮以启动该过程。
- **Documentation** {bdg-dark-line}`10`: 指向此文档的链接。
- **Contact Author** {bdg-dark-line}`11`: 如果需要帮助，请为开发人员提供联系信息。
- **Progress Bar** {bdg-dark-line}`12`: 显示场景处理的进度。对于包含许多对象 （50-100） 的场景，这可能需要几分钟时间。
## 生成碰撞
1. 选择要为 {bdg-dark-line}`A`生成碰撞的对象。
2. 准备它们以导出到引擎。
3. 单击 **Generate** 按钮 {bdg-dark-line}`B`。
## 查看生成的碰撞
处理后，将出现新对象 {bdg-dark-line}`C` 和生成的碰撞 {bdg-dark-line}`D` 的列表。
