新人第一天工程配置指南 (Getting Started Manual)
- Target Audience: 新入组美术师、技术美术与开发人员
- Owner: @micho
1. 软件环境对齐
请对照 toolchain.yml 安装指定版本,严禁私自安装更高的小版本或抢先版:
- Unreal Engine: 5.8
- Autodesk Maya: 2024
- Adobe Substance 3D Painter: 12.2.0
- Perforce P4V 客户端: 对应服务端 2024.2
2. 账号与统一身份接入 (Authentik)
- 访问工作室统一身份平台:https://auth.lynmio.com;
- 绑定 1Password 或安全密钥(WebAuthn / Touch ID);
- 打开代码托管平台 https://git.lynmio.com,点击 Sign in with Lynmio ID 完成初次单点登录。
3. Perforce Helix Core 仓库连接
- 服务器地址:
ssl:p4.lynmio.com:1666 - 用户名:使用工作室统一账号用户名;
- Workspace 设置:
- 勾选
Allwrite(部分 DCC 需要); - 字符编码(Line ending):
Unix (LF)。
4. 常见问题排查 (Troubleshooting)
- Q: 为什么提交
.uasset提示 File is locked by another user?
A: 工作室对虚幻二进制资产开启了独占锁 (+l),避免多端同时修改产生不可合并的二进制冲突。请在 Slack / 飞书联系持有人先提交或回滚释放。 - Q: Substance Painter 导出后粗糙度反相?
A: 检查导出预设是否选择了工作室专用的Unreal Engine Packed (ORM),确保 G 通道输出的是 Roughness 而非 Glossiness。