认识 Verse 与 UE6:你的第一句魔法咒语

一、Verse 是什么:UE6 的官方脚本语言

Verse 是 Epic Games 打造的编程语言,也是 UE6 的官方脚本语言。如果说引擎编辑器是一张巨大的乐高工作台,那 Verse 就是给积木注入灵魂的咒语——按钮为什么会开门、倒计时为什么会响、Boss 为什么会在你踩到机关时出现,背后全是 Verse 在发号施令。

它不是一门实验室里的新语言。Verse 于 2023 年 3 月随 UEFN(UE6 中面向 Fortnite 的创作环境)上线,此后一直在数以万计的 Fortnite 岛屿上担任唯一的游戏逻辑脚本语言——等于在数亿玩家面前公测了好几年才走到你面前。如今 Epic 把 UE5 与 UEFN 两条产品线汇成了 UE6,gameplay 编程的正统入口就是 Verse:官方的说法是它「把 C++ 事务化」,目标是支撑数千名贡献者协作的大规模持久在线体验。Actor 与蓝图在 UE6 的早期版本里仍然保留,官方也承诺了迁移工具,但方向已经写在路标上了。

再说说它不寻常的血统:Verse 是一门函数式逻辑语言(functional logic language)。它由 Epic 创始人 Tim Sweeney 亲自主导构思——他自述这门语言在脑子里酝酿了大约十年;2021 年 12 月,Haskell 之父级人物 Simon Peyton Jones 加入 Epic 出任 Engineering Fellow 参与设计,同行的还有 Lennart Augustsson 等一票函数式编程界的传奇人物。一门为游戏而生的工业语言,却有着学院派的顶配血统——这在编程语言史上都算稀罕事,也解释了后面你会遇到的很多「怪而妙」的设计。

二、为什么值得学它

在动手之前,先回答那个最实际的问题:我为什么要把时间投给 Verse?

• ▢ 它是 UE6 的正统:从 Fortnite 小岛到大型项目,gameplay 逻辑用的都是同一门语言。今天在 UEFN 里练的每一行,都直接通向 UE6 的核心编程模型,不存在「学完就过时」。
• ◇ 久经实战:数万张已发布的岛屿就是它的战绩单。你写的地图发布后,全世界的玩家都能搜到并进来玩;Epic 还会按玩家参与度给创作者分成——写 Verse 不只是爱好,它是一张真金白银的「创作者经济入场券」。
• △ 天生防崩:Verse 的设计哲学是「失败即条件」——很多在其他语言里会让游戏当场崩溃的操作,在 Verse 里只是安静地「没成功」;修改变量必须喊口令、数据默认不可变,大量 bug 在编译期就被拦下,根本没机会跑起来害人。这些我们后面几课细说,先埋个彩蛋。
• ★ 零基础友好:整个系列课都会把编程概念翻译成你熟悉的游戏机制——变量是背包格子,事件是机关触发,函数是快捷施法键。你不需要任何编程经验,会玩游戏就行。

三、你的第一段 Verse:先跑起来,再逐行拆

下面是一个完整、可以直接编译运行的 Verse 设备,正是官方 Verse Device 模板生成的经典 Hello 程序。它的全部使命:在游戏体验开始时,向世界喊出「Hello, world!」,顺便现场算一道数学题。别急着理解每个字,先点「运行下一步」,像看回放一样,看代码是怎么一行行执行的。

读图翻译(蓝图视角):这段代码要是拿蓝图搭,就是一个以 creative_device 为父类的蓝图类,里面放一个 Event BeginPlay 事件;从 BeginPlay 拉出执行线,先接一个 Print String 节点(内容是 Hello, world!),再接第二个 Print String(内容里用 {2 + 2} 现场算出 4)。下面的步进器会把这几个「节点」一行行点亮给你看。

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

# 我的第一个 Verse 设备
hello_world_device := class(creative_device):

    OnBegin<override>()<suspends>:void =
        Print("Hello, world!")
        Print("2 + 2 = {2 + 2}")

看到了吗?短短几行,一个「会说话的设备」就完工了。现在把它拆开,一块积木一块积木地看:

• using { /Fortnite.com/Devices } —— 借工具箱。Verse 的能力分装在不同模块里,模块路径长得像网址(/Fortnite.com、/Verse.org、/UnrealEngine.com),using 就是开工前把需要的工具箱搬到手边。(有趣的小知识:Print 本身来自 /Verse.org/Verse 模块,不用显式引入就能用;模板里的第三行 Diagnostics 引入的是其他诊断工具。)
• hello_world_device := class(creative_device): —— 定义一块新积木。:= 读作「定义为」:hello_world_device 被定义为一个继承 creative_device 的类。注意这个带冒号的 :=,它和单独的 = 完全是两回事,常见坑一节见。:= 读作「定义为」——相当于在内容浏览器里右键新建一个蓝图类,并把 creative_device 选成它的父类(就像做一个 Child Blueprint Class)。留意它带着冒号:和单独的 = 是两码事,后者是「比较相不相等」而不是「定义」,常见坑一节见。
• OnBegin<override>()<suspends>:void = —— 开场哨。游戏体验一开始它就被自动调用,想让什么事在开局发生,就写在这里。尖括号里的 <override> 和 <suspends> 现在不用深究,记住「OnBegin 固定这么写」,下一课我们专门拆它。
• Print("...") —— 回声法术。把文字打到屏幕左上角的调试文字区和 UEFN 的输出日志(Output Log),是你以后天天要用的「确认代码跑没跑到」神器。
• # 开头的那行 —— 注释,写给人看的便签,机器直接跳过。

你已经能逐行读懂一段真正的 Verse 代码了——这可是很多人卡在「第一页」的地方。

四、缩进即代码块:4 个空格 = 一支小队

你可能注意到一个细节:这段代码里没有任何大括号来圈定「哪些代码属于谁」(using 后面那对花括号是模块路径的写法,不是代码块),行尾也没有分号。这段代码里没有一个用来圈定「哪些代码属于谁」的括号,行尾也没有任何收尾符号——这些符号本来就不是给你连蓝图时用的,不用找。(using 后面那对花括号是模块路径的写法,不是代码块。)Verse 靠的是缩进——每往右缩进 4 个空格,就表示「我隶属于上一层」。就像列队:站在队长身后同一列的,就是他的队员。

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

indent_demo := class(creative_device):

    OnBegin<override>()<suspends>:void =
        Print("我缩进在 OnBegin 之下,所以我属于 OnBegin")
        Print("我和上一行对齐,我们是同一小队")

读一下这段队形:OnBegin 缩进 4 格,所以它属于 indent_demo 这个类;两句 Print 再缩进 4 格,所以它们都属于 OnBegin,开局时会一句接一句执行。队形一旦站错——比如少打一个空格、或者混进一个 Tab——编译器就会报错,因为它读不懂这行代码「归谁管」。

三条保命贴士:① 缩进永远用 4 个空格,别用 Tab 和空格混搭;② 同一层级的代码必须严格对齐;③ 在 VS Code(官方指定的 Verse 编辑器,随 UEFN 一起安装 Verse 扩展)里按 Tab 会自动转成空格,放心敲。缩进不是装饰,它就是语法本身。

五、常见坑:从别的语言带来的条件反射蓝图和 Verse 想法不一样的地方

如果你碰过 C++、JavaScript 或 Python,有几个条件反射会在第一周反复坑你;如果你是纯新手,恭喜,这些坑对你反而不存在。提前把它们钉在墙上:

你是从蓝图连线过来的,严格说没有「别的文本语言」落下的坏习惯——不过下面这几条正好是蓝图的直觉和 Verse 不一样的地方,提前看一眼,能少踩几个坑:

• 把 = 当赋值用。在 Verse 里 := 才是「定义为」,单独的 = 是一次可失败的相等比较。想赋值却写了 X = 5,轻则编译错误,重则语义完全不是你想的那样。这是 Verse 和几乎所有主流语言最大的分歧点,第 4 课我们专门算这笔账。
• 以为等号就是「赋值」。在蓝图里你从没敲过等号,给变量换值都是拖一个 Set 节点。到了 Verse,给变量赋新值写作 set X = 5(就相当于那个 Set 节点);而单独的 = 是一次可失败的相等比较,不是赋值。把两者搞混轻则编译报错,重则逻辑完全跑偏,第 4 课专门算这笔账。
• 到处找分号和花括号。没有分号,没有代码块花括号,代码块就是缩进本身。从 C 系语言来的同学最常见的报错就是缩进不齐。
• 找不到「圈范围」的符号。Verse 里没有分号,也没有把代码块圈起来的花括号——哪几行算一组,全靠缩进对齐决定(上一节讲过)。蓝图里靠连线和摆放位置分层,Verse 里就靠缩进,别缩歪了。
• 以为 Build 完代码就跑了。编译成功只说明代码「合法」,Print 的输出只在启动会话(playtest session)后才会出现。光点 Build 然后盯着日志发呆,是每个新人都干过的事。
• 大小写手滑。Verse 完全区分大小写:print("hi") 无法通过编译,必须是 Print。官方命名约定也值得现在就记住:类型用小写 snake_case(如 creative_device),函数和标识符用 PascalCase(如 Print、OnBegin)。
• 大小写敲错。Verse 严格区分大小写:写成 print("hi") 编译不过,必须首字母大写的 Print。命名习惯记两条就够:设备和类型用全小写加下划线(像 creative_device),函数和变量名每个词首字母大写(像 Print、OnBegin)——这跟你在蓝图里给变量、函数起名的讲究其实一个道理。
• 拿着 UE C++ 文档来找 API。在 UEFN 里,Verse 能用的是 Epic 显式暴露的模块 API,不是整个引擎的任意角落。老老实实以 Verse API Reference 为准。
• 照搬蓝图节点表来猜 Verse 能干嘛。蓝图里能连的节点,不一定在 Verse 里有同名写法——Verse 只开放了 Epic 显式暴露的那部分能力(可以理解成官方给的「可用清单」)。查功能就以 Verse API Reference 为准,别照搬蓝图里的节点名。

六、关卡挑战

第一课的 Boss 战来了(放心,是史莱姆级别的)。答对拿星星 ★,答错可以无限重试,不掉血。

拓展阅读