天龙知识库 wiki https://www.waylee.net/index.php?title=%E9%A6%96%E9%A1%B5 MediaWiki 1.46.0 first-letter 媒体 特殊 讨论 用户 用户讨论 天龙知识库 天龙知识库讨论 文件 文件讨论 MediaWiki MediaWiki讨论 模板 模板讨论 帮助 帮助讨论 分类 分类讨论 0 1 6 5 2026-09-07T10:31:57Z 雪舞 3 创建 Lua 函数手册首页，整理接口分类、常用函数和调用示例 6 wikitext text/x-wiki __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;"> <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;"> <div>[[#接口分类|接口分类]]</div> <div>[[#常用函数|常用函数]]</div> <div>[[#示例与常见问题|示例与常见问题]]</div> <div>[[Special:PrefixIndex/Lua接口/|全部接口文档]]</div> <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> d00ipz7bpozzz2z2ne8jk7oot6sakn5