首页：修订间差异

函数	Lua 调用	用途
GetName	`GetName(sceneId, selfId)`	获取角色名称。
GetLevel	`GetLevel(sceneId, selfId)`	获取角色等级。
GetHp	`GetHp(sceneId, selfId)`	获取角色当前生命值。
GetItemCount	`GetItemCount(sceneId, selfId, itemTypeSn)`	统计指定物品数量，包含已装备与背包中的物品。

示例与常见问题

读取角色信息

local name = GetName(sceneId, selfId)
local level = GetLevel(sceneId, selfId)
local hp = GetHp(sceneId, selfId)

适用于服务端脚本回调中的有效角色。sceneId 为当前场景 ID，selfId 为场景内对象 ID，取自当前回调参数。

参数说明 · 返回值说明 · 更多示例

调用问题

天龙 Lua 函数手册

@@ 第1行： / 第1行： @@
-<strong>已安装MediaWiki。</strong>
+__NOTOC____NOEDITSECTION__
+<div class="tlbb-wiki-home" style="max-width:1200px;margin:0 auto;color:#29343a;font-family:Arial,'Microsoft YaHei','PingFang SC',sans-serif;font-size:14px;line-height:1.8;letter-spacing:0;overflow-wrap:anywhere;">
-请查阅[https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents 用户指导]以获取使用本wiki软件的信息。
+<div style="padding:22px 0 20px;border-top:4px solid #287568;border-bottom:1px solid #dbe3e6;">
+<div style="font-size:12px;color:#66767c;">TLBB LUA REFERENCE</div>
+<div role="heading" aria-level="2" style="margin:5px 0 8px;font-size:28px;font-weight:bold;line-height:1.4;color:#193d37;">天龙 Lua 函数手册</div>
+<div style="color:#526168;">游戏内置接口的 Lua 用法：函数说明、参数含义、返回值与脚本示例。</div>
+<div style="display:flex;flex-wrap:wrap;gap:8px 24px;margin-top:14px;font-size:13px;">
+<div>[[Lua接口/函数索引|全部函数]]</div>
+<div>[[Lua接口/服务端函数索引|服务端接口]]</div>
+<div>[[Lua接口/客户端函数索引|客户端接口]]</div>
+<div>[[Lua接口/示例索引|脚本示例]]</div>
+<div>[[Special:Search|搜索函数]]</div>
+</div>
+</div>
-== 入门 ==
+<div style="display:flex;flex-wrap:wrap;gap:8px 24px;padding:12px 0;border-bottom:1px solid #dbe3e6;font-size:13px;">
-* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings MediaWiki配置设置列表]
+<div>[[#接口分类|接口分类]]</div>
-* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ/zh-hans MediaWiki常见问题]
+<div>[[#常用函数|常用函数]]</div>
-* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki发布邮件列表]
+<div>[[#示例与常见问题|示例与常见问题]]</div>
-* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources 本地化MediaWiki到您的语言]
+<div>[[Special:PrefixIndex/Lua接口/|全部接口文档]]</div>
-* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam 了解如何在您的wiki上打击破坏]
+<div>[[Special:RecentChanges|最近更新]]</div>
+</div>
+<h2 id="接口分类" style="margin:24px 0 14px;padding:0 0 8px;border-bottom:1px solid #dbe3e6;font-family:inherit;font-size:19px;font-weight:bold;">接口分类</h2>
+<div style="display:flex;flex-wrap:wrap;gap:16px;">
+<div style="flex:1 1 300px;min-width:0;box-sizing:border-box;padding:16px 18px;border:1px solid #dbe3e6;border-top:3px solid #287568;border-radius:4px;background:#fff;">
+<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">角色与属性</h3>
+<div style="margin-bottom:10px;font-size:13px;color:#657078;">角色信息、等级、生命与经验。</div>
+<div>[[Lua接口/角色信息|角色信息]] · [[Lua接口/属性读取与修改|属性读取与修改]]</div>
+<div>[[Lua接口/等级与经验|等级与经验]] · [[Lua接口/货币相关|货币相关]]</div>
+<div style="margin-top:8px;font-family:Consolas,monospace;font-size:13px;">[[Lua接口/服务端/GetName|GetName]] · [[Lua接口/服务端/GetLevel|GetLevel]] · [[Lua接口/服务端/GetHp|GetHp]]</div>
+</div>
+<div style="flex:1 1 300px;min-width:0;box-sizing:border-box;padding:16px 18px;border:1px solid #dbe3e6;border-top:3px solid #467797;border-radius:4px;background:#fff;">
+<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">物品与背包</h3>
+<div style="margin-bottom:10px;font-size:13px;color:#657078;">物品查询、数量判断与道具操作。</div>
+<div>[[Lua接口/物品查询|物品查询]] · [[Lua接口/物品发放与扣除|物品发放与扣除]]</div>
+<div>[[Lua接口/背包空间|背包空间]] · [[Lua接口/装备操作|装备操作]]</div>
+<div style="margin-top:8px;font-family:Consolas,monospace;font-size:13px;">[[Lua接口/服务端/GetItemCount|GetItemCount]]</div>
+</div>
+<div style="flex:1 1 300px;min-width:0;box-sizing:border-box;padding:16px 18px;border:1px solid #dbe3e6;border-top:3px solid #9a7940;border-radius:4px;background:#fff;">
+<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">任务与对话</h3>
+<div style="margin-bottom:10px;font-size:13px;color:#657078;">任务状态、进度记录与 NPC 对话。</div>
+<div>[[Lua接口/任务状态|任务状态]] · [[Lua接口/任务变量|任务变量]]</div>
+<div>[[Lua接口/NPC对话|NPC 对话]] · [[Lua接口/对话选项|对话选项]]</div>
+<div style="margin-top:8px;font-family:Consolas,monospace;font-size:13px;">[[Lua接口/服务端/BeginEvent|BeginEvent]] · [[Lua接口/服务端/AddText|AddText]]</div>
+</div>
+<div style="flex:1 1 300px;min-width:0;box-sizing:border-box;padding:16px 18px;border:1px solid #dbe3e6;border-top:3px solid #597c66;border-radius:4px;background:#fff;">
+<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">场景与活动</h3>
+<div style="margin-bottom:10px;font-size:13px;color:#657078;">场景信息、位置、传送与活动控制。</div>
+<div>[[Lua接口/场景查询|场景查询]] · [[Lua接口/坐标与传送|坐标与传送]]</div>
+<div>[[Lua接口/副本相关|副本相关]] · [[Lua接口/活动相关|活动相关]]</div>
+<div>[[Lua接口/时间与计时|时间与计时]] · [[Lua接口/怪物相关|怪物相关]]</div>
+</div>
+<div style="flex:1 1 300px;min-width:0;box-sizing:border-box;padding:16px 18px;border:1px solid #dbe3e6;border-top:3px solid #7d6472;border-radius:4px;background:#fff;">
+<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">技能与珍兽</h3>
+<div style="margin-bottom:10px;font-size:13px;color:#657078;">技能、心法、状态效果与珍兽操作。</div>
+<div>[[Lua接口/技能相关|技能相关]] · [[Lua接口/心法相关|心法相关]]</div>
+<div>[[Lua接口/状态效果|状态效果]] · [[Lua接口/生活技能|生活技能]]</div>
+<div>[[Lua接口/珍兽查询|珍兽查询]] · [[Lua接口/珍兽操作|珍兽操作]]</div>
+</div>
+<div style="flex:1 1 300px;min-width:0;box-sizing:border-box;padding:16px 18px;border:1px solid #dbe3e6;border-top:3px solid #a36761;border-radius:4px;background:#fff;">
+<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">交互与界面</h3>
+<div style="margin-bottom:10px;font-size:13px;color:#657078;">队伍、帮会、消息与界面脚本。</div>
+<div>[[Lua接口/队伍相关|队伍相关]] · [[Lua接口/帮会相关|帮会相关]]</div>
+<div>[[Lua接口/消息与提示|消息与提示]] · [[Lua接口/聊天与公告|聊天与公告]]</div>
+<div>[[Lua接口/客户端窗口操作|客户端窗口操作]] · [[Lua接口/客户端事件|客户端事件]]</div>
+</div>
+</div>
+<h2 id="常用函数" style="margin:26px 0 12px;padding:0 0 8px;border-bottom:1px solid #dbe3e6;font-family:inherit;font-size:19px;font-weight:bold;">常用函数</h2>
+<div style="margin-bottom:10px;font-size:13px;color:#657078;">服务端 Lua 接口</div>
+{| class="wikitable" style="width:100%;margin:0;border-collapse:collapse;table-layout:fixed;font-size:13px;"
+! scope="col" style="width:24%;padding:9px 10px;text-align:left;background:#edf3f2;" | 函数
+! scope="col" style="width:41%;padding:9px 10px;text-align:left;background:#edf3f2;" | Lua 调用
+! scope="col" style="padding:9px 10px;text-align:left;background:#edf3f2;" | 用途
+|-
+| style="padding:10px;" | [[Lua接口/服务端/GetName|GetName]]
+| style="padding:10px;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetName(sceneId, selfId)</code>
+| style="padding:10px;" | 获取角色名称。
+|-
+| style="padding:10px;" | [[Lua接口/服务端/GetLevel|GetLevel]]
+| style="padding:10px;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetLevel(sceneId, selfId)</code>
+| style="padding:10px;" | 获取角色等级。
+|-
+| style="padding:10px;" | [[Lua接口/服务端/GetHp|GetHp]]
+| style="padding:10px;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetHp(sceneId, selfId)</code>
+| style="padding:10px;" | 获取角色当前生命值。
+|-
+| style="padding:10px;" | [[Lua接口/服务端/GetItemCount|GetItemCount]]
+| style="padding:10px;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetItemCount(sceneId, selfId, itemTypeSn)</code>
+| style="padding:10px;" | 统计指定物品数量，包含已装备与背包中的物品。
+|}
+<h2 id="示例与常见问题" style="margin:26px 0 12px;padding:0 0 8px;border-bottom:1px solid #dbe3e6;font-family:inherit;font-size:19px;font-weight:bold;">示例与常见问题</h2>
+<div style="display:flex;flex-wrap:wrap;gap:18px 32px;">
+<div style="flex:1 1 380px;min-width:0;">
+<h3 style="margin:0 0 8px;padding:0;font-family:inherit;font-size:15px;font-weight:bold;">读取角色信息</h3>
+<pre style="margin:0 0 10px;padding:14px;border:1px solid #dbe3e6;border-left:3px solid #287568;border-radius:3px;background:#f5f7f8;color:#29343a;font-family:Consolas,monospace;font-size:13px;line-height:1.8;white-space:pre-wrap;overflow-wrap:anywhere;"><nowiki>local name = GetName(sceneId, selfId)
+local level = GetLevel(sceneId, selfId)
+local hp = GetHp(sceneId, selfId)</nowiki></pre>
+<div style="font-size:13px;color:#657078;">适用于服务端脚本回调中的有效角色。<code>sceneId</code> 为当前场景 ID，<code>selfId</code> 为场景内对象 ID，取自当前回调参数。</div>
+<div style="margin-top:10px;">[[Lua接口/参数说明|参数说明]] · [[Lua接口/返回值说明|返回值说明]] · [[Lua接口/示例索引|更多示例]]</div>
+</div>
+<div style="flex:1 1 320px;min-width:0;">
+<h3 style="margin:0 0 8px;padding:0;font-family:inherit;font-size:15px;font-weight:bold;">调用问题</h3>
+<div style="padding:7px 0;border-bottom:1px solid #edf0f2;">[[Lua接口/函数不存在|函数不存在或提示 nil]]</div>
+<div style="padding:7px 0;border-bottom:1px solid #edf0f2;">[[Lua接口/参数类型与顺序|参数类型与传入顺序]]</div>
+<div style="padding:7px 0;border-bottom:1px solid #edf0f2;">[[Lua接口/返回值判断|返回值为 0、负数或空字符串]]</div>
+<div style="padding:7px 0;border-bottom:1px solid #edf0f2;">[[Lua接口/对象ID与GUID|对象 ID 与 GUID 的区别]]</div>
+<div style="padding:7px 0;">[[Lua接口/服务端与客户端调用范围|服务端与客户端的调用范围]]</div>
+</div>
+</div>
+<div style="display:flex;flex-wrap:wrap;justify-content:space-between;gap:8px 24px;margin-top:24px;padding:14px 0;border-top:1px solid #dbe3e6;font-size:12px;color:#657078;">
+<div>天龙 Lua 函数手册</div>
+<div>[[Lua接口/函数索引|函数索引]] · [[Lua接口/示例索引|调用示例]] · [[Special:RecentChanges|最近更新]]</div>
+</div>
+</div>

首页：修订间差异

雪舞（留言 | 贡献）

2026年9月7日 (一) 18:31的最新版本

接口分类

角色与属性

物品与背包

任务与对话

场景与活动

技能与珍兽

交互与界面

常用函数

示例与常见问题

读取角色信息

调用问题

导航菜单

页面操作

页面操作

个人工具

导航

搜索

工具

首页：修订间差异

雪舞​（留言 | 贡献）

2026年9月7日 (一) 18:31的最新版本

接口分类

角色与属性

物品与背包

任务与对话

场景与活动

技能与珍兽

交互与界面

常用函数

示例与常见问题

读取角色信息

调用问题

导航菜单

搜索

雪舞（留言 | 贡献）