Lua接口/服务端/Msg2Player

来自天龙知识库
雪舞留言 | 贡献2026年9月7日 (一) 19:00的版本 (整理当前服务端 Lua 接口:注册名称、参数、返回值与调用说明)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

首页 · 服务端接口 · 队伍 · 调用约定

将消息发送给玩家

同一接口的其他调用名称:LuaFnMsg2Player

Lua 调用

Msg2Player(sceneId, selfId, msg, type)

参数

序号 参数 / 类型 说明
1 sceneId
number
当前调用所在的场景 ID。
2 selfId
number
当前场景内的对象 ID。玩家接口需传入有效玩家对象;不是角色 GUID。
3 msg
string
聊天内容,字符串指针类型
4 type
number
CHAT_TYPE_NORMAL =0 , //普通说话消息 CHAT_TYPE_TEAM = 1, //队聊消息 CHAT_TYPE_SCENE = 2, //场景消息 CHAT_TYPE_TELL = 3, //私聊消息 CHAT_TYPE_SYSTEM = 4, //系统消息 CHAT_TYPE_CHANNEL = 5, //自建聊天频道消息 CHAT_TYPE_GUILD = 6, //帮派消息 CHAT_TYPE_MENPAI = 7 , //门派消息 CHAT_TYPE_SELF = 8, //仅客户端使用的消息

返回值

返回 1 个值。返回类型包括 number。明确的固定返回组合包括 1-1

用法补充

将消息发送给玩家
消息显示在左下角的聊天框内
type默认值为CHAT_TYPE_NORMAL,即0
金钱提示信息,需要写成#{_MONEY%d}方式
例如:你获得了#{_MONEY208934}。
这句话在客户端提示的时候会自动计算出金、银、铜的数量,并用对应的图标表示出来。

注意事项

  • 调用对象必须是当前场景中的有效玩家。
  • 接口会根据实参数量处理部分分支;省略参数前需确认对应调用场景。
核对依据:LuaFnTbl_Team.h 第 310 行,服务端注册表第 212、837 行。调用格式与返回数量依据当前实现整理;游戏内效果、边界行为及未注明的业务枚举仍需实测。