第一个设备 creative_device:造一块属于你的逻辑积木

一、creative_device:能拖进关卡的「逻辑积木」

玩过 Fortnite 创意模式的你一定摆弄过各种设备:按钮、屏障、计分板、跳板……它们像乐高积木,拖进关卡、调调参数,机制就成型了。但官方积木总有不够用的一天——这时候就轮到 creative_device 出场了。

creative_device 是 Verse 自制设备的基类,住在 /Fortnite.com/Devices 模块里,是所有「自定义设备」的祖师爷。只要你的类继承了它,编译之后你的代码就会变成一块崭新的积木:出现在 Content Browser 里,可以像官方设备一样拖进关卡、摆在地上。换句话说:

creative_device 是 Verse 自制设备的父蓝图,住在 /Fortnite.com/Devices 这个抽屉(模块)里,是所有「自定义设备」的祖师爷。你新建的设备只要认它当爹(就像在蓝图里基于某个父类新建一个 Child Blueprint Class),Compile 之后你的代码就会变成一块崭新的积木:出现在 Content Browser 里,可以像官方设备一样拖进关卡、摆在地上。换句话说:

• 官方设备 = 出厂积木,功能固定;
• 继承 creative_device 的类 = 你自己开模生产的积木,逻辑随便写。
• 认 creative_device 当父蓝图的设备 = 你自己开模生产的积木,逻辑随便写。

有两条铁律现在就要记住。其一:凡是想拖进关卡的 Verse 类,都必须继承 creative_device——不继承它,代码写得再漂亮也只是一张没法上桌的图纸。其二:只有真正被放进关卡的设备实例才会执行,而且你拖几个进去,就有几份逻辑各自开跑——同一块积木,可以在岛上不同角落各干各的活。

有两条铁律现在就要记住。其一:凡是想拖进关卡的 Verse 设备,都必须认 creative_device 当父蓝图——不认这个爹,代码写得再漂亮也只是一张没法上桌的图纸。其二:只有真正被放进关卡的设备实例才会执行,而且你拖几个进去,就有几份逻辑各自开跑——同一块积木,可以在岛上不同角落各干各的活。

二、一行声明,四个零件:my_device := class(creative_device):

定义一个设备只需要一行声明。先看一个最小可用的完整示例:

using { /Fortnite.com/Devices }
using { /UnrealEngine.com/Temporary/Diagnostics }

# 一个最小可用的自定义设备
my_device := class(creative_device):

    OnBegin<override>()<suspends>:void =
        Print("设备已上线!")

读图翻译:这段代码就是一张蓝图。开头两行 using 相当于「先把 Devices、Diagnostics 两个抽屉拉开」,好让下面用得到里面的零件;my_device := class(creative_device) 是「新建一块以 creative_device 为父的蓝图」;OnBegin 那行就是这张图里的 Event BeginPlay 节点;它下面缩进的 Print 则是接了一个 Print String 节点,在屏幕左上角打出「设备已上线!」。

把声明那一行拆开看,一共四个零件:

• my_device —— 你给设备起的名字。类名用 lower_snake_case(全小写 + 下划线),这是官方 Verse Code Style Guide 定下的命名礼仪,creative_device 本身就是范例;
• := —— 读作「定义为」。左边是名字,右边是这个名字到底是什么。注意它和单独的 = 不是一回事——在 Verse 里 = 是比较,定义新东西认准 :=;
• class(creative_device) —— 宣布「我是一个类,而且继承了 creative_device 的全部家产」:能被拖进关卡、能在游戏体验开始时自动醒来;
• class(creative_device) —— 宣布「我是一块蓝图,而且认 creative_device 当父、继承了它的全部家产」(就像基于父类建一个 Child Blueprint Class):能被拖进关卡、能在游戏体验开始时自动醒来;
• 行尾的 : + 下一行缩进 4 空格 —— Verse 没有大括号,缩进就是代码块。冒号说「里面的内容在下面」,4 个空格说「我就是里面的内容」。
• 行尾的 : + 下一行缩进 4 空格 —— Verse 没有大括号,缩进就是分组。在蓝图里,一个节点接在哪根执行线、归哪个事件管,是靠连线表达的;Verse 没有连线,就用缩进代替——冒号说「里面的内容在下面」,往里缩 4 个空格的那些行,就都算「接在这行后面的那串节点」。

一句话总结:名字 := class(祖师爷):,然后缩进写本领。就这么简单。

三、逐 token 拆解:OnBegin<override>()<suspends>:void =

三、逐个零件拆解:OnBegin<override>()<suspends>:void =

类体里那行 OnBegin<override>()<suspends>:void = 是很多新人第一眼的「劝退现场」——一行里挤了六个零件。别慌,我们像拆武器配件一样,一个 token 一个 token 过:

设备蓝图里面那行 OnBegin<override>()<suspends>:void = 是很多新人第一眼的「劝退现场」——一行里挤了六个零件。别慌,我们像拆武器配件一样,一个零件一个零件过:

现阶段的记法很粗暴:这一整行是固定写法,原样背下来。它的官方语义是「Override 此函数,在游戏体验开始时加入自定义逻辑」。而正因为它自带 <suspends>,函数体里可以直接调用 Sleep(秒数) 这类异步 API——这是下一节的主角。而正因为它自带 <suspends>(等待徽章),函数体里可以直接放 Sleep(秒数) 这类带小钟表、会等待的节点(就像蓝图的 Delay)——这是下一节的主角。顺带一提,OnBegin 还有个孪生兄弟 OnEnd<override>():void =,在游戏体验结束时运行,注意它不带 suspends;它的故事我们放在本课的拔高拓展里讲。

四、完整示例:会打招呼、会打坐的 welcome_device

把这一课的零件拼起来,造一台「迎宾设备」:游戏一开始先喊一句欢迎,然后原地打坐 3 秒,再补一句提示。Sleep 来自 /Verse.org/Simulation 模块,所以文件顶部多了一行 using。Sleep 住在 /Verse.org/Simulation 这个抽屉里,所以文件顶部多拉开了一个抽屉(顶上那行 using)。点「运行下一步」,亲眼看代码怎么一行行执行——尤其注意 Sleep(3.0) 那一步,输出日志会一动不动,那就是「等待」长的样子。

using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

# 一个会打招呼的迎宾设备
welcome_device := class(creative_device):

    OnBegin<override>()<suspends>:void =
        Print("欢迎来到我的岛屿,冒险者!")
        Sleep(3.0)
        Print("提示:出生点旁边有补给箱,拿了再出发。")

小实验:重置后再跑一遍,想象没有 Sleep 的版本——两句话会挤在同一瞬间蹦出来,玩家可能一句都没看清。节奏感,也是设计的一部分。

五、从代码到关卡:编译与上岗四步

纸上谈兵到此为止,下面是把 welcome_device 真正放进游戏的完整流程。四步走完,你就拥有了人生第一块自制积木:

如果第 4 步的日志和你预想的一致,停下来庆祝十秒钟:你已经完成了「写代码 → 编译 → 部署 → 验证」的完整闭环,这可是不少人卡了好几天的地方。

常见坑:新手错误图鉴

• 漏写 <suspends> 或 <override> —— OnBegin 的签名与基类不匹配,直接编译错误。这是每个 Verse 新手的「第一滴血」,报错时先回头数徽章;
• 漏写 <suspends> 或 <override> —— 你的 OnBegin 和父蓝图里那个原版对不上号,Compile 直接亮红报错。这是每个 Verse 新手的「第一滴血」,报错时先回头数徽章;
• 编译成功但「什么都没发生」 —— 十有八九是忘了把设备拖进关卡;剩下的情况是改完代码没重新 Build 就开测,跑的还是旧版本;
• 缩进不齐 —— 函数体必须比签名行多缩进一级,而且不能混用 Tab 和空格(VS Code 默认 4 空格)。缩进就是语法,歪一格都算错;
• 缩进不齐 —— 要执行的那串节点(缩进的行)必须比上面 OnBegin 那行多缩进一级,而且不能混用 Tab 和空格(VS Code 默认 4 空格)。缩进就是语法,歪一格都算错;
• 以为在 VS Code 保存就算编译 —— VS Code 的 Verse 扩展只做语法提示,真正的编译必须回 UEFN 按 Ctrl+Shift+B。保存 ≠ Build;
• 改了类名或文件名之后设备「失灵」 —— 关卡里已放置的旧实例会失去类引用,需要删掉重新拖一个;
• 改了类名或文件名之后设备「失灵」 —— 关卡里已经摆好的旧实例会找不到它对应的那块蓝图(引用断了),需要删掉重新拖一个;
• 没启动会话就守着日志等输出 —— Print 只在运行中的会话里输出,光编辑器待机是等不来的。

六、关卡挑战 ★

本课的 BOSS 战由一道填空 + 三道选择题组成。答对拿星星,答错随便重试,没有惩罚机制。

using { /Fortnite.com/Devices }
using { /UnrealEngine.com/Temporary/Diagnostics }

my_first_device := ____(____):

    OnBegin<____>()<____>:void =
        Print("我的第一个设备上线了!")

拓展阅读