10分钟做出第一部魔塔:mota-js魔塔样板快速开始教程

原创2026-11-15 12:28:27618 阅读
文章标签:游戏开发前端Web框架低代码

10分钟做出第一部魔塔:mota-js魔塔样板快速开始教程

mota-js 是一款开源的 HTML5 魔塔样板,支持全平台运行。它最大的亮点是即使完全不会编程,也能通过可视化编辑器和说明文档快速做出自己的魔塔游戏。本文将带你完成第一部魔塔的快速开始:从环境准备、启动服务,到绘制地图、添加事件,一步步落地实操。

mota-js HTML5魔塔样板游戏效果

🎯 为什么选择 mota-js?

mota-js 是一个功能完备的 HTML5 canvas 魔塔样板,具备以下新手友好的特性:

  • 零代码门槛:内置可视化地图编辑器,拖拽图块、拼装事件块即可完成造塔,无需打开任何 JS 文件;
  • 全平台支持:电脑、手机、平板均可游玩与制作,存档支持录像回放;
  • 资料齐全:仓库自带完整中文文档 _docs/start.md、样例楼层 project/floors/ 和常用造塔小工具;
  • 持续更新:核心运行时代码位于 libs/core.js,配合 runtime.d.ts 可在 VSCode 中获得完整的代码自动补全。

第一步:环境准备(2分钟)

开始前,请确认以下条件:

  1. 浏览器:Chrome 或 Win10 自带的新版 Edge(其他浏览器可能导致本地服务闪退);
  2. 本地服务:Windows 用户可直接双击运行根目录的 启动服务.exe;非 Windows 系统需安装 Python 3.9.6 或更高版本,命令行运行 server.py(注意:用 Python 启动时,项目路径必须全英文);
  3. 文本编辑器(强烈推荐):VSCode,便于跨文件搜索和发挥 runtime.d.ts 的补全能力;
  4. 获取项目:
git clone https://gitcode.com/gh_mirrors/mo/mota-js

项目的关键目录结构如下,用户造塔的所有内容都在 project/ 目录下:

目录/文件 作用
project/ 项目目录,你的塔的所有素材、地图、事件都在这
project/materials/ 系统素材(怪物、NPC、道具图片)
project/floors/ 各楼层剧本文件(地图数据+事件)
editor.html 可视化地图编辑器入口(制作核心页面)
index.html 游戏主程序入口
常用工具/ PS工具、地图生成器、临界值计算器等辅助工具

第二步:启动本地服务(1分钟)

⚠️ 重要:整个造塔过程中,启动服务必须全程保持开启,否则所做的修改不会生效!

  1. 双击运行根目录的 启动服务.exe(Windows),或命令行执行 python server.py(其他系统);
  2. 服务启动后,浏览器打开 http://127.0.0.1:1055/index.html 可玩样板自带的示例塔;
  3. 打开 http://127.0.0.1:1055/editor.html(手机竖屏则为 editor-mobile.html),这就是你整个制作流程的核心页面。

服务窗口会同时提供便捷PS工具、截图识别器、怪物数据导出等常用工具入口:

mota-js本地启动服务界面

图片路径:_docs/img/server.jpg(仓库内官方文档配图)

第三步:认识编辑器三大区域(3分钟)

编辑器页面分为三大板块,左侧数据区、中央地图区、右侧素材区:

mota-js可视化地图编辑器三大区域

  • 数据区(左):随下拉框切换模式——按 Z 键切到「地图编辑」(新建/删除楼层)、C 键「图块属性」、X 键「事件编辑」、V 键「楼层属性」、B 键「全塔属性」(勇士初始属性、全局数值);
  • 地图区(中):用滚轮切换楼层,在格子上绘制图块、绑定出生点与楼梯;
  • 素材区(右):内置了 terrains、怪物、NPC、道具、自动元件等全部素材,选中后直接在地图上绘制。

新手必会的快捷键(按 H 键可查看全部):

快捷键 功能
Z / X / B / C / V 切换数据区:地图编辑 / 事件 / 全塔属性 / 图块属性 / 楼层属性
WASD 或方向键 滚动大地图
Ctrl+S / Ctrl+Z 保存 / 撤销
PageUp / PageDown 或滚轮 切换楼层
右键地图空白格 快速绑定出生点、楼梯、机关门

第四步:绘制你的第一层地图(3分钟)

  1. 设置出生点:滚轮切换到主塔 0 层,右键地图任意位置,选择「绑定出生点」,该点会出现一个大大的白色 S 字母;
  2. 填写初始属性:按 B 键切到「全塔属性」,填写 core.firstData.hero 中勇士的血量、攻防等初始值,同时记得修改塔的 name(唯一英文标识符);

mota-js全塔属性表格配置界面

  1. 画地图:从右侧素材区依次选中门、怪物、道具、楼梯、路障等图块,直接在地图区点击绘制。选中某个素材后,数据区会自动进入「图块属性」模式,可顺手填写道具说明、可通行性等;
  2. 加多楼层:按 Z 切到「地图编辑」→「新建空白地图」,把楼梯画在地图上再右键快速绑定上下楼即可;
  3. 保存:地图修改后点击「保存地图」(按钮变色提示未保存),改动即时生效,无需重启。

💡 小技巧:机关门只需把机关门和守卫画好后,右键机关门快速绑定(出现橙色小方块即成功);样板还内置了「公主通关」逻辑,把样板 1 层公主复制到 boss 身后即可获得胜利判定。

第五步:添加事件让地图"活"起来(3分钟)

事件是魔塔的灵魂。mota-js 的事件系统基于触发器:踩楼梯触发换层、碰门触发开门、碰怪触发战斗,这些系统事件全自动处理;而 NPC 对话等自定义事件则用事件编辑器完成。

按 X 键进入事件编辑模式,在地图上选点后,即可像搭积木一样拼装事件块(底层为 Blockly 可视化块):

mota-js事件编辑器积木块编辑界面

以"点我强化"的老人为例:在事件块中添加「数值操作」提升勇士攻防,再添加「显示文本」对话块即可,全程无需写一行代码。事件编辑器的详细指令说明见官方文档 _docs/event.md。

第六步:调试与预览

游戏打开后按 F12 进入控制台,是排查问题的第一现场:

mota-js浏览器控制台调试魔塔游戏

常用调试命令:

命令 作用
core.debug() 开启调试模式,按住 Ctrl 可穿墙
core.setStatus('atk', 1000) 直接修改勇士攻击力
core.changeFloor('MT1', null, {'x': 4, 'y': 7}) 瞬间传送到指定楼层坐标
core.resetMap() 重置当前层地图

完整 API 列表见 _docs/api.md;若想在游戏里写 JS 逻辑(如灯光、天气),脚本编辑器在编辑器页面「脚本编写」入口,project/functions.js 记录了默认实现供参考。

✅ 完成!下一步学什么?

恭喜你,第一部魔塔已经跑起来了!接下来建议按官方文档顺序深入学习:

🎮 小提醒:发布作品前可用「常用工具」中的 JS 代码压缩工具减小体积;用 Python 启动服务时项目路径务必保持全英文;启动服务全程不要关闭!

跟着这份 mota-js 魔塔样板快速开始教程走一遍,从 clone 到可玩的第一部塔只需要约 10 分钟。现在就去启动 editor.html,画出你的第一格地图吧!

登录后查看全文
mota-js