跳转至

新人第一天工程配置指南 (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)

  1. 访问工作室统一身份平台:https://auth.lynmio.com;
  2. 绑定 1Password 或安全密钥(WebAuthn / Touch ID);
  3. 打开代码托管平台 https://git.lynmio.com,点击 Sign in with Lynmio ID 完成初次单点登录。

3. Perforce Helix Core 仓库连接

  1. 服务器地址:ssl:p4.lynmio.com:1666
  2. 用户名:使用工作室统一账号用户名;
  3. Workspace 设置:
  4. 勾选 Allwrite(部分 DCC 需要);
  5. 字符编码(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。