天龙知识库 - 最近更改 [zh-cn]

Lua接口/服务端调用约定

雪舞 — Mon, 07 Sep 2026 11:53:16 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:53的版本
第43行：		第43行：

	[[Lua接口/服务端调用示例\|常用调用示例]]		[[Lua接口/服务端调用示例\|常用调用示例]]

			== 调用问题 ==
			* [[Lua接口/函数不存在\|函数不存在或提示 nil]]
			* [[Lua接口/参数类型与顺序\|参数类型与传入顺序]]
			* [[Lua接口/返回值判断\|返回值为 0、负数或空字符串]]
			* [[Lua接口/对象ID与GUID\|对象 ID 与 GUID 的区别]]
			* [[Lua接口/服务端与客户端调用范围\|服务端与客户端的调用范围]]

	</div>		</div>

Lua接口/服务端与客户端调用范围

雪舞 — Mon, 07 Sep 2026 11:53:16 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

新页面

Lua接口/对象ID与GUID

雪舞 — Mon, 07 Sep 2026 11:53:16 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

新页面

Lua接口/返回值判断

雪舞 — Mon, 07 Sep 2026 11:53:15 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

新页面

Lua接口/参数类型与顺序

雪舞 — Mon, 07 Sep 2026 11:53:15 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

新页面

Lua接口/函数不存在

雪舞 — Mon, 07 Sep 2026 11:53:15 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

新页面

Lua接口/服务端调用示例

雪舞 — Mon, 07 Sep 2026 11:42:52 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

@@ 第25行： / 第25行： @@
 end</pre>
 这里统计已装备与背包物品之和，未验证锁定状态，不能直接等同于可扣除数量。
 == 发放物品 ==

Lua接口/服务端函数索引/生活技能与装备

雪舞 — Mon, 07 Sep 2026 11:42:51 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第120行：		第120行：
	\|-		\|-
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/GetItemBagPos\|GetItemBagPos]]		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/GetItemBagPos\|GetItemBagPos]]
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">GetItemBagPos(sceneId, selfId, itemTableIndex, findUnlock)</code><br />~~按是否要求解锁返回指定物品的首个背包位置。~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">GetItemBagPos(sceneId, selfId, itemTableIndex, findUnlock)</code><br />查找指定物品的首个背包位置，可排除交易锁，但不排除密码锁。
	\|-		\|-
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/GetItemBoxMaxGrowTime\|GetItemBoxMaxGrowTime]]		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/GetItemBoxMaxGrowTime\|GetItemBoxMaxGrowTime]]

Lua接口/服务端函数索引/角色属性与物品

雪舞 — Mon, 07 Sep 2026 11:42:51 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第54行：		第54行：
	\|-		\|-
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/DelItem\|DelItem]]		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/DelItem\|DelItem]]
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">DelItem(sceneId, selfId, itemIndex, delCount)</code><br />~~删除当前玩家的某个道具~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">DelItem(sceneId, selfId, itemIndex, delCount)</code><br />按物品配置编号扣除背包中的指定数量，失败时可能已部分扣除。
	\|-		\|-
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/DelSkill\|DelSkill]]		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/DelSkill\|DelSkill]]
第84行：		第84行：
	\|-		\|-
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/EraseItem\|EraseItem]]<br /><small>[[Lua接口/服务端/LuaFnEraseItem\|LuaFnEraseItem]]</small>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/EraseItem\|EraseItem]]<br /><small>[[Lua接口/服务端/LuaFnEraseItem\|LuaFnEraseItem]]</small>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">EraseItem(sceneId, selfId, bagIndex)</code><br />~~删除当前玩家背包某一格的道具~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">EraseItem(sceneId, selfId, bagIndex)</code><br />删除指定背包格的整格物品，包括全部堆叠数量。
	\|-		\|-
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/ExecuteDeleteChar\|ExecuteDeleteChar]]		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/ExecuteDeleteChar\|ExecuteDeleteChar]]
第165行：		第165行：
	\|-		\|-
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/GetItemTableIndexByIndex\|GetItemTableIndexByIndex]]<br /><small>[[Lua接口/服务端/LuaFnGetItemTableIndexByIndex\|LuaFnGetItemTableIndexByIndex]]</small>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/GetItemTableIndexByIndex\|GetItemTableIndexByIndex]]<br /><small>[[Lua接口/服务端/LuaFnGetItemTableIndexByIndex\|LuaFnGetItemTableIndexByIndex]]</small>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">GetItemTableIndexByIndex(sceneId, selfId, itemIndex)</code><br />~~取当前位置的物品种类~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">GetItemTableIndexByIndex(sceneId, selfId, itemIndex)</code><br />读取指定背包格中的物品配置编号。
	\|-		\|-
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/GetLeftDeleteTime\|GetLeftDeleteTime]]		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| [[Lua接口/服务端/GetLeftDeleteTime\|GetLeftDeleteTime]]

Lua接口/服务端/GetItemBagPos

雪舞 — Mon, 07 Sep 2026 11:42:51 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第3行：		第3行：
	[[首页\|首页]] · [[Lua接口/服务端函数索引\|服务端接口]] · [[Lua接口/服务端函数索引/生活技能与装备\|生活技能与装备]] · [[Lua接口/服务端调用约定\|调用约定]]		[[首页\|首页]] · [[Lua接口/服务端函数索引\|服务端接口]] · [[Lua接口/服务端函数索引/生活技能与装备\|生活技能与装备]] · [[Lua接口/服务端调用约定\|调用约定]]

	<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">~~按是否要求解锁返回指定物品的首个背包位置。~~</div>		<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">查找指定物品的首个背包位置，可排除交易锁，但不排除密码锁。</div>

	== Lua 调用 ==		== Lua 调用 ==
第28行：		第28行：
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 4		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 4
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">findUnlock</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">findUnlock</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| ~~是否查找未锁定物品，使用数值标志。~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 传 0 时不限制交易锁；传 1 时排除交易锁。实际按非零判断，不过滤密码锁；必须传数值。
	\|}		\|}

	== 返回值 ==		== 返回值 ==
	~~返回 1 个值。返回类型包括~~ <~~code~~ style="white-space:~~normal~~;overflow-wrap:anywhere;~~">number</code>。明确的固定返回组合包括 <code style="white~~-~~space~~:~~normal~~;~~overflow~~-~~wrap~~:~~anywhere~~;">-1</~~code~~>。		返回首个匹配物品的背包格子位置（number，包含 0）；未找到、无法选择背包或对象无效等失败路径返回 -1。

			== 调用示例 ==
			<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local bagPos = GetItemBagPos(sceneId, selfId, itemTypeSn, 1)
			if bagPos >= 0 then
			if LuaFnIsItemAvailable(sceneId, selfId, bagPos) == 1 then
			-- 首个匹配格也通过了密码锁检查
			end
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 按物品类型选择普通、材料或任务背包，不查找已装备物品或银行。
			* findUnlock = 1 只排除交易锁，仍可能返回带密码锁的物品；绑定状态也不受限制。
			* 同时过滤两种锁且不限绑定状态，可用 GetBagPosByItemSnAvailableBind(sceneId, selfId, itemTableIndex, 0)。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Ability.h</code> 第 4921 行，服务端注册表第 1115 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Ability.h</code> 第 4921 行，服务端注册表第 1115 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/GetBagPosByItemSnAvailableBind

雪舞 — Mon, 07 Sep 2026 11:42:50 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第28行：		第28行：
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 4		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 4
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">onlyBind</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">onlyBind</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| ~~是否限定绑定物品，使用数值标志。~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 传 0 时绑定和未绑定物品都可匹配；传 1 时仅匹配绑定物品。实际按非零判断，必须传数值，不传 Lua 布尔值。
	\|}		\|}

	== 返回值 ==		== 返回值 ==
	~~返回 1 个值。返回类型包括~~ <~~code~~ style="white-space:~~normal~~;overflow-wrap:anywhere;~~">number</code>。明确的固定返回组合包括 <code style="white~~-~~space~~:~~normal~~;~~overflow~~-~~wrap~~:~~anywhere~~;">-1</~~code~~>。		返回首个满足物品编号、锁和绑定条件的背包格子位置（number，包含 0）；未找到、无法选择背包或对象无效等失败路径返回 -1。

			== 调用示例 ==
			<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">-- 1 表示只找绑定物品，同时排除交易锁和密码锁
			local bagPos = GetBagPosByItemSnAvailableBind(sceneId, selfId, itemTypeSn, 1)
			if bagPos >= 0 then
			-- bagPos 是背包位置，不是物品编号
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 始终排除交易锁和密码锁，按物品类型选择普通、材料或任务背包。
			* onlyBind = 0 表示不限绑定状态，并不是只找未绑定物品；本接口没有仅查找未绑定物品的模式。
			* 每次只返回首个位置；反复调用不会自动继续查找下一格，也不会预留该格。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Ability.h</code> 第 4898 行，服务端注册表第 1114 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Ability.h</code> 第 4898 行，服务端注册表第 1114 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/GetBagPosByItemSn

雪舞 — Mon, 07 Sep 2026 11:42:50 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第28行：		第28行：

	== 返回值 ==		== 返回值 ==
	~~返回 1 个值。返回类型包括~~ <~~code~~ style="white-space:~~normal~~;overflow-wrap:anywhere;~~">number</code>。明确的固定返回组合包括 <code style="white~~-~~space~~:~~normal~~;~~overflow~~-~~wrap~~:~~anywhere~~;">-1</~~code~~>。		返回首个匹配物品的背包格子位置（number，0 也是有效位置）；未找到、无法选择背包或对象无效等失败路径返回 -1。

			== 调用示例 ==
			<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local bagPos = GetBagPosByItemSn(sceneId, selfId, itemTypeSn)
			if bagPos >= 0 then
			local count = LuaFnGetItemCountInBagPos(sceneId, selfId, bagPos)
			if count > 0 then
			-- count 仅为这一格的堆叠数量
			end
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 按物品类型选择普通、材料或任务背包，从该背包起始位置查找；不查找已装备物品或银行。
			* 不排除交易锁、密码锁，也不限制绑定状态。找到位置不代表可以扣除。
			* Lua 注册名称是 GetBagPosByItemSn，不能自行添加 LuaFn 前缀。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Ability.h</code> 第 4876 行，服务端注册表第 1113 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Ability.h</code> 第 4876 行，服务端注册表第 1113 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/LuaFnDelAvailableItem

雪舞 — Mon, 07 Sep 2026 11:42:50 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第28行：		第28行：
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 4		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 4
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">delCount</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">delCount</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| ~~扣除数量。~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 要扣除的总数量，应为正整数。当前实现对 0 或负数直接返回 1，不执行扣除。
	\|}		\|}

	== 返回值 ==		== 返回值 ==
	~~返回 1 个值。返回类型包括~~ <~~code~~ style="white-space:~~normal~~;overflow-wrap:anywhere;~~">number</code>。明确的固定返回组合包括 <code style="white~~-~~space~~:~~normal~~;~~overflow~~-~~wrap~~:~~anywhere~~;">-1</~~code~~>。		返回一个 number：正数量扣除流程报告成功为 1，失败为 0，对象无效或异常等失败路径为 -1。delCount 小于或等于 0 时直接返回 1，不扣除物品。返回 0 时仍可能已部分扣除。

			== 调用示例 ==
			<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">-- itemTypeSn 是有效物品配置编号
			local needCount = 5
			if LuaFnGetAvailableItemCount(sceneId, selfId, itemTypeSn) >= needCount then
			local result = LuaFnDelAvailableItem(sceneId, selfId, itemTypeSn, needCount)
			if result == 1 then
			-- 扣除流程报告成功后的业务处理
			else
			-- 停止处理；可能已经部分扣除，不自动重试
			end
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 跳过交易锁与密码锁物品，不限制绑定状态；可跨多个背包堆叠扣除，不操作已装备物品和银行。
			* 不会在扣除前检查总数量，也不提供回滚。先用 [[Lua接口/服务端/LuaFnGetAvailableItemCount\|LuaFnGetAvailableItemCount]] 检查数量；失败后不要自动重试或直接发奖励。
			* 计数与扣除是两个调用，不构成事务；更完整的兑换、重复领取保护以及游戏内异常表现需要实测。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 3072 行，服务端注册表第 438 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 3072 行，服务端注册表第 438 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/LuaFnIsItemAvailable

雪舞 — Mon, 07 Sep 2026 11:42:50 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第24行：		第24行：
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 3		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 3
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">bagIndex</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">bagIndex</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| ~~背包格子索引。~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 背包格子位置，不是物品编号；应先确认格子内是目标物品。
	\|}		\|}

	== 返回值 ==		== 返回值 ==
	~~返回 1 个值。返回类型包括~~ <~~code~~ style="white-space:~~normal~~;overflow-wrap:anywhere;~~">number</code>。明确的固定返回组合包括 <code style="white~~-~~space~~:~~normal~~;~~overflow~~-~~wrap~~:~~anywhere~~;">-1</~~code~~>。		返回一个 number：能取得格子对象且未加交易锁、未加密码锁时为 1；越界、无法取得格子对象或任一锁存在时为 0；玩家对象无效或异常等失败路径为 -1。

			== 调用示例 ==
			<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">if bagPos >= 0 then
			if GetItemTableIndexByIndex(sceneId, selfId, bagPos) == itemTypeSn
			and LuaFnIsItemAvailable(sceneId, selfId, bagPos) == 1 then
			-- 已核对物品编号，并通过两种锁的检查
			end
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 该检查不判断格子是否为空，空格也可能返回 1；不能据此判断物品存在、数量足够或物品编号正确。空格的具体返回需要实测。
			* 绑定状态不影响此判断。运行时交易锁、密码锁与绑定是不同条件。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 2878 行，服务端注册表第 437 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 2878 行，服务端注册表第 437 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/LuaFnGetAvailableItemCount

雪舞 — Mon, 07 Sep 2026 11:42:49 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第28行：		第28行：

	== 返回值 ==		== 返回值 ==
	~~返回 1 个值。返回类型包括~~ <~~code~~ style="white-space:~~normal~~;overflow-wrap:anywhere;~~">number</code>。明确的固定返回组合包括 <code style="white~~-~~space~~:~~normal~~;~~overflow~~-~~wrap~~:~~anywhere~~;">-1</~~code~~>。		返回一个 number：未加交易锁、未加密码锁的同编号物品总数量；未找到或无法选择对应背包时为 0，对象无效或异常等失败路径为 -1。

			== 调用示例 ==
			<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local available = LuaFnGetAvailableItemCount(sceneId, selfId, itemTypeSn)
			if available >= 5 then
			-- 当前未加交易锁、未加密码锁的数量至少为 5
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 按物品类型选择普通、材料或任务背包，不统计已装备物品和银行。绑定与未绑定物品均可计入。
			* 这是调用时的计数，不会预留或锁定物品；后续扣除仍要检查返回值。
			* 与 [[Lua接口/服务端/LuaFnDelAvailableItem\|LuaFnDelAvailableItem]] 配合使用，见 [[Lua接口/服务端调用示例#扣除可用物品\|扣除可用物品示例]]。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 2827 行，服务端注册表第 436 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 2827 行，服务端注册表第 436 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/LuaFnIsItemLocked

雪舞 — Mon, 07 Sep 2026 11:42:49 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第28行：		第28行：

	== 返回值 ==		== 返回值 ==
	~~返回 1 个值。返回类型包括~~ <~~code~~ style="white-space:~~normal~~;overflow-wrap:anywhere;~~">number</code>。明确的固定返回组合包括 <code style="white~~-~~space~~:~~normal~~;~~overflow~~-~~wrap~~:~~anywhere~~;~~">-2</code>；<code style="white-space~~:~~normal~~;~~overflow-wrap~~:~~anywhere~~;">-1</~~code~~>。		返回一个 number：存在运行时交易锁为 1，否则为 0；背包位置越界为 -2；玩家对象无效或异常等失败路径为 -1。

			== 调用示例 ==
			<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local locked = LuaFnIsItemLocked(sceneId, selfId, bagPos)
			if locked == 1 then
			-- 存在交易锁
			elseif locked == 0 then
			-- 未发现交易锁，仍需检查物品存在和密码锁
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 只检查运行时交易锁，不检查密码锁、绑定状态或空格。返回 0 不等于物品可扣除。
			* 需要同时检查交易锁和密码锁，使用 [[Lua接口/服务端/LuaFnIsItemAvailable\|LuaFnIsItemAvailable]]，并另外确认格子中确实有目标物品。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 4627 行，服务端注册表第 417 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 4627 行，服务端注册表第 417 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/EraseItem

雪舞 — Mon, 07 Sep 2026 11:42:49 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第3行：		第3行：
	[[首页\|首页]] · [[Lua接口/服务端函数索引\|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品\|角色属性与物品]] · [[Lua接口/服务端调用约定\|调用约定]]		[[首页\|首页]] · [[Lua接口/服务端函数索引\|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品\|角色属性与物品]] · [[Lua接口/服务端调用约定\|调用约定]]

	<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">~~删除当前玩家背包某一格的道具~~</div>		<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">删除指定背包格的整格物品，包括全部堆叠数量。</div>

	同一接口的其他调用名称：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnEraseItem</code>。		同一接口的其他调用名称：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnEraseItem</code>。
第26行：		第26行：
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 3		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 3
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">bagIndex</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">bagIndex</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| ~~背包的格子~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 待删除的背包格子位置，传入查找接口返回的非负整数；不是物品配置编号或 GUID。
	\|}		\|}

	== 返回值 ==		== 返回值 ==
	返回 1 ~~个值。返回类型包括~~ <~~code~~ style="white-space:~~normal~~;overflow-wrap:anywhere;~~">number</code>。明确的固定返回组合包括 <code style="white~~-~~space~~:~~normal~~;~~overflow~~-~~wrap~~:~~anywhere;">~~1~~</code>；<code style="white-space:normal~~;~~overflow-wrap~~:~~anywhere~~;~~">0</code>；<code style="white-space~~:~~normal~~;~~overflow-wrap~~:~~anywhere~~;">-1</~~code~~>。		返回一个 number：1 表示该格物品已删除；0 表示删除失败（如空格或交易锁）；-1 表示对象无效或异常等失败路径。

			== 调用示例 ==
			<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">-- 本例明确要删除整格，包含全部堆叠
			local bagPos = GetBagPosByItemSnAvailableBind(sceneId, selfId, itemTypeSn, 0)
			if bagPos >= 0 then
			if GetItemTableIndexByIndex(sceneId, selfId, bagPos) == itemTypeSn
			and LuaFnIsItemAvailable(sceneId, selfId, bagPos) == 1 then
			local result = EraseItem(sceneId, selfId, bagPos)
			if result == 1 then
			-- 该格物品已删除
			end
			end
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 删除整格物品，包括该格中的全部堆叠数量；没有数量参数。按编号扣指定数量应使用 [[Lua接口/服务端/LuaFnDelAvailableItem\|LuaFnDelAvailableItem]]。
			* 删除流程拒绝交易锁，但不主动拒绝密码锁。需要尊重两种锁时，先用 [[Lua接口/服务端/LuaFnIsItemAvailable\|LuaFnIsItemAvailable]] 检查。
			* 背包格子可能因整理或移动而改变，不能跨回调长期缓存位置；删除前重新核对物品编号。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 3121 行，服务端注册表第 329、822 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 3121 行，服务端注册表第 329、822 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/DelItem

雪舞 — Mon, 07 Sep 2026 11:42:48 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第3行：		第3行：
	[[首页\|首页]] · [[Lua接口/服务端函数索引\|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品\|角色属性与物品]] · [[Lua接口/服务端调用约定\|调用约定]]		[[首页\|首页]] · [[Lua接口/服务端函数索引\|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品\|角色属性与物品]] · [[Lua接口/服务端调用约定\|调用约定]]

	<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">~~删除当前玩家的某个道具~~</div>		<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">按物品配置编号扣除背包中的指定数量，失败时可能已部分扣除。</div>

	== Lua 调用 ==		== Lua 调用 ==
第24行：		第24行：
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 3		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 3
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">itemIndex</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">itemIndex</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| ~~物品编号或索引，按本接口用途传入。~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 要扣除的物品配置编号，不是背包格子位置，也不是物品 GUID。
	\|-		\|-
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 4		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 4
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">delCount</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">delCount</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| ~~删除数目~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 要扣除的总数量，必须是正整数；不要传 0、负数或小数。
	\|}		\|}

	== 返回值 ==		== 返回值 ==
	~~返回 1 个值。返回类型包括 <code style="white~~-~~space:normal;overflow-wrap:anywhere;">number</code>。明确的固定返回组合包括 <code style="white-space:normal;overflow-wrap:anywhere;">~~1~~</code>；<code style="white-space:normal;overflow-wrap:anywhere;">~~0~~</code>；<code style="white-space:normal;overflow-wrap:anywhere;">-1</code>。~~		返回一个 number：1 表示扣除流程报告成功，0 表示报告失败，-1 表示对象无效或异常等失败路径。返回 0 时可能已扣除部分物品，不能据此认定背包未变化。

	== ~~用法补充~~ ==		== 调用示例 ==
	~~删除当前玩家的某个道具~~<~~br /~~>		<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">-- itemTypeSn 是有效物品配置编号；此段用于已有 DelItem 流程
	~~不仅是指任务道具~~<br />		local needCount = 1
	~~不对已装备的道具删除~~		local available = LuaFnGetAvailableItemCount(sceneId, selfId, itemTypeSn)
			if available >= needCount then
			local result = DelItem(sceneId, selfId, itemTypeSn, needCount)
			if result == 1 then
			-- 流程报告成功；有交易锁时仍需核对实际扣除
			else
			-- 不自动重试：此时可能已经部分扣除
			end
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 按背包位置顺序查找同编号物品，可跨多个堆叠扣除；不删除已装备物品，不操作银行。
			* 数量不足时可能先扣掉已找到的物品；遇到密码锁物品会中止，之前的扣除不会回滚。
			* 此接口未先过滤交易锁，也未完整检查底层每次扣除的结果；有交易锁时不能仅凭返回 1 确认实际扣除数量，具体异常表现需要实测。
			* 常规材料扣除优先使用 [[Lua接口/服务端/LuaFnGetAvailableItemCount\|LuaFnGetAvailableItemCount]] 配合 [[Lua接口/服务端/LuaFnDelAvailableItem\|LuaFnDelAvailableItem]]，并显式判断返回值等于 1。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 3030 行，服务端注册表第 328 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 3030 行，服务端注册表第 328 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/GetItemCount

雪舞 — Mon, 07 Sep 2026 11:42:48 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第41行：		第41行：
	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
	* ~~统计范围包括已装备物品和背包，不包含银行。~~		* 统计范围包括已装备物品，以及按物品类型选择的普通、材料或任务背包；不包含银行，不过滤交易锁、密码锁或绑定状态。
	* ~~该数量不能直接当成可扣除数量；锁定状态和扣除接口的查找范围需要另外核对。~~		* 该数量不能直接当成可扣除数量。只统计背包中未加交易锁、未加密码锁的物品，使用 [[Lua接口/服务端/LuaFnGetAvailableItemCount\|LuaFnGetAvailableItemCount]]。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 2794 行，服务端注册表第 325、825 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 2794 行，服务端注册表第 325、825 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/LuaFnGetItemCountInBagPos

雪舞 — Mon, 07 Sep 2026 11:42:48 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第24行：		第24行：
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 3		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 3
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">uBagPos</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">uBagPos</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| ~~背包中位置~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 背包格子位置，传入背包查找接口返回的非负整数；不是物品配置编号。
	\|}		\|}

	== 返回值 ==		== 返回值 ==
	~~返回 1 个值。返回类型包括~~ <~~code~~ style="white-space:~~normal~~;overflow-wrap:anywhere;~~">number</code>。明确的固定返回组合包括 <code style="white~~-~~space~~:~~normal~~;~~overflow~~-~~wrap~~:~~anywhere~~;">-1</~~code~~>。		返回该格的堆叠数量（number）；格子对象未取得、玩家无效或异常等失败路径返回 -1。不合计其他格的同类物品。

			== 调用示例 ==
			<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local bagPos = GetBagPosByItemSn(sceneId, selfId, itemTypeSn)
			if bagPos >= 0 then
			local count = LuaFnGetItemCountInBagPos(sceneId, selfId, bagPos)
			if count > 0 then
			-- count 是当前格子的堆叠数量
			end
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 不检查交易锁、密码锁或绑定状态。物品存在和能否扣除要另外核对。
			* 接口不显式判断空格，空格的计数和边界表现需要实测；应对已找到且编号已确认的格子调用。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 2747 行，服务端注册表第 324 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 2747 行，服务端注册表第 324 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端/GetItemTableIndexByIndex

雪舞 — Mon, 07 Sep 2026 11:42:47 GMT

维护服务端 Lua 接口：核对参数、返回值、边界条件与调用示例

←上一版本		2026年9月7日 (一) 19:42的版本
第3行：		第3行：
	[[首页\|首页]] · [[Lua接口/服务端函数索引\|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品\|角色属性与物品]] · [[Lua接口/服务端调用约定\|调用约定]]		[[首页\|首页]] · [[Lua接口/服务端函数索引\|服务端接口]] · [[Lua接口/服务端函数索引/角色属性与物品\|角色属性与物品]] · [[Lua接口/服务端调用约定\|调用约定]]

	<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">~~取当前位置的物品种类~~</div>		<div style="padding:14px 0;border-top:3px solid #287568;border-bottom:1px solid #dbe3e6;">读取指定背包格中的物品配置编号。</div>

	同一接口的其他调用名称：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetItemTableIndexByIndex</code>。		同一接口的其他调用名称：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnGetItemTableIndexByIndex</code>。
第26行：		第26行：
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 3		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 3
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">itemIndex</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| <code style="white-space:normal;overflow-wrap:anywhere;">itemIndex</code><br /><span style="color:#657078;"><code style="white-space:normal;overflow-wrap:anywhere;">number</code></span>
	\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| ~~物品在身上的位置索引~~		\| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" \| 背包格子位置，传入背包查找接口返回的非负整数；不是物品配置编号，也不是已装备栏位置。
	\|}		\|}

	== 返回值 ==		== 返回值 ==
	~~返回 1 个值。返回类型包括~~ <~~code~~ style="white-space:~~normal~~;overflow-wrap:anywhere;~~">number</code>。明确的固定返回组合包括 <code style="white~~-~~space~~:~~normal~~;~~overflow~~-~~wrap~~:~~anywhere~~;">-1</~~code~~>。		返回该背包格存储的物品配置编号（number）；格子对象未取得、玩家无效或异常等失败路径返回 -1。

			== 调用示例 ==
			<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">local bagPos = GetBagPosByItemSn(sceneId, selfId, itemTypeSn)
			if bagPos >= 0 then
			local actualItemTypeSn = GetItemTableIndexByIndex(sceneId, selfId, bagPos)
			if actualItemTypeSn == itemTypeSn then
			-- 当前位置仍是目标物品
			end
			end</pre>

	== 注意事项 ==		== 注意事项 ==
	* 调用对象必须是当前场景中的有效玩家。		* 调用对象必须是当前场景中的有效玩家。
			* 接口不显式判断空格，不要把空格统一认定为返回 -1；空格的具体编号值需要实测。建议与已知的有效物品配置编号比较。
			* 与 DelItem 的第三个参数虽然同名 itemIndex，但含义不同：这里传格子位置，DelItem 传物品配置编号。

	<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 2565 行，服务端注册表第 321、827 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>		<div style="margin-top:20px;padding-top:10px;border-top:1px solid #dbe3e6;color:#657078;font-size:12px;">核对依据：<code style="white-space:normal;overflow-wrap:anywhere;">LuaFnTbl_Attr.h</code> 第 2565 行，服务端注册表第 321、827 行。调用格式与返回数量依据当前实现整理；游戏内效果、边界行为及未注明的业务枚举仍需实测。</div>

	</div>		</div>

Lua接口/服务端函数索引

雪舞 — Mon, 07 Sep 2026 11:16:14 GMT