这是面向新手的教程,尤其是没有使用任何模板、开源工程,也没有任何研发经验的新手的教程。学完本教程你将知晓如何给自己的作品制作一个“编辑器”,以便你使用编辑器快速修改作品里的内容(尤其是改文案的时候格外好用)。
我以新手教程配套的开源工程《找回那个号》为例。该开源工程链接:https://lumi.66rpg.com/projects/4rpssk6gt3pc,对应的原版文游作品链接:https://lumi.66rpg.com/works/4r6tr0u1ih34
这是一个非常典型的“首次尝试制作”的文游,整个工程只有一个网页、和一堆美术音乐素材。下载其开源工程后,你可以在AI工具中对AI说“帮我运行这个游戏”,AI就会帮你把文件拷到合理的位置并打开网页。但是,如果你想编辑其中的文字内容,哪怕你是作者本人,也很麻烦——你只能跟AI说,“开头的剧情里,某某某句话改为balabala”。这么沟通很麻烦、修改效率也很差,又贵又慢。
这时候,你可能已经在怀念橙光制作工具的手搓功能了……那,不如直接让AI做个手搓工具。
简单介绍一下“手搓”的技术原理:浏览器一般是没有权限直接修改你硬盘上的文件的,所以仅通过“网页”是无法实现“制作器”的,必须有一个【后端】。你可以把“后端”理解为权限比较高的软件服务,浏览器告知后端“我要把某某文件的内容改成什么什么”,后端就可以去干这个事情、修改硬盘上的文件。
原理清晰了,那么使用AI工具打开工程,让AI给项目添加后端吧。这是一个非常大的修改,说白了AI就是在读懂原版游戏后,彻底重做了一遍。这个修改需要的时间比较长,一般可能会持续1小时以上。我在workbuddy中,使用Deepseek-Flash给AI的信息如下:
请先校验本机是否有必备的全局运行环境(如Node.js等);若环境缺失,请自动完成相关环境部署。完成环境校验之后,在当前工程目录,执行安装开发依赖:npm install @66rpg/lumimaker@latest --save-dev安装完成后执行同步说明书:npx lumimaker skill完成后,对项目文件夹下的工程进行重构,做到以下要求:1、仔细阅读本项目,完全理解全部代码功能后,使用 Vite + React + TypeScript ,彻底重构原游戏。游戏逻辑应以“前端状态机 + 数据驱动”的方式实现。与游戏内容相关的数据(如剧情文本、角色、数值、谜题、解锁条件、结局条件、界面文案、素材引用等)最终统一保存到 workspace/游戏名/final_game.json 这个单一文件。引擎代码只负责解释和渲染数据,不应把具体剧情、谜题答案、大段文案硬编码在组件中。重构后的版本,应当与原版游戏的效果完全一致(包括但不限于所有的交互、界面、逻辑等)。2、对游戏中的所有不同界面,制作 [编辑] 按钮,点击后可以打开独立的编辑界面。在编辑界面中可以对原游戏界面中的内容(保存于final_game.json中的数据)进行编辑、保存,并在保存之后立刻生效到游戏中。可编辑内容根据游戏界面的不同,包括但不限于选取图片、对话文字、故事剧本、线索文案、音乐、音效、数值逻辑……等。你应确保游戏中所有用户可感知的内容,皆可通过不同的 [编辑] 界面全部修改,且修改界面有合理、符合普通人使用习惯的交互界面。在后端开启的时候,在游戏界面合理位置显示明显的 [编辑] 按钮;在离线HTML版本中,不显示 [编辑] 按钮。3、设计一个 'run.bat',简单在控制台中开启/重启后端,并在浏览器中打开游戏。只开启一个控制台窗口,且当窗口被关闭的时候,关闭后端端口。为防止编码错误,该文件内容只允许使用英语。4、开发完成后,必须提供导出工具,将游戏构建为一个不依赖后端、可直接离线运行的纯 HTML 版本,保存在 workspace/游戏名/index.html。导出版应内联或打包所需的 JavaScript、CSS、final_game.json 数据与必要素材引用,确保玩家只打开该 HTML 文件即可游玩。导出的离线版必须与开发期版本在视觉表现和游戏逻辑上保持一致。
如果你懒得具体理解,直接用我上面这一段就行了,然后Deepseek会吭哧吭哧运行一个小时,就将整个项目重做为前端+后端的优秀架构,并为这款游戏增加了编辑器。别嫌AI做1个小时太慢,这种大型重构工作,放在以前古法编程纯手搓的年代,恐怕要一个优秀程序员做一个月……
制作完成后的效果如图:
制作过程中,如果你用的AI工具权限比较低(如workbuddy的默认值),可能在AI制作过程中会反复询问你是否允许删除临时文件。一般都同意就可以了。
你可以在本帖子的附件直接得到这个作品拥有后端版本的开源工程。由于AI完全重做了项目,所以可能也带来了一些新的BUG;且由于我没有对编辑器提具体界面要求,所以编辑器也做得很丑。我这个教程只用于抛砖引玉,您阅读和查看时不用纠结细节。
如果你想了解,那么粗略的解释就是:
0、开头的一段,是安装幻光文游制作工具(既然你能拿到这个纯网页的HTML文游,那很可能没有安装过幻光文游的制作工具,不如顺手安了,方便调整完后发布到社区)。其实,现在不安也行,等你发布时候再安也可以。
1、Vite + React + TypeScript 这段:这是提供了一个架构,让AI把原版游戏重做,并且在重做的时候把所有的“游戏数据”(故事、情节、对话、图片名、音乐名、数值等)全部保存在一个单独的文件里,命名为 final_game.json(这个.json是一种比较常用的轻量型逻辑格式,比较适合中短篇文游使用)。这样,后续只要修改 final_game.json 这一个文件里的字符串和变量,就可以调整游戏中绝大部分内容了。至于你问,"Vite + React + TypeScript" 这三个词是什么意思?不用在意,这是AI给的架构建议(我问AI用什么前端+后端的架构好,它回答的)。既然AI能给出这个建议,就说明AI能比较轻松使用这个架构,所以如果你不打算自己看代码的话,可以不用考虑这些词到底是什么意思了——能用就行。
2、关于编辑器,这是比较关键的一段,建议你阅读。其实就是对项目编辑器的要求,如果你有自己的需求(比如编辑器的界面是什么样),可以在这里仔细写出来。我建议是你用我提供的这段通用的提示词,先让AI做,做完如果不满意你再让AI改。
3、设计一个run.bat,双击可以打开后端,并在浏览器打开页面。这是为了方便(省的每次都得用AI工具、跟AI说"启动这个项目",又慢又贵)。
4、确保最终作品适合发布到网上,并给出一些质量要求。你说这一段里面的那几个英文是什么意思?不用在意,能用就行,这个整段都是AI写给它自己看的。
显然,这种“先做一个错误版本,然后让AI彻底重做”的方法,有点太麻烦了,我觉得只适用于“首次制作文游”的新手。如果你觉得自己已经过了新手阶段,想制作属于自己的正式作品,那我的建议是:
1、你可以优先考虑是否可以从幻光文游社区寻找 模板 或 开源工程——这一般都是经过检验的系统,基于这些成熟系统制作自己的故事,会事半功倍。
2、你也可以把我上面写的制作方法,在首次跟AI沟通的时候就提出来,让AI制作 Vite + React + TypeScript 架构、包含前端和后端的版本。也就是把我上面写的那段压缩一下,第一次就作为“技术要求”提给AI,比如:
技术要求:1、使用 Vite + React + TypeScript 制作游戏。游戏逻辑应以“前端状态机 + 数据驱动”的方式实现。与游戏内容相关的数据(如剧情文本、角色、数值、谜题、解锁条件、结局条件、界面文案、素材引用等)应统一保存到 workspace/游戏名/final_game.json 这个单一文件。引擎代码只负责解释和渲染数据,不应把具体剧情、谜题答案、大段文案硬编码在组件中。2、设计一个 'run.bat',简单在控制台中开启/重启后端,并在浏览器中打开游戏。只开启一个控制台窗口,且当窗口被关闭的时候,关闭后端端口。为防止编码错误,该文件内容只允许使用英语。3、开发完成后,必须提供导出工具,将游戏构建为一个不依赖后端、可直接离线运行的纯 HTML 版本,保存在 workspace/游戏名/index.html。导出版应内联或打包所需的 JavaScript、CSS、final_game.json 数据与必要素材引用,确保玩家只打开该 HTML 文件即可游玩。导出的离线版必须与开发期版本在视觉表现和游戏逻辑上保持一致。
这样就可以了。注意我在这里删除了“编辑器”的要求,因为首次生成的时候没有必要立刻做编辑器,你可以等首次生成后看看结果,在各种调整满意后,再让AI做编辑器(因为编辑器做起来又贵又慢,先调整满意再做编辑器,能减少返工)。
对了,如果首次提要求时包含了前端+后端,AI需要的时间一般会明显提升(假如你同时要求AI,“好好测试,不要有BUG”,那么时间还会再翻几倍)。如果使用Kimi-K3之类的模型,首次生成时间可能会直奔数小时而去,价格也可能会比较夸张,这就需要你自己权衡了……
大概就是这样喽,如果有什么问题可以回帖讨论~
加载中