10分钟做出第一部魔塔:mota-js魔塔样板快速开始教程
10分钟做出第一部魔塔:mota-js魔塔样板快速开始教程
mota-js 是一款开源的 HTML5 魔塔样板,支持全平台运行。它最大的亮点是即使完全不会编程,也能通过可视化编辑器和说明文档快速做出自己的魔塔游戏。本文将带你完成第一部魔塔的快速开始:从环境准备、启动服务,到绘制地图、添加事件,一步步落地实操。
🎯 为什么选择 mota-js?
mota-js 是一个功能完备的 HTML5 canvas 魔塔样板,具备以下新手友好的特性:
- 零代码门槛:内置可视化地图编辑器,拖拽图块、拼装事件块即可完成造塔,无需打开任何 JS 文件;
- 全平台支持:电脑、手机、平板均可游玩与制作,存档支持录像回放;
- 资料齐全:仓库自带完整中文文档 _docs/start.md、样例楼层 project/floors/ 和常用造塔小工具;
- 持续更新:核心运行时代码位于 libs/core.js,配合 runtime.d.ts 可在 VSCode 中获得完整的代码自动补全。
第一步:环境准备(2分钟)
开始前,请确认以下条件:
- 浏览器:Chrome 或 Win10 自带的新版 Edge(其他浏览器可能导致本地服务闪退);
- 本地服务:Windows 用户可直接双击运行根目录的
启动服务.exe;非 Windows 系统需安装 Python 3.9.6 或更高版本,命令行运行 server.py(注意:用 Python 启动时,项目路径必须全英文); - 文本编辑器(强烈推荐):VSCode,便于跨文件搜索和发挥 runtime.d.ts 的补全能力;
- 获取项目:
git clone https://gitcode.com/gh_mirrors/mo/mota-js
项目的关键目录结构如下,用户造塔的所有内容都在 project/ 目录下:
| 目录/文件 | 作用 |
|---|---|
| project/ | 项目目录,你的塔的所有素材、地图、事件都在这 |
| project/materials/ | 系统素材(怪物、NPC、道具图片) |
| project/floors/ | 各楼层剧本文件(地图数据+事件) |
| editor.html | 可视化地图编辑器入口(制作核心页面) |
| index.html | 游戏主程序入口 |
| 常用工具/ | PS工具、地图生成器、临界值计算器等辅助工具 |
第二步:启动本地服务(1分钟)
⚠️ 重要:整个造塔过程中,启动服务必须全程保持开启,否则所做的修改不会生效!
- 双击运行根目录的
启动服务.exe(Windows),或命令行执行python server.py(其他系统); - 服务启动后,浏览器打开
http://127.0.0.1:1055/index.html可玩样板自带的示例塔; - 打开
http://127.0.0.1:1055/editor.html(手机竖屏则为editor-mobile.html),这就是你整个制作流程的核心页面。
服务窗口会同时提供便捷PS工具、截图识别器、怪物数据导出等常用工具入口:
图片路径:
_docs/img/server.jpg(仓库内官方文档配图)
第三步:认识编辑器三大区域(3分钟)
编辑器页面分为三大板块,左侧数据区、中央地图区、右侧素材区:
- 数据区(左):随下拉框切换模式——按
Z键切到「地图编辑」(新建/删除楼层)、C键「图块属性」、X键「事件编辑」、V键「楼层属性」、B键「全塔属性」(勇士初始属性、全局数值); - 地图区(中):用滚轮切换楼层,在格子上绘制图块、绑定出生点与楼梯;
- 素材区(右):内置了 terrains、怪物、NPC、道具、自动元件等全部素材,选中后直接在地图上绘制。
新手必会的快捷键(按 H 键可查看全部):
| 快捷键 | 功能 |
|---|---|
Z / X / B / C / V |
切换数据区:地图编辑 / 事件 / 全塔属性 / 图块属性 / 楼层属性 |
WASD 或方向键 |
滚动大地图 |
Ctrl+S / Ctrl+Z |
保存 / 撤销 |
PageUp / PageDown 或滚轮 |
切换楼层 |
| 右键地图空白格 | 快速绑定出生点、楼梯、机关门 |
第四步:绘制你的第一层地图(3分钟)
- 设置出生点:滚轮切换到主塔 0 层,右键地图任意位置,选择「绑定出生点」,该点会出现一个大大的白色
S字母; - 填写初始属性:按
B键切到「全塔属性」,填写core.firstData.hero中勇士的血量、攻防等初始值,同时记得修改塔的name(唯一英文标识符);
- 画地图:从右侧素材区依次选中门、怪物、道具、楼梯、路障等图块,直接在地图区点击绘制。选中某个素材后,数据区会自动进入「图块属性」模式,可顺手填写道具说明、可通行性等;
- 加多楼层:按
Z切到「地图编辑」→「新建空白地图」,把楼梯画在地图上再右键快速绑定上下楼即可; - 保存:地图修改后点击「保存地图」(按钮变色提示未保存),改动即时生效,无需重启。
💡 小技巧:机关门只需把机关门和守卫画好后,右键机关门快速绑定(出现橙色小方块即成功);样板还内置了「公主通关」逻辑,把样板 1 层公主复制到 boss 身后即可获得胜利判定。
第五步:添加事件让地图"活"起来(3分钟)
事件是魔塔的灵魂。mota-js 的事件系统基于触发器:踩楼梯触发换层、碰门触发开门、碰怪触发战斗,这些系统事件全自动处理;而 NPC 对话等自定义事件则用事件编辑器完成。
按 X 键进入事件编辑模式,在地图上选点后,即可像搭积木一样拼装事件块(底层为 Blockly 可视化块):
以"点我强化"的老人为例:在事件块中添加「数值操作」提升勇士攻防,再添加「显示文本」对话块即可,全程无需写一行代码。事件编辑器的详细指令说明见官方文档 _docs/event.md。
第六步:调试与预览
游戏打开后按 F12 进入控制台,是排查问题的第一现场:
常用调试命令:
| 命令 | 作用 |
|---|---|
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 记录了默认实现供参考。
✅ 完成!下一步学什么?
恭喜你,第一部魔塔已经跑起来了!接下来建议按官方文档顺序深入学习:
- 元件与素材机制:_docs/element.md
- 事件触发原理与八种事件类型:_docs/event.md
- 事件指令大全:_docs/instruction.md
- 个性化改造(标题界面、天气、自绘状态栏):_docs/personalization.md
- 脚本与 API:_docs/script.md
- 仓库总览与更新日志:README.md
🎮 小提醒:发布作品前可用「常用工具」中的 JS 代码压缩工具减小体积;用 Python 启动服务时项目路径务必保持全英文;启动服务全程不要关闭!
跟着这份 mota-js 魔塔样板快速开始教程走一遍,从 clone 到可玩的第一部塔只需要约 10 分钟。现在就去启动 editor.html,画出你的第一格地图吧!





