第 10 章 · 附录
速查表与资源清单
资产路径、函数与节点、数据表、术语中英对照、官方视频清单。做东西卡住时来这里翻,不用回头读全文。
这一页不打算“教会”你什么,只想让你少翻几次内容浏览器。 建议直接收藏本页,用 Ctrl+F 或左侧搜索找关键词。
资产路径速查
| 要找的东西 | 路径 |
|---|---|
| 五大管理器组件 | StoryFramework → Core → Blueprint → Components → Core |
相机组件 SFDefaultCamera_CC | StoryFramework → Core → Blueprint → Components → Other |
| 数据表(全部) | StoryFramework → Core → Blueprints → Data Tables |
结构体(TaskInfo_S 等) | StoryFramework → Core → Blueprints → Structures |
| 函数库(BFL) | StoryFramework → Core → Blueprints → Function Libraries |
| 输入映射(IMC) | StoryFramework → Core → Input |
| UI 控件(提示、按键、菜单) | StoryFramework → Core → User Interface → Widgets |
| 玩家相机管理器类 | StoryFramework → Core → Blueprints |
| 触发器 Actor | StoryFramework → Core → Example → Level → LevelActors → Triggers |
| 设置数据资产 SFV | 搜索 StoryFrameworkValues(也可从顶部 Story Framework 菜单进) |
| 存档对象 / GameInstance | StoryFramework → Core → Blueprints(搜索 SaveGame / SFGameInstance_BP) |
节点 / 函数速查
除了「引用」一栏,其余都需要先拿到对应管理器。
交互管理器
| 节点 | 用途 |
|---|---|
Perform Action | 开始一段带进度条的动作 |
Stop Current Action | 中断当前动作 |
OnPerformActionFinished / OnPerformActionStopped | 动作结束 / 被打断的事件 |
Create Quick Time Event | 创建一次 QTE |
Spawn Interactable Saved | 生成可交互物并立刻存入存档 |
背包管理器
| 节点 | 用途 |
|---|---|
Add Item to Inventory | 加道具(可同时销毁地上的物体) |
Remove Selected Item From Inventory | 删道具(可选掉到地上) |
Find Item in Inventory by Name | 查某个道具的数量 |
DoItemsArrayExistInInventory | 批量检查是否齐全 |
EditItemInInventoryByName | 运行时修改道具数据 |
Add Journal Entry / Remove Journal Entry | 增删日志 |
Edit Consequential Tags | 增删剧情标记(回忆录 / 对话分支的总开关) |
Add Main Task to Queue | 加主线任务 |
Complete Current Main Task | 完成当前主线 |
Edit Target Main Task in Queue | 修改进行中的任务 |
Find Task in Queue by Header | 按标题查任务 |
OnTaskInitialized | 任务初始化事件 |
相机 / 序列 / 存档
| 节点 | 所属 | 用途 |
|---|---|---|
Soft Focus Camera | 相机组件 | 视野缩放 |
Update Camera Preset | 相机组件 | 第一/第三人称切换 |
Lock Focus On Target | 相机管理器 | 强制锁定视角 |
Look At Target Once | 相机管理器 | 平滑看向某处 |
Play Level Sequence | 序列管理器 | 播过场 |
Play Sound With Subtitles | 序列管理器 | 声音 + 字幕 |
Create Story Choice | 序列管理器 | 全屏二选一 |
Save Game / Auto-Save / Load Game | 存档管理器 | 存 / 自动存 / 读 |
数据表清单
| 数据表 | 存什么 | 什么时候改 |
|---|---|---|
ItemCombinations_DT | 道具组合配方(按顺序匹配) | 加组合玩法时 |
MemoirEntry_DT社区也写作 MemoirEntryList_DT | 回忆录条目(标记 → 回忆) | 加剧情选择后果时 |
NPCGrunts_DT | NPC 的“咕哝”音效 | 加氛围音时 |
InputMap_DT | 按键的显示文字 / 图标 / 背景 | 改按键提示样式时 |
| MoreItemOptions(SF5 起) | 道具的扩展选项 | 需要更多道具属性时 |
术语中英对照
| 英文 | 本手册译法 | 一句话说明 |
|---|---|---|
| Interaction Method | 交互方式 | 物体被交互时的行为类型,共 5 种 |
| Primary / Secondary Interaction Method | 主 / 次交互方式 | PIM 五选一,SIM 只能 None 或 Inspect |
| Interactable | 可交互物 | 继承 InteractableBase_BP 或实现交互接口的 Actor |
| Inspect | 检视 | 把物体拿到镜头前查看 |
| Quick-Inventory | 快捷背包 | 底部工具栏式背包 |
| Journal Entry | 日志条目 | 记录“见过但没带走”的东西 |
| Memoir | 回忆录 | 玩家做过的关键决定的记录 |
| Consequential Tag | 剧情标记 | 全局的布尔记忆,驱动对话分支与回忆录 |
| Task / Quest | 任务 | 主线(Main)与支线(Side/Optional) |
| Sequence | 关卡序列 | 过场动画 |
| Subtitle | 字幕 | 可独立使用的文本演出 |
| Story Choice | 故事选择 | 全屏二选一的重要抉择 |
| Quick Time Event (QTE) | 快速反应事件 | 限时按键 |
| Unified Menu Container (UMC) | 统一菜单容器 | 把背包/日志/任务收在一个界面 |
| SFV (StoryFrameworkValues) | 框架设置资产 | 全局配置数据资产 |
| Actor Component | Actor 组件 | 挂在 Actor 上的功能模块 |
| Blueprint Interface (BPI) | 蓝图接口 | 让不同类被统一调用的“函数名单” |
| Input Mapping Context (IMC) | 输入映射上下文 | 一套按键方案,按场景切换 |
| Data Table / Data Asset | 数据表 / 数据资产 | 把数据从蓝图里分离出来的资产 |
| Event Dispatcher | 事件分发器 | 广播机制,用于解耦 |
| Soft Lock | 软锁 / 卡关 | 玩家陷入无法继续的状态(设计失误) |
官方视频清单
官方文档里很多页面只有一句“看视频”。这里把这些视频集中列出,方便你按需查看(英文,建议开自动字幕)。
| 主题 | 链接 | 对应章节 |
|---|---|---|
| 工程内容总览 | youtu.be/Hi8mDlpqazE | 第 1 章 |
| 编辑器工具(SFEditor) | youtu.be/hoYEmRqU3hU | 第 2 章 |
| 任务系统 | youtu.be/L9E236f6tG0 | 第 4 章 |
| NPC 对话 | youtu.be/iT95RxS4Gc8 | 第 5 章 |
| 保存自定义变量 | youtu.be/H9OXqD4okAc | 第 8 章 |
| 统一菜单容器(UMC) | youtu.be/1jhe4gUtL2M | 第 6 章 |
| 动画检视(5.2 新功能) | youtu.be/cCyeP-NeUt8 | 第 3 / 8 章 |
| 5.1 → 5.2 升级指南 | youtu.be/r2PtnI4wajY | 第 8 章 |
| 5.0 → 5.1 升级指南 | youtu.be/jw0J19qCARU | 第 8 章 |
官方文档里“缺”的那段视频
「SF Menu's」页面的视频链接在原文里是一个占位符(“Video Link”),并没有真的填上。
如果你需要学这块,目前只能看 UMC 的视频 + 直接读 MenuMaster_W 的实现。
资料来源与致谢
- 官方文档(36 页,约 1.3 万词): visualonecompany.gitbook.io/home —— 本手册正文的主要来源,已翻译并按学习顺序重排。
- Fab 商品页: Story Framework 5.2 – Interactive Template —— 版本信息与产品定位。
- Jay Versluis 的实战教程(14 篇): versluis.com/story-framework —— 任务、对话、日志、回忆录、通知等具体节点做法,本手册已标注引用。
- Epic 开发者社区论坛: 产品讨论帖 —— 作者答疑与用户反馈,帮助校准了一些细节。
关于准确性
这份手册是二次整理,不是官方出版物。以下几类内容请以引擎内实际资产为准: 资产的确切路径、参数默认值、节点名(版本间可能重命名)。 若发现错误,建议直接对照官方文档原文核实。