安装

Locus 是 Unreal Engine 的编辑器专用插件。你可以选择通过 Fab 安装，或使用匹配的预编译二进制软件包。

安装前

• 使用与项目所用 Unreal Engine 版本完全匹配的 Locus 版本。为其他 Engine 版本构建的软件包可能无法加载。
• Locus 1.1 支持 Unreal Engine 5.4–5.8 的 Win64 构建。macOS 和 Linux 不是受支持的发布平台。

Python Developer API 是可选功能，需要 Unreal Engine 5.6 或更高版本。由于已验证的 Unreal Engine 反射限制，UE 5.4 和 5.5 不支持该 API；但普通 Locus、C++、Blueprint 和 MCP 在这些版本上仍受支持。

通过 Fab 安装

通过 Fab 或 Epic Games Launcher 安装时，选择与你计划使用的 Unreal Engine 版本匹配的 Locus 版本。不需要手动复制插件文件。

1. 在 Unreal Editor 中打开目标项目。
2. 打开 Edit > Plugins，如果 Locus 尚未启用，请启用它。
3. 如果出现提示，请重新启动 Unreal Editor。

重新启动后，可以通过 Window > Locus、内容浏览器工具栏中的 Locus 按钮或 Ctrl+Shift+L 打开 Locus。

手动安装预编译二进制软件包

手动分发的 Locus 软件包包含其受支持 Unreal Engine 版本所需的预编译二进制文件。请选择与你计划使用的 Engine 版本完全匹配的软件包。

复制或替换插件文件前，请关闭 Unreal Editor。复制完整的 Locus 插件目录；不要只复制 Binaries，也不要合并为不同 Unreal Engine 版本构建的软件包中的文件。

项目专用安装

将完整的 Locus 插件文件夹复制到：

<ProjectRoot>/Plugins/Locus/

如果项目的 Plugins 目录不存在，请创建它。这样可以让 Locus 用于该项目，并将插件版本与项目关联，适合不同项目需要不同 Locus 或 Engine 版本的情况。

Engine 全局安装

将完整的 Locus 插件文件夹复制到：

<UnrealEngineRoot>/Engine/Plugins/Marketplace/Locus/

这样，使用该 Unreal Engine 安装打开的项目都可以使用 Locus，无需将同一个软件包复制到每个项目中。它不会安装到其他 Engine 版本。请在需要使用 Locus 的每个项目中单独启用它。

完成手动安装

1. 使用完全匹配的 Unreal Engine 版本重新打开项目。
2. 在 Edit > Plugins 中找到 Locus，如果尚未启用，请启用它。
3. 如果出现提示，请重新启动 Unreal Editor。

通过 Window > Locus、内容浏览器工具栏中的 Locus 按钮或 Ctrl+Shift+L 打开 Locus。

官方提供的匹配预编译二进制软件包不需要你生成项目文件、编译 Locus、重新构建插件、打开 Visual Studio 或修改 .Build.cs 文件。

使用时创建的数据位置

Locus 会在使用每种内容类型时创建相应存储。

内容	项目可见位置
共享笔记	<Project>/ProjectNotes/
共享标记点	<Project>/ProjectPins/
文档	<Project>/ProjectDocuments/
私有笔记和标记点、恢复数据、个人项目 UI 状态	<Project>/Saved/Locus/ 以及 <Project>/Saved/ 下的相关恢复文件夹

有关所有权和依赖关系，请参阅笔记、标记点、文档和项目影响和依赖。

禁用或移除 Locus

禁用或移除插件会停止其编辑器 UI，但不会有意删除上面列出的外部文件。卸载插件前请备份项目，并单独决定是否将保留的 Locus 数据留在项目或版本控制存储库中。

私有数据和恢复数据

如果依赖私有笔记、私有标记点或恢复快照，请不要将项目的 Saved 文件夹视为可随意丢弃的目录。清理或删除 Saved 可能永久删除这些数据。

Locus 只包含编辑器专用模块，不会向打包游戏添加运行时系统。其外部笔记、标记点和文档不是 UAsset，也不会自动作为游戏内容烘焙。移除 Locus 后保留工作区数据不会让游戏依赖 Locus。

请先查看已知限制，然后按照入门操作。