mota-js API参考:200+个core.*函数速查清单,做魔塔不再查半天

原创2026-11-15 10:43:341,882 阅读
文章标签:游戏开发前端Web框架低代码

mota-js API参考:200+个core.*函数速查清单,做魔塔不再查半天

mota-js 是一款 HTML5 魔塔样板,支持全平台运行。即使完全不会编程的用户,按照模板和说明文档也能快速做出一个魔塔游戏。本文整理出样板中 200+ 个 core. API 函数* 的速查清单,按模块分组讲解高频函数与状态对象,让你在写魔塔游戏脚本时随手可查、快速上手。

mota-js魔塔游戏运行界面,展示地图、状态栏与道具栏

为什么所有函数都叫 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() —— 百分比修正(毒、增益、诅咒)

mota-js可视化编辑器中的数据区与地图区

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) 全塔级 读取全局开关

mota-js数据区表格,展示图块、怪物、道具属性编辑

地图与图块速查: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 —— 全塔数值与全局开关

mota-js魔塔游戏与浏览器控制台,演示core.*API调用输出

如何查阅完整 API 文档?

速查清单之外,三个权威资料源:

  1. 官方 API 列表:_docs/api.md,按模块列出全部被转发到 core 的函数,量较大建议 Ctrl+F 搜索;
  2. 类型定义:runtime.d.ts,每个函数都带参数类型和示例注释,编辑器中悬停即可看提示;
  3. 类型入口: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 速查清单动手写脚本,配合样板自带的可视化编辑器,很快就能做出一座属于你自己的魔塔。

登录后查看全文
mota-js