Lua接口/服务端/LuaFnNpcChat:修订间差异

来自雪舞天龙知识库
跳到导航跳到搜索
Waylee​(留言 | 贡献)
维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例
Waylee​(留言 | 贡献)
维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例
 
(未显示同一用户的2个中间版本)
第8行: 第8行:
<pre>LuaFnNpcChat(sceneId, monsterId, isSceneBroadcast, msg)</pre>
<pre>LuaFnNpcChat(sceneId, monsterId, isSceneBroadcast, msg)</pre>


服务端脚本中共出现 27 处调用,实参个数出现过:4 个(27 处)。
服务端脚本中共出现 52 处调用,实参个数出现过:4 个(52 处)。


实现位于 <code>LuaFnTbl_Monster.h</code>。
实现位于 <code>LuaFnTbl_Monster.h</code>。
第20行: 第20行:
| 1
| 1
| <code>sceneId</code><br /><span class="lua-muted"><code>number</code></span>
| <code>sceneId</code><br /><span class="lua-muted"><code>number</code></span>
| 当前调用所在的场景 ID。<br /><span class="lua-muted">脚本中的实参:<code>sceneId</code>(27 处)</span>
| 当前调用所在的场景 ID。<br /><span class="lua-muted">脚本中的实参:<code>sceneId</code>(49 处)、<code>s</code>(3 处)</span>
|-
|-
| 2
| 2
| <code>monsterId</code><br /><span class="lua-muted"><code>number</code></span>
| <code>monsterId</code><br /><span class="lua-muted"><code>number</code></span>
| 怪物的场景对象 ID。<br /><span class="lua-muted">脚本中的实参:<code>selfId</code>(19 处)、<code>MstId</code>(4 处)、<code>nNpcId</code>(2 处)</span>
| 怪物的场景对象 ID。<br /><span class="lua-muted">脚本中的实参:<code>selfId</code>(39 处)、<code>MstId</code>(4 处)、<code>targetId</code>(3 处)</span>
|-
|-
| 3
| 3
| <code>isSceneBroadcast</code><br /><span class="lua-muted"><code>number</code></span>
| <code>isSceneBroadcast</code><br /><span class="lua-muted"><code>number</code></span>
| 是否在场景广播,使用数值标志。<br /><span class="lua-muted">脚本中的实参:<code>0</code>(20 处)、<code>1</code>(7 处)</span>
| 是否在场景广播,使用数值标志。<br /><span class="lua-muted">脚本中的实参:<code>0</code>(45 处)、<code>1</code>(7 处)</span>
|-
|-
| 4
| 4
| <code>msg</code><br /><span class="lua-muted"><code>string</code></span>
| <code>msg</code><br /><span class="lua-muted"><code>string</code></span>
| 文字内容(字符串)。<br /><span class="lua-muted">脚本中的实参:<code>"#&#123;PMF_20080521_18&#125;"</code>(4 处)、<code>"十八年后,爷爷我又是一条好汉!"</code>(3 处)、<code>"老大!这狗官的护卫厉害,我也撤了。"</code>(2 处)</span>
| 文字内容(字符串)。<br /><span class="lua-muted">脚本中的实参:<code>"#&#123;PMF_20080521_18&#125;"</code>(4 处)、<code>"十八年后,爷爷我又是一条好汉!"</code>(3 处)、<code>"#&#123;CJG_090413_20&#125;"</code>(2 处)</span>
|}
|}


第38行: 第38行:
根据执行分支,返回数量可能为 0、1 个(0 个表示无返回值)。返回类型包括 <code>number</code>。明确的固定返回组合包括 <code>-1</code>;<code>1</code>。
根据执行分支,返回数量可能为 0、1 个(0 个表示无返回值)。返回类型包括 <code>number</code>。明确的固定返回组合包括 <code>-1</code>;<code>1</code>。


== 脚本中的调用 ==
== 调用示例 ==
以下是服务端脚本里的真实调用点,按实参形态去重后列出 8 条。这些调用取自随包发布的脚本,可用于确认参数顺序与实际传入的值;它们不代表该写法在当前版本仍然有效。
以下取自随包服务端脚本的真实调用,可对照上方参数表确认参数顺序:
<pre>-- event/bossgroup/bg_BossAI_CreateMonster.lua
<pre>-- event/bossgroup/bg_BossAI_CreateMonster.lua
LuaFnNpcChat(sceneId, selfId, 0, "不知死活的家伙,我的手下就能干掉你!")
LuaFnNpcChat(sceneId, selfId, 0, "不知死活的家伙,我的手下就能干掉你!")
 
-- event/fuben/efuben_shaxing.lua
-- event/jinghu/ejinghu_Boss_1.lua
LuaFnNpcChat(s, boss, 0, "#&#123;SXRW_090630_120&#125;")
LuaFnNpcChat(sceneId, selfId, 0, "十八年后,爷爷我又是一条好汉!")
-- event/fuben/efuben_shaxing.lua
 
LuaFnNpcChat(s, id, 0, talks&#91;r.phase+1&#93;)</pre>
-- event/jinghu/ejinghu_Boss_1.lua
LuaFnNpcChat(sceneId, selfId, 0, "尝尝浔阳江上的烈焰吧!")
 
-- event/jinghu/ejinghu_Boss_1.lua
LuaFnNpcChat(sceneId, selfId, 0, szTarget .. ",你就算再厉害十倍,遇上爷爷也只有死路一条!")
 
-- event/piaomiaofeng/ai_bupingdaoren.lua
LuaFnNpcChat(sceneId, MstId, 0, "#&#123;PMF_20080521_18&#125;")
 
-- event/yanziwu/yanziwu_1.lua
LuaFnNpcChat(sceneId, nNpcId, 0, "狗官,我岳老二来杀你啦,赶紧把脑袋伸过来,让我哢嚓一声拧断你的脖子。")
 
-- event/yanziwu/yanziwu_1.lua
LuaFnNpcChat(sceneId, nNpcId, 0, szName .. "我被修理好了。")
 
-- obj/city/protect_guild_monster_shangui_boss.lua
LuaFnNpcChat(sceneId, selfId, 1, x805044_SKILL_TBL&#91;i&#93;.MsgAlarm)</pre>


</div>
</div>

2026年10月27日 (二) 12:32的最新版本

首页 · 服务端接口 · 怪物与掉落 · 调用约定

发送 Packet 542 的 NPC 对话消息。

Lua 调用

LuaFnNpcChat(sceneId, monsterId, isSceneBroadcast, msg)

服务端脚本中共出现 52 处调用,实参个数出现过:4 个(52 处)。

实现位于 LuaFnTbl_Monster.h。

参数

序号 参数 / 类型 说明
1 sceneId
number
当前调用所在的场景 ID。
脚本中的实参:sceneId(49 处)、s(3 处)
2 monsterId
number
怪物的场景对象 ID。
脚本中的实参:selfId(39 处)、MstId(4 处)、targetId(3 处)
3 isSceneBroadcast
number
是否在场景广播,使用数值标志。
脚本中的实参:0(45 处)、1(7 处)
4 msg
string
文字内容(字符串)。
脚本中的实参:"#{PMF_20080521_18}"(4 处)、"十八年后,爷爷我又是一条好汉!"(3 处)、"#{CJG_090413_20}"(2 处)

返回值

根据执行分支,返回数量可能为 0、1 个(0 个表示无返回值)。返回类型包括 number。明确的固定返回组合包括 -1;1。

调用示例

以下取自随包服务端脚本的真实调用,可对照上方参数表确认参数顺序:

-- event/bossgroup/bg_BossAI_CreateMonster.lua
LuaFnNpcChat(sceneId, selfId, 0, "不知死活的家伙,我的手下就能干掉你!")
-- event/fuben/efuben_shaxing.lua
LuaFnNpcChat(s, boss, 0, "#{SXRW_090630_120}")
-- event/fuben/efuben_shaxing.lua
LuaFnNpcChat(s, id, 0, talks[r.phase+1])