MZ中文函数文档

自动生成 - 最后更新: 2025-11-22 20:12:58

下载函数库

推荐使用方法:

  1. 下载函数库文件
  2. 将所需函数代码复制到您的插件中
  3. 在插件中直接调用相关函数
  4. 享受本地化带来的性能提升

物品相关函数

拥有金币()返回金币的持有数量
拥有物品(id)返回指定物品ID的持有数量
拥有武器(id)返回指定武器ID的持有数量
拥有防具(id)返回指定防具ID的持有数量
装备武器(武器id, 角色id = null)传入角色id检查指定角色是否持有该武器,否则为任意角色持有。
装备防具(防具id, 角色id = null)传入角色id检查指定角色是否装备了该防具,否则为任意角色装备。
增加物品(id, 数量 = 1)增加指定物品的数量
增加武器(id, 数量 = 1)增加指定武器的数量
增加防具(id, 数量 = 1)增加指定防具的数量
增加金钱(数量)增加金钱

地图相关函数

当前地图ID()返回玩家当前所在的地图ID
玩家X坐标()返回玩家在当前地图中的X坐标
玩家Y坐标()返回玩家在当前地图中的Y坐标
玩家朝向()返回玩家当前面向的方向(2=下,4=左,6=右,8=上)

队伍相关函数

队伍人数()返回当前队伍中的成员数量
最大战斗人数()返回队伍最大战斗人数限制
队伍成员ID(位置)返回队伍中指定位置(0开始)的成员角色ID,如果该位置无人返回0
是否在队伍中(角色id)检查角色是否在队伍中
角色在队伍中的位置(角色id)返回角色在队伍中的位置,不在队伍中返回-1
加入队伍(角色id)将指定角色加入队伍
移除队伍(角色id)将指定角色移出队伍
交换位置(位置1, 位置2)交换两个位置的成员
移动到首位(角色id)将指定角色移动到队伍首位
队伍平均等级()计算队伍平均等级
队伍总HP()计算队伍总HP
队伍总MP()计算队伍总MP
队伍生存人数()返回存活的成员数量
队伍死亡人数()返回死亡的成员数量

开关变量相关函数

开关状态(开关id)返回指定开关ID的当前状态(true/false)
开启开关(开关id)开启指定开关(设置为true)
关闭开关(开关id)关闭指定开关(设置为false)
切换开关(开关id)切换开关状态(true↔false)
变量值(变量id)返回指定变量ID的当前数值
设置变量(变量id, 数值)设置指定变量的值
增加变量(变量id, 增加值)为变量增加指定数值

角色及战斗相关函数

战斗次数()返回游戏至今的总战斗次数
逃跑次数()返回游戏至今的总逃跑次数
角色技能列表(角色id)返回指定角色ID已学会的所有技能ID数组
是否学会技能(角色id, 技能id)检查指定角色是否已学会指定技能,返回true/false
角色状态(角色id)返回指定角色ID当前附加的所有状态ID数组
是否有状态(角色id, 状态id)检查指定角色是否处于指定状态,返回true/false
队伍最高等级(战斗成员 = false)检查队伍最高等级,true为战斗成员,默认false所有成员。
队伍平均等级(战斗成员 = false)检查队伍平均等级,true为战斗成员,默认false所有成员。

游戏系统相关函数

游戏时间()返回游戏总游玩时间(秒)
存档次数()返回游戏至今的总存档次数
公共事件(事件id)执行指定ID的公共事件

工具相关函数

随机数(最小值, 最大值)生成指定范围内的随机整数(包含最小值和最大值)
概率(百分比)传入百分比数值(0-100),返回该概率是否触发

DdDiGame在线系统相关函数

登陆用户()返回当前登录的在线用户名
当前版本()返回当前客服端游戏版本
联网判断()返回当前网络状态
网络公共事件(事件id)执行指定ID的网络公共事件
今天签到()返回今日是否签到(需配合签到插件)
本月签到()返回本月签到天数(需配合签到插件)
永久签到()返回永久签到天数(需配合签到插件)
年(id = null)不填参数返回当前年份,填参数返回是否匹配
月(id = null)不填参数返回当前月,填参数返回是否匹配
周(id = null)不填参数返回周几,填参数返回是否匹配
日(id = null)不填参数返回当前日,填参数返回是否匹配
时(id = null)不填参数返回当前小时,填参数返回是否匹配
分(id = null)不填参数返回当前分钟,填参数返回是否匹配
文档已自动更新 | 共 8 个分类,61 个函数