服务端常用接口速查

服务端常用接口速查,按分类整理,含本地文档出处。

教程更新于 2026-10-07 教程第 40 / 41 篇 速查996 新三端

下表汇总本手册已讲解的服务端接口(函数名、签名、用途与本地文档来源路径),供日常开发速查;完整清单以本地 showdoc 服务端文档为准。

表 A-1 服务端常用接口速查

函数 签名 用途
release_print release_print(...) 打印消息到控制台(调试输出)
qfloadend qfloadend() QFunction-0 重载后触发(初始化)
login login(actor) 玩家登录触发
clicknpc clicknpc(actor, npcId, script) NPC 点击触发(返回 true 拦截 TXT)
getexpbykillmon getexpbykillmon(actor, killer, mon, exp) 杀怪获取经验触发
sendmsg sendmsg(actor, type, msg) 发送聊天框消息(type 1/2/3/4/5),msg 为 JSON 字符串
sendcentermsg sendcentermsg(actor, FColor, BColor, Msg, flag, time, func) 屏幕中间大字体信息
querymoney querymoney(actor, id) 查询人物货币(id 1-100)
changemoney changemoney(actor, id, opt, count, desc, send) 设置人物货币(+ - =)
checkitems checkitems(actor, itemStr, isBind, model) 批量检测背包物品
takeitem takeitem(actor, itemName, itemNum, ignoreJP, desc) 拿(扣除)物品
giveitem giveitem(actor, itemName, qty, bind, desc) 给物品(返回唯一 id 或 nil)
DelItem DelItem(actor, itemtab, bind, istype, desc) 按物品表删除物品
setontimer setontimer(actor, id, runTick, runTime) 添加个人定时器(回调 ontimer{id})
setofftimer setofftimer(actor, id) 移除个人定时器
setontimerex setontimerex(id, tick) 添加全局定时器(回调 ontimerex{id})
gotolabel gotolabel(actor, type, label, range) 调用触发(按范围触发函数)
callscript callscript(actor, filename, label) 调用 TXT 脚本命令(不推荐)

来源:本地文档 接口\人物相关、物品操作、系统、定时器 各目录对应 md 文件。

本篇依据
  • 《996 新三端 Lua 开发教学技术手册》附录 A

参数与取值以你本机版本的官方帮助文档为准,不同版本之间有过调整。