Verse Wiki — 写给蓝图作者的 Verse 手册
技巧 · EXTRA

今天就能跑 Verse 的三条路径

UE6 还没发布,那现在怎么练?三条路径:装 UEFN(今天唯一能真正编译运行 Verse 的地方)、只读练习(不装引擎也能学完语法)、等 UE6 Early Access(目标 2027 年底)。每条路各自要付出什么、能拿到什么,以及为什么换到 UE6 之后,语法一个字都不用重学。

一、路径一:装 UEFN —— 今天唯一能真正跑 Verse 的地方

先把话说明白:到今天为止,能把一段 Verse 代码真正编译并运行起来的地方只有 UEFN(Unreal Editor for Fortnite,Fortnite 的创作环境)。UE6 Early Access 的目标是 2027 年底,尚未发布;当前的稳定生产目标 UE 5.8 里,Verse 也还不用于生产。所以想看见自己的代码活过来,今天只有这一条路。

说清楚它在本站的角色:UEFN 是工具,不是主题。我们不教你怎么做 Fortnite 岛屿——我们借它的编译器和输出日志,把 Verse 这门语言跑给你看。

整个流程大致是这样,六步:

  1. 装编辑器。用 Epic 账号登录 Epic Games Launcher,在里面安装 UEFN(Windows / macOS)。它是独立于 UE5 的一个编辑器,不是 UE5 的插件。首次使用要接受创作者相关条款。
  2. 新建项目。从最空的岛屿模板开始就够——你要的是一个能编译的容器,不是一张好玩的地图。
  3. 新建 Verse 文件。打开 Verse Explorer 面板,在项目上右键新建一个 Verse 文件,选 Verse Device 模板。生成的代码和第 1 课那段 hello 设备是近亲。
  4. 改代码。Epic 推荐的编辑器是 VS Code,Verse 扩展随 UEFN 一起装好。在这里你会第一次看见语法高亮和补全。
  5. 编译。回到 UEFN 点 Build Verse Code。编译成功后,你写的这个设备类型会出现在内容浏览器里,可以像官方设备一样拖进关卡。
  6. 启动会话。点 Launch Session 开一次试玩。这一步才是「运行」——Print 的输出这时候才会出现在 Output Log 里。

最值得先记住的一条:编译 ≠ 运行。Build 成功只说明代码合法;不启动会话,OnBegin 永远不会被调用,日志里当然一行都不会有。「点了 Build 然后盯着空日志发呆」是每个新人的入门仪式,你可以跳过它。

代价也说清楚:要联网、要 Epic 账号、要装一整套 Fortnite 创作环境,磁盘占用不小,首次下载要点耐心。如果这些条件现在不方便,走下面第二条路,一样能把这本手册读完。

二、路径二:只读练习 —— 不装引擎,照样学完语法

这是被低估的一条路。编程语言里真正难的部分是规则和心智模型——为什么 = 不是赋值、缩进凭什么能代替连线、失败为什么不是异常。这些东西不需要编译器,只需要你愿意在脑子里跑一遍。

本站每一课都是照这个用法设计的:代码块给你读,步进器让你逐行看执行顺序,填空和小测逼你在合上答案的情况下先自己想一遍。推荐的读法是:

这条路学得到什么:语言的全部语法与规则、蓝图与 Verse 的名词对应、读懂别人代码的能力。学不到什么:手感——编译报错长什么样、资产和文件怎么组织、日志窗口在哪一栏、改完代码要点哪个按钮。好消息是这部分很浅:等你哪天装上 UEFN 或 UE6,半小时就能补齐;而反过来,靠点按钮是补不出语言理解的。

三、路径三:等 UE6 Early Access

完全正当的选择,尤其当你手上正有一个跑在 UE5 上的项目。事实先摆清楚:UE6 Early Access 的目标是 2027 年底,尚未发布;Actor 与 Blueprint 在 UE6 Early Access 及早期版本中完整支持;弃用要等 Scene Graph 足够成熟,时间未定;Epic 已承诺在弃用前提供转换工具,但尚未发布

所以「等」不会让你错过什么班车。唯一需要提醒的是:等待期不等于空白期。转换工具将来能替你搬运资产,搬不动的是判断力——工具吐出来的那一屏 Verse 代码,总得有人读得懂、改得动、审得了。那个人如果是你,你现在读的每一课都是提前量。

顺便堵一个常见误会:别去 UE 5.8 里找 Verse。UE 5.8 是当前的稳定生产目标,Verse 尚不用于 UE5 生产。今天要跑 Verse,还是回到路径一。

四、无论走哪条路:你学的是语言,不是某个编辑器

这是这一页最想让你带走的一句话。换到 UE6 之后,Verse 的语法一个字都不用重学;变的是它挂在什么框架上。下面这张表把「会变」和「不会变」分开:

东西 今天在 UEFN 到了 UE6
语法本身::=、缩进、setif 的失败语义、for、并发写法 就是这一套 不变
类型系统与效果说明符 就是这一套 不变
调试手法:Print 到输出日志 UEFN 的 Output Log 写法基本不变,换一个日志窗口
你继承的父类 class(creative_device) Scene Graph 的 component(会变)
世界模型 把设备摆进关卡 entity 挂 component(会变)
可用的 API 清单 Fortnite 相关模块 随框架变(会变)

看懂这张表,你就知道时间该花在哪儿:花在上面两行——语法和类型系统——的时间,是稳赚的;下面三行是 API 记忆,查文档就行,而且它本来就会随版本变。这也是本站的取舍:我们把绝大部分篇幅给语言,把框架留到第八章 Scene Graph,并且始终标注哪些是「今天的 UEFN 特有」。

五、小测一下

UE6 到来之后,你今天学的这套 Verse 语法会怎样?

来源与延伸

本文整理自 Epic 官方文档与官方新闻: