mota-js API参考:200+个core.*函数速查清单,做魔塔不再查半天
mota-js API参考:200+个core.*函数速查清单,做魔塔不再查半天
mota-js 是一款 HTML5 魔塔样板,支持全平台运行。即使完全不会编程的用户,按照模板和说明文档也能快速做出一个魔塔游戏。本文整理出样板中 200+ 个 core. API 函数* 的速查清单,按模块分组讲解高频函数与状态对象,让你在写魔塔游戏脚本时随手可查、快速上手。
为什么所有函数都叫 core.*?
mota-js 的系统库由 11 个模块组成,位于 libs/ 目录:
| 模块文件 | 职责 | 方法数 |
|---|---|---|
| libs/control.js | 游戏逻辑控制(主角、属性、存档、回放) | 118 |
| libs/events.js | 事件处理(所有自定义事件的执行入口) | 81 |
| libs/maps.js | 地图信息与绘制 | 75 |
| libs/ui.js | UI 窗口绘制 | 64 |
| libs/utils.js | 工具函数 | 53 |
| libs/items.js | 道具逻辑 | 21 |
| libs/enemys.js | 怪物与伤害计算 | 17 |
| libs/actions.js | 用户交互(点击、按键) | 16 |
| libs/loader.js | 动态加载素材 | 7 |
| libs/icons.js | 图标信息 | 4 |
| libs/plugin.js | 插件扩展 | 9 |
游戏启动时,main.js 会把每个模块实例化后统一挂载到 core 对象上,所以你在脚本里只需要记住一个前缀:core.xxx()。方法总数超过 465 个,而真正日常高频使用的核心函数在 200 个左右——本文就聚焦这份速查清单。
主角属性速查:setStatus / getStatus / getRealStatus
这是魔塔游戏脚本中使用频率最高的三兄弟,实现在 libs/control.js:
| 函数 | 作用 | 典型示例 |
|---|---|---|
core.setStatus(name, value) |
设置主角属性 | core.setStatus('exp', 100) 加 100 经验 |
core.addStatus(name, value) |
增减主角属性 | core.addStatus('money', 50) |
core.getStatus(name) |
读取原始属性(不含修正) | core.getStatus('hp') |
core.getRealStatus(name) |
读取含百分比修正后的值 | core.getRealStatus('atk') 战斗实际用的就是这个 |
⚠️ 常见坑:
getStatus('atk')和getRealStatus('atk')在存在属性 buff 时结果不同,战斗结算以getRealStatus为准。
位置相关函数同样高频:
core.setHeroLoc('x', 5)/core.getHeroLoc()—— 瞬移与读取主角坐标core.nextX()/core.nextY()—— 主角面前第 n 格坐标(面前为正、背后为负、脚下为 0)core.turnHero()—— 主角转身core.setBuff('atk', 0.5)/core.addBuff()/core.getBuff()—— 百分比修正(毒、增益、诅咒)
flag 变量速查:setFlag 与 setGlobalFlag 别用混
flag 是魔塔游戏的核心机制(中毒、剧情标记、开关……)。样板把 flag 分为两级:
| 函数 | 作用域 | 说明 |
|---|---|---|
core.setFlag(name, value) |
主角级 | 如 core.setFlag('poison', true) 令主角中毒 |
core.addFlag(name, value) |
主角级 | 增量操作,等价于 get + set |
core.getFlag(name) / core.hasFlag(name) |
主角级 | 读取与判定 |
core.setGlobalFlag(name, value) |
全塔级 | 跨楼层共享,存于 core.flags |
core.getGlobal(name) |
全塔级 | 读取全局开关 |
地图与图块速查:setBlock / changeFloor
地图类函数分布在 libs/maps.js,改地图是剧情脚本的刚需:
| 函数 | 作用 |
|---|---|
core.setBlock(cls, loc) |
替换指定位置的图块(开门、换墙、放道具) |
core.getBlockCls(loc) / core.getBlockId(loc) |
读取某格图块 |
core.setBgFgBlock(...) |
修改背景层/前景层图块 |
core.setEnemy(loc, id) |
在格子放置怪物 |
core.setItem(loc, id) |
在格子放置道具 |
core.openDoor(loc, door) / core.closeDoor(...) |
开/关门 |
core.changeFloor(floorId, loc, callback) |
切换楼层 |
core.clearMap() |
清屏重绘(瞬移后常需手动调用) |
💡 提示:
setHeroLoc只会改数据不会重绘画面,瞬移后需要core.clearMap() + core.drawHero()让界面跟上。
战斗与怪物速查
怪物与伤害计算在 libs/enemys.js:
core.getDamage(loc)—— 计算主角打某格怪物的伤害(负数表示掉血)core.getDamageString(loc)—— 获取带格式的显伤文本core.battle(...)/core.canBattle(...)—— 战斗执行与判定core.getSpecialText(...)/core.getSpecialHint(...)—— 怪物特殊属性(毒/衰/咒)文本core.getCurrentEnemys(loc)—— 取当前怪物对象core.hasEnemyLeft()—— 判定场上是否还有怪(通关条件常用)
怪物原始数据则直接存于 core.material.enemys,如 core.material.enemys.greenSlime 即绿色史莱姆的完整属性。
UI、音频与反馈速查
让游戏"活起来"的函数集中在 libs/ui.js 与 libs/control.js:
| 函数 | 效果 |
|---|---|
core.playBgm('bgm.mp3') / core.pauseBgm() / core.resumeBgm() |
背景音乐控制 |
core.playSound('confirm.mp3') |
播放音效 |
core.drawConfirmBox(text, okCb, noCb) |
确认/取消对话框 |
core.showImage(...) / core.hideImage(...) |
在地图上显示/隐藏贴图 |
core.setCurtain(color, time) |
画面色调渐变 |
core.screenFlash(color, time) |
画面闪烁(红屏受击常用) |
core.setWeather('rain', 5) |
设置天气(雨/雪/雾/云/晴) |
存档与回放速查
| 函数 | 作用 |
|---|---|
core.saveData() / core.loadData() |
存档/读档 |
core.syncSave() / core.syncLoad() |
同步存档(不中断游戏) |
core.getSave(id) / core.hasSave(id) / core.removeSave(id) |
按编号查询与删除 |
core.startReplay(...) / core.stopReplay() / core.replay() |
录像回放 |
core.isPlaying() / core.isMoving() |
状态判定(写回调时常用) |
常用状态对象:比函数更值得背
除了函数,core 上还挂着一批运行时状态,它们几乎出现在每个脚本里:
core.status.hero—— 勇士完整信息(name / lv / hp / atk / def / exp / loc / items / flags……)core.status.floorId/core.status.thisMap—— 当前楼层与地图数据core.status.shops—— 全局商店信息core.material—— 全部素材(动画、BGM、音效、怪物、道具、图标)core.saves—— 存档列表(ids为已有存档编号)core.platform.isPC/isAndroid/isIOS—— 平台判定,方便做全平台适配core.values/core.flags—— 全塔数值与全局开关
如何查阅完整 API 文档?
速查清单之外,三个权威资料源:
- 官方 API 列表:_docs/api.md,按模块列出全部被转发到 core 的函数,量较大建议 Ctrl+F 搜索;
- 类型定义:runtime.d.ts,每个函数都带参数类型和示例注释,编辑器中悬停即可看提示;
- 类型入口:libs/core.js 定义运行时状态,main.js 展示模块如何挂载到 core。
📌 注意:_docs/api.md 只列出被转发到 core 的 API,未被转发的内部函数需要直接去对应模块源码中查看。
小结
- 记住一个前缀:所有高频函数都是
core.xxx(); - 属性三件套
setStatus / getStatus / getRealStatus解决 80% 的数值需求; - flag 分主角级与全塔级,跨楼层用
setGlobalFlag; - 改完地图记得重绘,战斗结算用
getRealStatus; - 完整清单以 _docs/api.md 和 runtime.d.ts 为准。
按这份 mota-js API 速查清单动手写脚本,配合样板自带的可视化编辑器,很快就能做出一座属于你自己的魔塔。



