Update nexus wiki content
This commit is contained in:
53
wiki/concepts/OneFilePerActor.md
Normal file
53
wiki/concepts/OneFilePerActor.md
Normal file
@@ -0,0 +1,53 @@
|
||||
---
|
||||
title: "OneFilePerActor"
|
||||
type: concept
|
||||
tags: ["unreal-engine", "collaboration", "version-control", "world-partition"]
|
||||
sources: ["unreal-world-builder"]
|
||||
last_updated: 2026-04-30
|
||||
---
|
||||
|
||||
## Aliases
|
||||
- OFPA
|
||||
- One File Per Actor
|
||||
- 单 Actor 单文件
|
||||
- Per-Actor Asset 分块
|
||||
|
||||
## Definition
|
||||
One File Per Actor(OFPA)是 Unreal Engine 5 World Partition 模式下的多用户协作编辑机制。每个 Actor 存储在独立文件中,而非整个关卡一个文件,从而支持多人同时编辑不同 Actor 而不产生源控制冲突。
|
||||
|
||||
## Problem Solved
|
||||
传统关卡文件(所有 Actor 在一个 `.umap` 中)的协作问题:
|
||||
- 两人同时打开同一关卡 → 文件冲突
|
||||
- 某人保存后另一人保存 → 后者覆盖前者改动
|
||||
- 锁定整个关卡才能安全编辑 → 串行化工作流程
|
||||
|
||||
## OFPA Workflow
|
||||
1. 每个 Actor 存储为 `Path/To/Actor_Name/ActorName.uasset`
|
||||
2. 多人可同时编辑不同 Actor,无需锁定
|
||||
3. 源控制按 Actor 粒度管理变更
|
||||
4. 关卡文件仅存储 Actor 引用而非内容
|
||||
|
||||
## Team Education Requirements
|
||||
必须教育团队:
|
||||
- **签出方式**:按 Actor 单独签出,而非整个关卡
|
||||
- **依赖理解**:Actor 引用关系在关卡文件中,更改引用仍需操作关卡文件
|
||||
- **命名规范**:Actor 命名必须符合团队规范,避免歧义
|
||||
|
||||
## File Count Management
|
||||
OFPA 启用后大规模关卡产生数千个 Actor 文件:
|
||||
- 必须建立**文件数预算**
|
||||
- 监控文件数增长趋势
|
||||
- 构建关卡审计工具,标记尚未转换为 OFPA 的遗留关卡
|
||||
|
||||
## OFPA Limitations
|
||||
- 大量 Actor 文件增加文件系统压力
|
||||
- 某些第三方插件可能不完全兼容 OFPA
|
||||
- 源控制仓库大小显著增加(更多小文件)
|
||||
|
||||
## Connections
|
||||
- [[WorldPartition]] ← 协作模式 ← OneFilePerActor
|
||||
- [[UnrealWorldBuilder]] ← 多用户支持 ← OneFilePerActor
|
||||
- [[UnrealEngine5]] ← 核心引擎 ← OneFilePerActor
|
||||
|
||||
## Sources
|
||||
- [[unreal-world-builder]]
|
||||
Reference in New Issue
Block a user