Lua接口/服务端/SetPlayerDefaultReliveInfo:修订间差异
来自天龙知识库
跳到导航跳到搜索
整理当前服务端 Lua 接口:注册名称、参数、返回值与调用说明 |
维护服务端 Lua 接口:核对参数、返回值、边界条件与调用示例 |
||
| (未显示2个用户的4个中间版本) | |||
| 第1行: | 第1行: | ||
__NOTOC__ | __NOTOC__ | ||
<div class="lua-reference | <div class="lua-reference"> | ||
[[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/通用与活动|通用与活动]] · [[Lua接口/服务端调用约定|调用约定]] | [[首页|首页]] · [[Lua接口/服务端函数索引|服务端接口]] · [[Lua接口/服务端函数索引/通用与活动|通用与活动]] · [[Lua接口/服务端调用约定|调用约定]] | ||
<div | <div class="lua-lead lua-rule">玩家的缺省复活相关的数据设置</div> | ||
== Lua 调用 == | == Lua 调用 == | ||
<pre | <pre>SetPlayerDefaultReliveInfo(sceneId, selfId, pszHP, pszMP, pszSP, defaultSceneID, defaultPosX, defaultPosZ)</pre> | ||
服务端脚本中共出现 54 处调用,实参个数出现过:8 个(54 处)。 | |||
实现位于 <code>LuaFnTbl_Misc.h</code>。 | |||
== 参数 == | == 参数 == | ||
{| class="wikitable | {| class="wikitable" | ||
! scope="col" | ! scope="col" class="lua-w11" | 序号 | ||
! scope="col" | ! scope="col" class="lua-w36" | 参数 / 类型 | ||
! scope="col | ! scope="col" | 说明 | ||
|- | |- | ||
| 1 | |||
| <code>sceneId</code><br /><span class="lua-muted"><code>number</code></span> | |||
| | | 当前调用所在的场景 ID。<br /><span class="lua-muted">脚本中的实参:<code>sceneId</code>(54 处)</span> | ||
|- | |- | ||
| 2 | |||
| <code>selfId</code><br /><span class="lua-muted"><code>number</code></span> | |||
| | | 当前场景内的对象 ID。玩家接口需传入有效玩家对象;不是角色 GUID。<br /><span class="lua-muted">脚本中的实参:<code>selfId</code>(50 处)、<code>playerId</code>(4 处)</span> | ||
|- | |- | ||
| 3 | |||
| <code>pszHP</code><br /><span class="lua-muted"><code>string</code></span> | |||
| HP的数据(%10=HP恢复10/100,10=HP恢复10点)<br /><span class="lua-muted">脚本中的实参:<code>"%10"</code>(51 处)、<code>"%50"</code>(2 处)、<code>"%100"</code></span> | |||
|- | |- | ||
| 4 | |||
| <code>pszMP</code><br /><span class="lua-muted"><code>string</code></span> | |||
| MP的数据(%10=HP恢复10/100,10=HP恢复10点)<br /><span class="lua-muted">脚本中的实参:<code>-1</code>(53 处)、<code>"%50"</code></span> | |||
|- | |- | ||
| 5 | |||
| <code>pszSP</code><br /><span class="lua-muted"><code>string</code></span> | |||
| SP的数据(%10=HP恢复10/100,10=HP恢复10点)<br /><span class="lua-muted">脚本中的实参:<code>"0"</code>(54 处)</span> | |||
|- | |- | ||
| 6 | |||
| <code>defaultSceneID</code><br /><span class="lua-muted"><code>number</code></span> | |||
| | | 复活的场景ID<br /><span class="lua-muted">脚本中的实参:<code>sceneId</code>(43 处)、<code>2</code>(3 处)、<code>77</code></span> | ||
|- | |- | ||
| 7 | |||
| <code>defaultPosX</code><br /><span class="lua-muted"><code>number</code></span> | |||
| | | 坐标X<br /><span class="lua-muted">脚本中的实参:<code>20</code>(2 处)、<code>x805042_g_Fuben_X</code>(2 处)、<code>165</code></span> | ||
|- | |- | ||
| 8 | |||
| <code>defaultPosZ</code><br /><span class="lua-muted"><code>number</code></span> | |||
| | | 坐标Z<br /><span class="lua-muted">脚本中的实参:<code>38</code>(2 处)、<code>x805042_g_Fuben_Z</code>(2 处)、<code>169</code></span> | ||
|} | |} | ||
== 返回值 == | == 返回值 == | ||
无返回值。赋值接收时得到 nil;这与返回数字 0 不同。 | 无返回值。赋值接收时得到 nil;这与返回数字 0 不同。 | ||
== 脚本中的调用 == | |||
以下是服务端脚本里的真实调用点,按实参形态去重后列出 8 条。这些调用取自随包发布的脚本,可用于确认参数顺序与实际传入的值;它们不代表该写法在当前版本仍然有效。 | |||
<pre>-- event/challenge/edali_challenge.lua | |||
SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", x806014_g_BackPos.sceneId, x806014_g_BackPos.x, x806014_g_BackPos.z) | |||
-- event/challenge/eluoyang_challenge.lua | |||
SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", x806012_g_BackPos.sceneId, x806012_g_BackPos.x, x806012_g_BackPos.z) | |||
-- event/city/ecity_0802findcompound.lua | |||
SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", 77, 20, 38) | |||
-- event/city/protect_guild.lua | |||
SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", sceneId, x805042_g_Fuben_X, x805042_g_Fuben_Z) | |||
-- event/dali/edali_0222.lua | |||
SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", sceneId, x210222_g_Fuben_X, x210222_g_Fuben_Z) | |||
-- event/emei/shimen_0901.lua | |||
SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", sceneId, x226901_g_Fuben_X, x226901_g_Fuben_Z) | |||
-- event/festival/midautumn/emidautumn_fight.lua | |||
SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", x050010_g_BackInfo.sceneId, x050010_g_BackInfo.x, x050010_g_BackInfo.z) | |||
-- event/fuben/efuben_1_zhenlong.lua | |||
SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", sceneId, x401000_g_Fuben_X, x401000_g_Fuben_Z)</pre> | |||
== 注意事项 == | == 注意事项 == | ||
* 调用对象必须是当前场景中的有效玩家。 | * 调用对象必须是当前场景中的有效玩家。 | ||
</div> | </div> | ||
2026年9月20日 (日) 00:13的最新版本
玩家的缺省复活相关的数据设置
Lua 调用
SetPlayerDefaultReliveInfo(sceneId, selfId, pszHP, pszMP, pszSP, defaultSceneID, defaultPosX, defaultPosZ)
服务端脚本中共出现 54 处调用,实参个数出现过:8 个(54 处)。
实现位于 LuaFnTbl_Misc.h。
参数
| 序号 | 参数 / 类型 | 说明 |
|---|---|---|
| 1 | sceneIdnumber
|
当前调用所在的场景 ID。 脚本中的实参: sceneId(54 处)
|
| 2 | selfIdnumber
|
当前场景内的对象 ID。玩家接口需传入有效玩家对象;不是角色 GUID。 脚本中的实参: selfId(50 处)、playerId(4 处)
|
| 3 | pszHPstring
|
HP的数据(%10=HP恢复10/100,10=HP恢复10点) 脚本中的实参: "%10"(51 处)、"%50"(2 处)、"%100"
|
| 4 | pszMPstring
|
MP的数据(%10=HP恢复10/100,10=HP恢复10点) 脚本中的实参: -1(53 处)、"%50"
|
| 5 | pszSPstring
|
SP的数据(%10=HP恢复10/100,10=HP恢复10点) 脚本中的实参: "0"(54 处)
|
| 6 | defaultSceneIDnumber
|
复活的场景ID 脚本中的实参: sceneId(43 处)、2(3 处)、77
|
| 7 | defaultPosXnumber
|
坐标X 脚本中的实参: 20(2 处)、x805042_g_Fuben_X(2 处)、165
|
| 8 | defaultPosZnumber
|
坐标Z 脚本中的实参: 38(2 处)、x805042_g_Fuben_Z(2 处)、169
|
返回值
无返回值。赋值接收时得到 nil;这与返回数字 0 不同。
脚本中的调用
以下是服务端脚本里的真实调用点,按实参形态去重后列出 8 条。这些调用取自随包发布的脚本,可用于确认参数顺序与实际传入的值;它们不代表该写法在当前版本仍然有效。
-- event/challenge/edali_challenge.lua SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", x806014_g_BackPos.sceneId, x806014_g_BackPos.x, x806014_g_BackPos.z) -- event/challenge/eluoyang_challenge.lua SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", x806012_g_BackPos.sceneId, x806012_g_BackPos.x, x806012_g_BackPos.z) -- event/city/ecity_0802findcompound.lua SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", 77, 20, 38) -- event/city/protect_guild.lua SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", sceneId, x805042_g_Fuben_X, x805042_g_Fuben_Z) -- event/dali/edali_0222.lua SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", sceneId, x210222_g_Fuben_X, x210222_g_Fuben_Z) -- event/emei/shimen_0901.lua SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", sceneId, x226901_g_Fuben_X, x226901_g_Fuben_Z) -- event/festival/midautumn/emidautumn_fight.lua SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", x050010_g_BackInfo.sceneId, x050010_g_BackInfo.x, x050010_g_BackInfo.z) -- event/fuben/efuben_1_zhenlong.lua SetPlayerDefaultReliveInfo(sceneId, selfId, "%10", -1, "0", sceneId, x401000_g_Fuben_X, x401000_g_Fuben_Z)
注意事项
- 调用对象必须是当前场景中的有效玩家。