最近后台好几个朋友在搜“superpowers”这个词我一看搜索记录里还带着“想要安装superpowers”这种需求第一反应是大家是不是把它当成什么系统增强工具、电源管理插件了单看这个英文单词直译就是“超能力”确实容易被当成某种玄乎的效率神器。但实际上superpowers在开发圈里是一个真实存在的游戏开发工作台全名就叫 Superpowers一个把整套游戏编辑器搬进浏览器的轻量级 IDE主打实时协作。我第一次接触它是因为团队想找一个“能多人同时改代码和场景”的网页游戏编辑器试来试去最后落到它头上。这篇文章我就把安装、首次使用、踩坑和后续玩法完整梳理一遍给那些搜到这个词、准备动手装的人一条能直接照着走的路。1. 它是个什么别把它当成系统工具它是一个浏览器里的游戏开发台1.1 核心概念IDE 跑在浏览器里数据落在服务器上Superpowers 和我平时用的 Unity、Godot 最大的不同是它没有一个“安装在你电脑上的大体积编辑器”。你把服务端跑起来之后真正的编辑界面是通过浏览器打开的打开之后就是一套完整的游戏开发环境场景视图、对象检查器、资源管理器、脚本编辑器全部集成在一个网页应用里。这个思路有点像用 VS Code 的 Remote 模式连到服务器开发只是 Superpowers 把整个编辑器本身都做成了网页应用。这个架构有个很直接的好处参与协作的人不需要各自安装编辑器。只要连到同一台运行着 Superpowers 服务端的机器用浏览器打开同一个地址就能开始干活。对独立游戏小团队、Game Jam 队伍或者你想拉个朋友一起做一个网页小游戏这个模式比传统引擎加版本管理的组合轻得多。1.2 和 Unity、Godot 这类传统引擎比主要差异在哪我用 Unity 做了好几个项目也拿 Godot 做过 2D 原型对比下来 Superpowers 的定位更像“轻量级网页游戏专用工作台”而不是“全平台通用引擎”。几个关键差异对比维度SuperpowersUnity / Godot编辑器形态浏览器内使用服务端运行独立桌面客户端脚本语言TypeScriptC# / GDScript 等协作方式原生实时协作多人同时编辑依赖外部版本控制和同步工具主要发布目标HTML5网页游戏多平台原生应用上手成本偏低界面简单概念少偏高编辑器复杂概念多它内置的脚本系统是基于 TypeScript 的如果你会 JavaScript 或 TypeScript几乎不需要额外学习语言。整个引擎的对象模型也比较“组件化”场景里每个实体是一个 ActorActor 上挂 Behavior 脚本组件再配合一些内置组件比如 TextSprite文字显示、SpriteRenderer贴图渲染之类逻辑上很接近 Godot 的 Node Script 思路但更精简。1.3 什么人适合装什么人可能会失望我觉得有这三类人会特别喜欢它一是想快速做 HTML5 小游戏、不想折腾发布流程的二是处在小团队里、希望“打开浏览器就能一起改游戏”的三是想拿一个干净简单的环境学游戏编程逻辑、但不想一上来就面对 Unity 那一堆面板的。反过来如果你追求的是高性能 3D 大作、想要移动端原生发布、或者特别依赖现成的大型资源商店生态那 Superpowers 目前不是你的菜继续用主流引擎更实际。下载下来试玩和真正拿它做项目是两码事。我在第一次安装之前也幻想它是个“更强大的游戏引擎”实际跑起来之后才意识到它的价值不在于功能堆得多满而在于“多人协作 极简的网页开发流程”这个组合本身。搞清楚它能解决什么安装之后才不会随手删掉。2. 安装指南桌面包、命令行服务端和第一次启动2.1 安装前的准备一台机器和一个现代浏览器Superpowers 的安装门槛非常低我反复确认过核心就两个一台能跑 Node.js 的机器以及一个较新的浏览器Chrome、Edge、Firefox 都行。服务端对操作系统不挑Windows、macOS、Linux 都有对应的包或者命令行方式。我自己在 Windows 和一台 Ubuntu 服务器上都跑过没碰到过平台相关的严重兼容问题。唯一要注意的是内存。编辑器的网页应用本身不重但如果你同时开着浏览器、Node 服务端、还有一堆游戏素材要做导入处理4GB 内存会有点紧张8GB 就比较从容了。磁盘方面Superpowers 的项目文件默认保存在服务端所在机器的数据目录里做小项目几百 MB 很够用。2.2 桌面包安装适合本地个人使用最省事的方式去官方的下载页拿到对应操作系统的桌面包这是最省事的路。Windows 下一般拿到的是一个压缩包或者安装程序解压或者装完之后包里有一个可执行文件双击它就会启动本地服务端。macOS 和 Linux 同理一个 App 图标双击就能跑起来。跑起来之后注意看终端窗口或者应用界面上的提示——它通常会显示一个本地地址比如http://localhost:9800然后会自动用浏览器打开这个地址。如果没自动打开你就手动把地址输进浏览器。我第一次装的时候还傻等它弹窗结果发现它是直接开了一个新标签页。这种桌面包的方式本质上等于“下载了一个自带服务端的客户端”你不用自己管 Node 环境对只想安安稳稳在本地做游戏的人来说非常友好。我后来换了台新电脑再装整个过程也就三四分钟。2.3 用命令行跑服务端适合服务器部署和多人协作如果你和我一样想把服务端跑在一台大家都能访问的机器上桌面包就不太够用了。这时候可以用 Node.js 环境直接装它的命令行版本。命令大概是这样的npm install -g superpowers superpowers装好之后在命令行里执行superpowers它就会在当前机器上拉起服务端默认情况下监听 9800 端口。启动日志里会打印出访问地址如果是本机就可以直接访问。要注意我写这个命令是基于我接触过的版本不同版本启动参数可能会有调整以你下载到的版本文档为准。这种方式的好处是灵活。把它部署到一台远程服务器上团队所有人通过服务器的 IP 或者端口访问同一个编辑环境就能实现“异地实时协作”这是桌面包模式不具备的。我后来推荐团队用的就是这个模式。2.4 启动常见问题打不开、白屏、端口被占用安装过程虽然简单但启动环节最容易出几个问题。第一个是双击桌面包之后浏览器没有自动打开这种情况多半是服务端还在初始化尤其是首次运行需要生成数据和认证信息等一两分钟再看。第二个是页面打开后一片白按 CtrlF5 强制刷新浏览器缓存多数能解决因为网页资源可能在本地缓存了不完整版本。第三个是端口占用。9800 是默认端口如果你本地有其他服务占用了它服务端会启动失败或者直接换一个端口。处理办法很朴素找到占用端口的进程关掉或者改掉 Superpowers 的监听端口。我个人最常用的是换端口启动时带上端口参数比如--port 9801前提是版本支持这个参数。Windows 下查端口占用我一般用netstat -ano | findstr :9800把 PID 对应的进程结束掉再重新启动服务端问题就解决了。这几种问题都是“看起来吓人实际很简单”的类型我踩过一遍之后后面再给朋友装就顺手了。3. 第一次进编辑器注册账号、建项目、让角色动起来3.1 初始账号和“服务器模式”是怎么回事浏览器终于打开编辑器界面之后第一件事不是建项目而是注册账号。这个账号不是某个平台的账号而是这台服务器本地的账号由服务端自己管理。头一次访问的时候界面一般会引导你注册一个新的用户之后每次协作都通过这个账号体系登录。这里有个值得理解的设计Superpowers 里的定位不是一个单人编辑器而是一台“游戏开发服务器”。每个用户登录之后看到的项目列表属于这台服务器。如果你是桌面包那这台服务器就是你的本机如果你们团队共用一台远程服务器那所有人登录后看到的是同一批项目互相之间的操作会实时同步给对方。我建议第一次注册别随便乱填因为以后项目的创建者、管理员权限都挂在用户体系上。但也不用过度紧张普通本地使用账号密码记牢就行。3.2 新建项目和场景从头开始的关键选择登录之后界面上会有项目列表和一个“新建项目”的按钮。点进去要填项目名称有些版本还会让你选择初始模板。模板这个东西我不太建议跳过因为它会帮你建一个可以直接运行的空白场景省去从零搭目录结构的麻烦。填完项目名称进入项目之后你看到的是一套完整编辑器界面左边是资源列表中间是场景编辑视图右边是对象和组件的属性面板底部还有脚本编辑器和控制台。我第一次进去有种“这不就是一个网页版 Unity 吗”的感觉但界面比 Unity 干净很多。建好项目之后项目里通常会有一个场景文件双击打开它才能进入编辑场景的状态。没有打开场景的时候中间区域是空的操作对象也无从谈起。我见过有朋友卡在“为什么我建了项目还是什么都点不了”十有八九就是忘了双击打开场景。3.3 让第一个角色动起来写一个最简单的 Behavior 脚本场景打开之后右键创建区域一般可以创建一个“Actor”这就是游戏实体。创建后它出现在场景层级里图上可能只是一个空对象。要让它有表现需要给它挂一个组件最简单的做法是写一个脚本来控制它。Superpowers 的脚本系统是基于 TypeScript 的脚本文件后缀是.ts。我给一个最小示例这是当时我跑通的第一段逻辑结构比较简单新版本里 API 名称可能有细微调整但思路不变import { Actor, Behavior, TextSprite } from superpowers; export default class HelloBehavior extends Behavior { init() { // 给这个 Actor 挂一个显示文字的组件 const text new TextSprite(this.actor, Hello Superpowers); text.setColor(#ffcc00); this.actor.setLocalPosition(0, 0.5, 0); } update(deltaTime: number) { // 每帧执行一次让 Actor 绕 Y 轴旋转 this.actor.rotateY(deltaTime); } }脚本写完之后把它拖拽到场景中 Actor 的组件列表里或者通过“添加组件”选择这个脚本运行项目就能看到场景里出现一行文字并且持续旋转。update(deltaTime)这个写法对做过游戏开发的人来说应该不陌生每帧执行一次deltaTime是上一帧到这一帧的时间差用于保证运动速度跟帧率解耦。这一步是整个编辑器里最核心的操作链路创建实体、挂组件、写逻辑、运行预览。后面不管做多复杂的游戏底子都是这套流程。3.4 运行预览和基本操作习惯编辑器顶部一般会有一个运行按钮点它会在当前场景里实时预览游戏效果。预览和编辑可以同时存在改动脚本之后预览界面也会跟着刷新不会要求你先退出再重进。这个体验对调试很舒服尤其是后来我们团队协作的时候一个人改逻辑另一个人立刻能在自己屏幕的预览里看到变化。我自己在最初上手时养成的一个习惯是一开始先刻意少用复杂组件只用 Actor 一个 Behavior 脚本把“运行循环”跑通再用 Sprite 或者地图编辑器搭场景。因为 Superpowers 的实体概念很简单过早去研究各种内置组件反而容易迷失。先把最小闭环跑通后面加功能是水到渠成的事。4. 内置工具与实时协作为什么这个平台适合小团队一起开发4.1 不只是写代码内置的地图、精灵和动画编辑能力Superpowers 不是单纯靠写代码堆游戏它也提供了一些直接操作的可视化工具。最常见的是一个地图编辑器可以拿瓦片素材直接拼 2D 关卡还有一个 Sprite 编辑器用来处理角色帧动画、从素材切片里定义动画序列。对做 2D 游戏来说这些内置工具解决了很大的问题你不用额外找 Tiled 这类外部地图工具再导入导出所有工作都收敛在同一个编辑器里。我现在做项目时美术朋友会直接在同一个工程里处理素材和动画我负责逻辑和玩法部分。因为没有导入导出流程双方看到的东西永远是一致的这个协作体验在传统引擎里通常要配置很多插件才能勉强接近。4.2 实时协作的体验为什么比“版本控制”更直接传统团队做游戏会用 Git 这类工具管理代码和场景文件每次改动都要提交、拉取、合并冲突。Superpowers 的协作机制完全绕开了这套多个用户编辑同一个项目时彼此的改动会实时同步到对方的编辑器里。你在这边创建一个 Actor那边立刻就能看到我在改脚本保存的瞬间你也已经拿到了改动后的文件。这背后的实现是服务端维护了一套一致性的数据同步模型客户端的每次操作都会即时推送到服务端再广播给其他在线客户端。它和 Google Docs 是类似的产品哲学但作用于游戏项目文件上。对于小团队这省掉的“切换上下文”时间非常可观几乎不需要开一个独立的通讯工具去同步进度。当然任何事情都有代价。实时协作弱化了“提交节点”这种历史记录意识如果某个人改坏了你没法像 Git 那样精准回溯到某个提交。所以要靠项目管理者更勤快地在关键节点做备份或者结合外部版本控制工具。这也是我后面会重点说“玩熟了往哪走”的原因之一。4.3 权限模型和“谁可以动什么”多人协作必然涉及权限问题。Superpowers 的服务器项目提供了一套简单的角色体系我记得大致包括成员、操作员、管理员这几类。成员通常可以编辑内容和玩法逻辑操作员能管理项目里的资源结构和一些设置管理员则拥有最高控制权包括删改项目、管理其他成员权限。实际使用中我的建议是项目创建者别把所有人都设成管理员一个小团队里有两三个管理员足够了。权限拉太平谁都能删项目、改配置除非团队纪律性极强否则迟早出问题。我团队里就出现过一次误删素材的事故还好之前在服务端做过备份从那以后我再也没让新人拿管理员权限练手。4.4 素材管理和简单发布路径素材方面Superpowers 支持把图片、声音等资源直接拖进资源面板导入。图片一般用 PNG、SVG 这类 Web 友好的格式声音也建议用 WebM、OGG 或者 MP3 这类浏览器能直接播的格式毕竟是面向 HTML5 的游戏环境。导入后在场景里使用不需要额外写加载逻辑系统会自动管理缓存和引用。发布目标主要是 HTML5。编辑器的导出或构建功能不同版本位置不太一样会生成一份可以在浏览器运行的网页游戏包你把它放到任何静态服务器上就能在线玩。这个特性特别适合做 Game Jam 作品、教学演示或者想快速丢给朋友体验的小游戏。不用配原生打包工具链是它比较省心的地方。5. 我踩过的坑端口、中文、协作不同步这些真实问题5.1 端口占用导致服务起不来查进程和换端口的完整链路前面提过端口占用但我在这里展开说一次完整的排查过程。当时我把服务端部署到一台公网服务器上结果运行命令后没反应终端只报了一行“端口被占用”之类的错误。我第一反应不是猜而是直接查端口sudo lsof -i :9800查到 PID 之后我看了下进程名发现是另一个 Node 服务占着这个端口跟我的项目毫无关系。我把那个服务结束掉再启动 Superpowers 就正常了。如果你不想动别人的服务也可以换一个端口启动前提是记得把防火墙和安全组的端口也放行不然从外部还是没法访问。这里分享一下我的经验不管是桌面包还是命令行方式只要启动没报错但浏览器打不开页面优先检查端口监听状态和防火墙这两板斧能解决八成问题。5.2 项目文件和素材用中文名乱码和引用丢失的教训我刚开始做项目时习惯用中文命名比如“第一章场景”“主角素材”地图编辑器里拼着拼着就发现资源列表里出现乱码个别素材文件甚至显示引用失效。这个问题的根因是服务端在文件存储和素材索引时对 Unicode 文件名的处理在不同版本里有差异尤其在跨平台服务器上容易出现。从那以后我给自己定了个规矩项目内部所有文件名、资源名、脚本类名一律用英文和数字顶多加下划线。项目描述和文档里可以写中文但物理文件名坚决不用。这个习惯看起来不起眼却能避免很多莫名其妙的引用问题希望看到这里的朋友直接抄走。5.3 协作时看不到对方改动缓存、刷新和分支项目的问题有一次团队小伙伴在我项目里改了脚本我却怎么刷新都看不到改动。折腾了一圈发现他改的是他本地桌面包拉起的一个项目而我连的是服务器上的另一份两个人虽然界面看起来一样但根本不在一台服务端上。这个坑很隐蔽如果每个人各自跑桌面包来“协作”那是假协作因为数据根本不同步。另一次是对方明明改在服务器上我这边界面还是旧的样子强制刷新浏览器缓存才刷出来。所以遇到协作不同步先确认大家连的是不是同一个地址再看浏览器缓存顺序不要反。先查地址比先刷缓存更靠谱。5.4 TypeScript 版本差异和编辑器提示延迟用内置脚本编辑器写 TypeScript有时候会感觉自动补全提示跟不上或者某些写法在旧例子里能用但在当前版本报红。Superpowers 集成了一套 TypeScript 编辑能力但它的类型提示和报错有时候不是实时刷新的尤其是在多人同时编辑的时候底层的类型检查可能延迟几秒。我处理这类问题的办法是写代码时尽量显式标注类型别依赖自动补全给答案遇到报红先等几秒若还没消除再从导入路径和 API 签名入手排查。还有一个实用技巧是查看项目模板里自带的示例脚本那里面通常就是当前版本最准确的 API 用法比网上搜旧教程靠谱得多。6. 玩熟之后的下一步版本管理、发布和一些个人体会6.1 用外部版本控制做备份点弥补协作历史记录不足前面说到实时协作缺少清晰的提交节点我自己的做法是在服务器上定期把项目数据目录做快照或者在关键节点用文件级别的备份工具把项目目录压成一个压缩包存起来。如果项目代码量大也可以把ts脚本和资源文件纳入 Git 仓库但要注意场景文件这类二进制/结构化数据在 Git 里不太好做合并适合把它当“只备份不回滚”的对象。我经历过几次改坏之后想回退却找不到干净版本的尴尬后来固定成每周一次全量备份重要节点手动再打一个包。这样既享受实时协作的流畅又留了后悔药两者兼得。6.2 发布 HTML5 游戏的路径静态托管和 Game Jam游戏做出来之后最爽的一刻就是拿去给别人玩。Superpowers 做出来的产物本来就是网页游戏形态只需要把构建好的静态文件放到一个静态站点托管服务上分享一个链接对方就能直接开玩。我试过在本地起一个简单的静态服务来验证产物再整个拖到托管平台整个过程通常几分钟搞定。对 Game Jam 场景来说这个发布速度是巨大优势。你凌晨想出玩法早上做完原型中午直接把试玩链接丢给朋友拉票很顺滑。比老式引擎“导出、打包、找空间放”的链路快得多。如果你追求的是“让作品尽量多人看到”这个流程非常划算。6.3 我个人的使用体会适合什么不该用什么最后聊点主观的东西。很多人一听说“游戏开发平台”第一反应是拿它和行业头部引擎比功能数量我觉得这比较方向就错了。Superpowers 的舒服在于它致敬的是“小而美”的路线打开浏览器就能开工、多人同时编辑、素材工具内置、发布网页游戏极简。它不是让你一个人做 3A 大作而是让两三个人的小团队能把一个网页游戏的完整想法迅速落地。我现在用它做点小卡牌游戏的原型和线下活动用的小互动游戏效率比 Unity 高很多因为不需要为“导出到手机”“接入各种 SDK”这些事分心。如果你正在搜“想要安装 superpowers”并且思路也是快速做网页游戏、体验多人协作那它很适合你。装完之后建议先用一个极其简单的原型跑通全部流程再慢慢往里面加东西这个软件不会辜负你的好奇心只要别用错它的定位。
最近后台好几个朋友在搜“superpowers”这个词我一看搜索记录里还带着“想要安装superpowers”这种需求第一反应是大家是不是把它当成什么系统增强工具、电源管理插件了单看这个英文单词直译就是“超能力”确实容易被当成某种玄乎的效率神器。但实际上superpowers在开发圈里是一个真实存在的游戏开发工作台全名就叫 Superpowers一个把整套游戏编辑器搬进浏览器的轻量级 IDE主打实时协作。我第一次接触它是因为团队想找一个“能多人同时改代码和场景”的网页游戏编辑器试来试去最后落到它头上。这篇文章我就把安装、首次使用、踩坑和后续玩法完整梳理一遍给那些搜到这个词、准备动手装的人一条能直接照着走的路。1. 它是个什么别把它当成系统工具它是一个浏览器里的游戏开发台1.1 核心概念IDE 跑在浏览器里数据落在服务器上Superpowers 和我平时用的 Unity、Godot 最大的不同是它没有一个“安装在你电脑上的大体积编辑器”。你把服务端跑起来之后真正的编辑界面是通过浏览器打开的打开之后就是一套完整的游戏开发环境场景视图、对象检查器、资源管理器、脚本编辑器全部集成在一个网页应用里。这个思路有点像用 VS Code 的 Remote 模式连到服务器开发只是 Superpowers 把整个编辑器本身都做成了网页应用。这个架构有个很直接的好处参与协作的人不需要各自安装编辑器。只要连到同一台运行着 Superpowers 服务端的机器用浏览器打开同一个地址就能开始干活。对独立游戏小团队、Game Jam 队伍或者你想拉个朋友一起做一个网页小游戏这个模式比传统引擎加版本管理的组合轻得多。1.2 和 Unity、Godot 这类传统引擎比主要差异在哪我用 Unity 做了好几个项目也拿 Godot 做过 2D 原型对比下来 Superpowers 的定位更像“轻量级网页游戏专用工作台”而不是“全平台通用引擎”。几个关键差异对比维度SuperpowersUnity / Godot编辑器形态浏览器内使用服务端运行独立桌面客户端脚本语言TypeScriptC# / GDScript 等协作方式原生实时协作多人同时编辑依赖外部版本控制和同步工具主要发布目标HTML5网页游戏多平台原生应用上手成本偏低界面简单概念少偏高编辑器复杂概念多它内置的脚本系统是基于 TypeScript 的如果你会 JavaScript 或 TypeScript几乎不需要额外学习语言。整个引擎的对象模型也比较“组件化”场景里每个实体是一个 ActorActor 上挂 Behavior 脚本组件再配合一些内置组件比如 TextSprite文字显示、SpriteRenderer贴图渲染之类逻辑上很接近 Godot 的 Node Script 思路但更精简。1.3 什么人适合装什么人可能会失望我觉得有这三类人会特别喜欢它一是想快速做 HTML5 小游戏、不想折腾发布流程的二是处在小团队里、希望“打开浏览器就能一起改游戏”的三是想拿一个干净简单的环境学游戏编程逻辑、但不想一上来就面对 Unity 那一堆面板的。反过来如果你追求的是高性能 3D 大作、想要移动端原生发布、或者特别依赖现成的大型资源商店生态那 Superpowers 目前不是你的菜继续用主流引擎更实际。下载下来试玩和真正拿它做项目是两码事。我在第一次安装之前也幻想它是个“更强大的游戏引擎”实际跑起来之后才意识到它的价值不在于功能堆得多满而在于“多人协作 极简的网页开发流程”这个组合本身。搞清楚它能解决什么安装之后才不会随手删掉。2. 安装指南桌面包、命令行服务端和第一次启动2.1 安装前的准备一台机器和一个现代浏览器Superpowers 的安装门槛非常低我反复确认过核心就两个一台能跑 Node.js 的机器以及一个较新的浏览器Chrome、Edge、Firefox 都行。服务端对操作系统不挑Windows、macOS、Linux 都有对应的包或者命令行方式。我自己在 Windows 和一台 Ubuntu 服务器上都跑过没碰到过平台相关的严重兼容问题。唯一要注意的是内存。编辑器的网页应用本身不重但如果你同时开着浏览器、Node 服务端、还有一堆游戏素材要做导入处理4GB 内存会有点紧张8GB 就比较从容了。磁盘方面Superpowers 的项目文件默认保存在服务端所在机器的数据目录里做小项目几百 MB 很够用。2.2 桌面包安装适合本地个人使用最省事的方式去官方的下载页拿到对应操作系统的桌面包这是最省事的路。Windows 下一般拿到的是一个压缩包或者安装程序解压或者装完之后包里有一个可执行文件双击它就会启动本地服务端。macOS 和 Linux 同理一个 App 图标双击就能跑起来。跑起来之后注意看终端窗口或者应用界面上的提示——它通常会显示一个本地地址比如http://localhost:9800然后会自动用浏览器打开这个地址。如果没自动打开你就手动把地址输进浏览器。我第一次装的时候还傻等它弹窗结果发现它是直接开了一个新标签页。这种桌面包的方式本质上等于“下载了一个自带服务端的客户端”你不用自己管 Node 环境对只想安安稳稳在本地做游戏的人来说非常友好。我后来换了台新电脑再装整个过程也就三四分钟。2.3 用命令行跑服务端适合服务器部署和多人协作如果你和我一样想把服务端跑在一台大家都能访问的机器上桌面包就不太够用了。这时候可以用 Node.js 环境直接装它的命令行版本。命令大概是这样的npm install -g superpowers superpowers装好之后在命令行里执行superpowers它就会在当前机器上拉起服务端默认情况下监听 9800 端口。启动日志里会打印出访问地址如果是本机就可以直接访问。要注意我写这个命令是基于我接触过的版本不同版本启动参数可能会有调整以你下载到的版本文档为准。这种方式的好处是灵活。把它部署到一台远程服务器上团队所有人通过服务器的 IP 或者端口访问同一个编辑环境就能实现“异地实时协作”这是桌面包模式不具备的。我后来推荐团队用的就是这个模式。2.4 启动常见问题打不开、白屏、端口被占用安装过程虽然简单但启动环节最容易出几个问题。第一个是双击桌面包之后浏览器没有自动打开这种情况多半是服务端还在初始化尤其是首次运行需要生成数据和认证信息等一两分钟再看。第二个是页面打开后一片白按 CtrlF5 强制刷新浏览器缓存多数能解决因为网页资源可能在本地缓存了不完整版本。第三个是端口占用。9800 是默认端口如果你本地有其他服务占用了它服务端会启动失败或者直接换一个端口。处理办法很朴素找到占用端口的进程关掉或者改掉 Superpowers 的监听端口。我个人最常用的是换端口启动时带上端口参数比如--port 9801前提是版本支持这个参数。Windows 下查端口占用我一般用netstat -ano | findstr :9800把 PID 对应的进程结束掉再重新启动服务端问题就解决了。这几种问题都是“看起来吓人实际很简单”的类型我踩过一遍之后后面再给朋友装就顺手了。3. 第一次进编辑器注册账号、建项目、让角色动起来3.1 初始账号和“服务器模式”是怎么回事浏览器终于打开编辑器界面之后第一件事不是建项目而是注册账号。这个账号不是某个平台的账号而是这台服务器本地的账号由服务端自己管理。头一次访问的时候界面一般会引导你注册一个新的用户之后每次协作都通过这个账号体系登录。这里有个值得理解的设计Superpowers 里的定位不是一个单人编辑器而是一台“游戏开发服务器”。每个用户登录之后看到的项目列表属于这台服务器。如果你是桌面包那这台服务器就是你的本机如果你们团队共用一台远程服务器那所有人登录后看到的是同一批项目互相之间的操作会实时同步给对方。我建议第一次注册别随便乱填因为以后项目的创建者、管理员权限都挂在用户体系上。但也不用过度紧张普通本地使用账号密码记牢就行。3.2 新建项目和场景从头开始的关键选择登录之后界面上会有项目列表和一个“新建项目”的按钮。点进去要填项目名称有些版本还会让你选择初始模板。模板这个东西我不太建议跳过因为它会帮你建一个可以直接运行的空白场景省去从零搭目录结构的麻烦。填完项目名称进入项目之后你看到的是一套完整编辑器界面左边是资源列表中间是场景编辑视图右边是对象和组件的属性面板底部还有脚本编辑器和控制台。我第一次进去有种“这不就是一个网页版 Unity 吗”的感觉但界面比 Unity 干净很多。建好项目之后项目里通常会有一个场景文件双击打开它才能进入编辑场景的状态。没有打开场景的时候中间区域是空的操作对象也无从谈起。我见过有朋友卡在“为什么我建了项目还是什么都点不了”十有八九就是忘了双击打开场景。3.3 让第一个角色动起来写一个最简单的 Behavior 脚本场景打开之后右键创建区域一般可以创建一个“Actor”这就是游戏实体。创建后它出现在场景层级里图上可能只是一个空对象。要让它有表现需要给它挂一个组件最简单的做法是写一个脚本来控制它。Superpowers 的脚本系统是基于 TypeScript 的脚本文件后缀是.ts。我给一个最小示例这是当时我跑通的第一段逻辑结构比较简单新版本里 API 名称可能有细微调整但思路不变import { Actor, Behavior, TextSprite } from superpowers; export default class HelloBehavior extends Behavior { init() { // 给这个 Actor 挂一个显示文字的组件 const text new TextSprite(this.actor, Hello Superpowers); text.setColor(#ffcc00); this.actor.setLocalPosition(0, 0.5, 0); } update(deltaTime: number) { // 每帧执行一次让 Actor 绕 Y 轴旋转 this.actor.rotateY(deltaTime); } }脚本写完之后把它拖拽到场景中 Actor 的组件列表里或者通过“添加组件”选择这个脚本运行项目就能看到场景里出现一行文字并且持续旋转。update(deltaTime)这个写法对做过游戏开发的人来说应该不陌生每帧执行一次deltaTime是上一帧到这一帧的时间差用于保证运动速度跟帧率解耦。这一步是整个编辑器里最核心的操作链路创建实体、挂组件、写逻辑、运行预览。后面不管做多复杂的游戏底子都是这套流程。3.4 运行预览和基本操作习惯编辑器顶部一般会有一个运行按钮点它会在当前场景里实时预览游戏效果。预览和编辑可以同时存在改动脚本之后预览界面也会跟着刷新不会要求你先退出再重进。这个体验对调试很舒服尤其是后来我们团队协作的时候一个人改逻辑另一个人立刻能在自己屏幕的预览里看到变化。我自己在最初上手时养成的一个习惯是一开始先刻意少用复杂组件只用 Actor 一个 Behavior 脚本把“运行循环”跑通再用 Sprite 或者地图编辑器搭场景。因为 Superpowers 的实体概念很简单过早去研究各种内置组件反而容易迷失。先把最小闭环跑通后面加功能是水到渠成的事。4. 内置工具与实时协作为什么这个平台适合小团队一起开发4.1 不只是写代码内置的地图、精灵和动画编辑能力Superpowers 不是单纯靠写代码堆游戏它也提供了一些直接操作的可视化工具。最常见的是一个地图编辑器可以拿瓦片素材直接拼 2D 关卡还有一个 Sprite 编辑器用来处理角色帧动画、从素材切片里定义动画序列。对做 2D 游戏来说这些内置工具解决了很大的问题你不用额外找 Tiled 这类外部地图工具再导入导出所有工作都收敛在同一个编辑器里。我现在做项目时美术朋友会直接在同一个工程里处理素材和动画我负责逻辑和玩法部分。因为没有导入导出流程双方看到的东西永远是一致的这个协作体验在传统引擎里通常要配置很多插件才能勉强接近。4.2 实时协作的体验为什么比“版本控制”更直接传统团队做游戏会用 Git 这类工具管理代码和场景文件每次改动都要提交、拉取、合并冲突。Superpowers 的协作机制完全绕开了这套多个用户编辑同一个项目时彼此的改动会实时同步到对方的编辑器里。你在这边创建一个 Actor那边立刻就能看到我在改脚本保存的瞬间你也已经拿到了改动后的文件。这背后的实现是服务端维护了一套一致性的数据同步模型客户端的每次操作都会即时推送到服务端再广播给其他在线客户端。它和 Google Docs 是类似的产品哲学但作用于游戏项目文件上。对于小团队这省掉的“切换上下文”时间非常可观几乎不需要开一个独立的通讯工具去同步进度。当然任何事情都有代价。实时协作弱化了“提交节点”这种历史记录意识如果某个人改坏了你没法像 Git 那样精准回溯到某个提交。所以要靠项目管理者更勤快地在关键节点做备份或者结合外部版本控制工具。这也是我后面会重点说“玩熟了往哪走”的原因之一。4.3 权限模型和“谁可以动什么”多人协作必然涉及权限问题。Superpowers 的服务器项目提供了一套简单的角色体系我记得大致包括成员、操作员、管理员这几类。成员通常可以编辑内容和玩法逻辑操作员能管理项目里的资源结构和一些设置管理员则拥有最高控制权包括删改项目、管理其他成员权限。实际使用中我的建议是项目创建者别把所有人都设成管理员一个小团队里有两三个管理员足够了。权限拉太平谁都能删项目、改配置除非团队纪律性极强否则迟早出问题。我团队里就出现过一次误删素材的事故还好之前在服务端做过备份从那以后我再也没让新人拿管理员权限练手。4.4 素材管理和简单发布路径素材方面Superpowers 支持把图片、声音等资源直接拖进资源面板导入。图片一般用 PNG、SVG 这类 Web 友好的格式声音也建议用 WebM、OGG 或者 MP3 这类浏览器能直接播的格式毕竟是面向 HTML5 的游戏环境。导入后在场景里使用不需要额外写加载逻辑系统会自动管理缓存和引用。发布目标主要是 HTML5。编辑器的导出或构建功能不同版本位置不太一样会生成一份可以在浏览器运行的网页游戏包你把它放到任何静态服务器上就能在线玩。这个特性特别适合做 Game Jam 作品、教学演示或者想快速丢给朋友体验的小游戏。不用配原生打包工具链是它比较省心的地方。5. 我踩过的坑端口、中文、协作不同步这些真实问题5.1 端口占用导致服务起不来查进程和换端口的完整链路前面提过端口占用但我在这里展开说一次完整的排查过程。当时我把服务端部署到一台公网服务器上结果运行命令后没反应终端只报了一行“端口被占用”之类的错误。我第一反应不是猜而是直接查端口sudo lsof -i :9800查到 PID 之后我看了下进程名发现是另一个 Node 服务占着这个端口跟我的项目毫无关系。我把那个服务结束掉再启动 Superpowers 就正常了。如果你不想动别人的服务也可以换一个端口启动前提是记得把防火墙和安全组的端口也放行不然从外部还是没法访问。这里分享一下我的经验不管是桌面包还是命令行方式只要启动没报错但浏览器打不开页面优先检查端口监听状态和防火墙这两板斧能解决八成问题。5.2 项目文件和素材用中文名乱码和引用丢失的教训我刚开始做项目时习惯用中文命名比如“第一章场景”“主角素材”地图编辑器里拼着拼着就发现资源列表里出现乱码个别素材文件甚至显示引用失效。这个问题的根因是服务端在文件存储和素材索引时对 Unicode 文件名的处理在不同版本里有差异尤其在跨平台服务器上容易出现。从那以后我给自己定了个规矩项目内部所有文件名、资源名、脚本类名一律用英文和数字顶多加下划线。项目描述和文档里可以写中文但物理文件名坚决不用。这个习惯看起来不起眼却能避免很多莫名其妙的引用问题希望看到这里的朋友直接抄走。5.3 协作时看不到对方改动缓存、刷新和分支项目的问题有一次团队小伙伴在我项目里改了脚本我却怎么刷新都看不到改动。折腾了一圈发现他改的是他本地桌面包拉起的一个项目而我连的是服务器上的另一份两个人虽然界面看起来一样但根本不在一台服务端上。这个坑很隐蔽如果每个人各自跑桌面包来“协作”那是假协作因为数据根本不同步。另一次是对方明明改在服务器上我这边界面还是旧的样子强制刷新浏览器缓存才刷出来。所以遇到协作不同步先确认大家连的是不是同一个地址再看浏览器缓存顺序不要反。先查地址比先刷缓存更靠谱。5.4 TypeScript 版本差异和编辑器提示延迟用内置脚本编辑器写 TypeScript有时候会感觉自动补全提示跟不上或者某些写法在旧例子里能用但在当前版本报红。Superpowers 集成了一套 TypeScript 编辑能力但它的类型提示和报错有时候不是实时刷新的尤其是在多人同时编辑的时候底层的类型检查可能延迟几秒。我处理这类问题的办法是写代码时尽量显式标注类型别依赖自动补全给答案遇到报红先等几秒若还没消除再从导入路径和 API 签名入手排查。还有一个实用技巧是查看项目模板里自带的示例脚本那里面通常就是当前版本最准确的 API 用法比网上搜旧教程靠谱得多。6. 玩熟之后的下一步版本管理、发布和一些个人体会6.1 用外部版本控制做备份点弥补协作历史记录不足前面说到实时协作缺少清晰的提交节点我自己的做法是在服务器上定期把项目数据目录做快照或者在关键节点用文件级别的备份工具把项目目录压成一个压缩包存起来。如果项目代码量大也可以把ts脚本和资源文件纳入 Git 仓库但要注意场景文件这类二进制/结构化数据在 Git 里不太好做合并适合把它当“只备份不回滚”的对象。我经历过几次改坏之后想回退却找不到干净版本的尴尬后来固定成每周一次全量备份重要节点手动再打一个包。这样既享受实时协作的流畅又留了后悔药两者兼得。6.2 发布 HTML5 游戏的路径静态托管和 Game Jam游戏做出来之后最爽的一刻就是拿去给别人玩。Superpowers 做出来的产物本来就是网页游戏形态只需要把构建好的静态文件放到一个静态站点托管服务上分享一个链接对方就能直接开玩。我试过在本地起一个简单的静态服务来验证产物再整个拖到托管平台整个过程通常几分钟搞定。对 Game Jam 场景来说这个发布速度是巨大优势。你凌晨想出玩法早上做完原型中午直接把试玩链接丢给朋友拉票很顺滑。比老式引擎“导出、打包、找空间放”的链路快得多。如果你追求的是“让作品尽量多人看到”这个流程非常划算。6.3 我个人的使用体会适合什么不该用什么最后聊点主观的东西。很多人一听说“游戏开发平台”第一反应是拿它和行业头部引擎比功能数量我觉得这比较方向就错了。Superpowers 的舒服在于它致敬的是“小而美”的路线打开浏览器就能开工、多人同时编辑、素材工具内置、发布网页游戏极简。它不是让你一个人做 3A 大作而是让两三个人的小团队能把一个网页游戏的完整想法迅速落地。我现在用它做点小卡牌游戏的原型和线下活动用的小互动游戏效率比 Unity 高很多因为不需要为“导出到手机”“接入各种 SDK”这些事分心。如果你正在搜“想要安装 superpowers”并且思路也是快速做网页游戏、体验多人协作那它很适合你。装完之后建议先用一个极其简单的原型跑通全部流程再慢慢往里面加东西这个软件不会辜负你的好奇心只要别用错它的定位。
