首页：修订间差异

来自雪舞天龙知识库
跳到导航跳到搜索
←上一编辑

Waylee​（留言 | 贡献）

3个用户组
17,126次编辑
Waylee​（留言 | 贡献）
行政员、​界面管理员、​管理员
17,126次编辑
工程参考新增角色/武器坐骑外观、兽魂珍兽装备、修炼、其他功能配置入口
Waylee​（留言 | 贡献）
行政员、​界面管理员、​管理员
17,126次编辑
首页工程参考区块新增回收系统入口
 
（未显示同一用户的2个中间版本）
第1行： 第1行：
__NOTOC____NOEDITSECTION__
__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 class="tlbb-wiki-home">


<div style="padding:22px 0 20px;border-top:4px solid #287568;border-bottom:1px solid #dbe3e6;">
<div class="home-hero">
<div style="font-size:12px;color:#66767c;">TLBB LUA REFERENCE</div>
<div class="home-crest" aria-hidden="true"></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 class="home-kicker">XUEWU / KNOWLEDGE ARCHIVE</div>
<div style="color:#526168;">游戏内置接口的 Lua 用法：函数说明、参数含义、返回值与脚本示例。</div>
<div class="home-brand">雪舞天龙 · 开发者文库</div>
<div style="display:flex;flex-wrap:wrap;gap:8px 24px;margin-top:14px;font-size:13px;">
<div class="home-title" role="heading" aria-level="1">天龙开发，<br />有据可循。</div>
<div>[[Lua接口/函数索引|全部函数]]</div>
<p class="home-lead">天龙 Lua 函数手册与工程资料。<br />从一个函数，到一片江湖。查接口、读示例，让每一次开发有据可循。</p>
<div>[[Lua接口/服务端函数索引|服务端接口]]</div>
<div class="home-actions">
<div>[[Lua接口/客户端函数索引|客户端接口]]</div>
<div class="home-btn home-btn-primary">[[Lua接口/函数索引|全部函数]]</div>
<div>[[Lua接口/示例索引|脚本示例]]</div>
<div class="home-btn">[[Lua接口/服务端函数索引|服务端接口]]</div>
<div>[[Special:Search|搜索函数]]</div>
<div class="home-btn">[[Lua接口/客户端函数索引|客户端接口]]</div>
<div class="home-btn">[[Lua接口/示例索引|脚本示例]]</div>
<div class="home-btn">[[Special:Search|搜索函数]]</div>
</div>
</div>
<div class="home-hero-foot"><span><b>01</b> 服务端接口</span><span><b>02</b> 客户端脚本</span><span><b>03</b> 工程参考</span></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 class="home-nav">
<div>[[#接口分类|接口分类]]</div>
<div>[[#接口分类|接口分类]]</div>
<div>[[#常用函数|常用函数]]</div>
<div>[[#常用函数|常用函数]]</div>
第23行： 第26行：
</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 class="home-section">
<div style="display:flex;flex-wrap:wrap;gap:16px;">
<h2 class="home-h2" id="接口分类"><span class="home-section-no" aria-hidden="true">01</span>接口分类</h2>
<div class="home-section-caption">循着需求，找到你的下一行代码。</div>
<div class="home-grid home-grid-3">


<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;">
<div class="home-card c-teal">
<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">角色与属性</h3>
<div class="home-card-label">01 / CHARACTER</div>
<div style="margin-bottom:10px;font-size:13px;color:#657078;">角色信息、等级、生命与经验。</div>
<div class="home-h3">角色与属性</div>
<div>[[Lua接口/角色信息|角色信息]] · [[Lua接口/属性读取与修改|属性读取与修改]]</div>
<p>角色信息、等级、生命与经验。</p>
<div>[[Lua接口/等级与经验|等级与经验]] · [[Lua接口/货币相关|货币相关]]</div>
<div class="home-card-links">[[Lua接口/角色信息|角色信息]] · [[Lua接口/属性读取与修改|属性读取与修改]]<br />[[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 class="home-code">[[Lua接口/服务端/GetName|GetName]] · [[Lua接口/服务端/GetLevel|GetLevel]] · [[Lua接口/服务端/GetHp|GetHp]]</div>
</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;">
<div class="home-card c-blue">
<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">物品与背包</h3>
<div class="home-card-label">02 / INVENTORY</div>
<div style="margin-bottom:10px;font-size:13px;color:#657078;">物品查询、数量判断与道具操作。</div>
<div class="home-h3">物品与背包</div>
<div>[[Lua接口/物品查询|物品查询]] · [[Lua接口/物品发放与扣除|物品发放与扣除]]</div>
<p>物品查询、数量判断与道具操作。</p>
<div>[[Lua接口/背包空间|背包空间]] · [[Lua接口/装备操作|装备操作]]</div>
<div class="home-card-links">[[Lua接口/物品查询|物品查询]] · [[Lua接口/物品发放与扣除|物品发放与扣除]]<br />[[Lua接口/背包空间|背包空间]] · [[Lua接口/装备操作|装备操作]]</div>
<div style="margin-top:8px;font-family:Consolas,monospace;font-size:13px;">[[Lua接口/服务端/GetItemCount|GetItemCount]]</div>
<div class="home-code">[[Lua接口/服务端/GetItemCount|GetItemCount]]</div>
</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;">
<div class="home-card c-gold">
<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">任务与对话</h3>
<div class="home-card-label">03 / MISSION</div>
<div style="margin-bottom:10px;font-size:13px;color:#657078;">任务状态、进度记录与 NPC 对话。</div>
<div class="home-h3">任务与对话</div>
<div>[[Lua接口/任务状态|任务状态]] · [[Lua接口/任务变量|任务变量]]</div>
<p>任务状态、进度记录与 NPC 对话。</p>
<div>[[Lua接口/NPC对话|NPC 对话]] · [[Lua接口/对话选项|对话选项]]</div>
<div class="home-card-links">[[Lua接口/任务状态|任务状态]] · [[Lua接口/任务变量|任务变量]]<br />[[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 class="home-code">[[Lua接口/服务端/BeginEvent|BeginEvent]] · [[Lua接口/服务端/AddText|AddText]]</div>
</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;">
<div class="home-card c-green">
<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">场景与活动</h3>
<div class="home-card-label">04 / WORLD</div>
<div style="margin-bottom:10px;font-size:13px;color:#657078;">场景信息、位置、传送与活动控制。</div>
<div class="home-h3">场景与活动</div>
<div>[[Lua接口/场景查询|场景查询]] · [[Lua接口/坐标与传送|坐标与传送]]</div>
<p>场景信息、位置、传送与活动控制。</p>
<div>[[Lua接口/副本相关|副本相关]] · [[Lua接口/活动相关|活动相关]]</div>
<div class="home-card-links">[[Lua接口/场景查询|场景查询]] · [[Lua接口/坐标与传送|坐标与传送]]<br />[[Lua接口/副本相关|副本相关]] · [[Lua接口/活动相关|活动相关]]<br />[[Lua接口/时间与计时|时间与计时]] · [[Lua接口/怪物相关|怪物相关]]</div>
<div>[[Lua接口/时间与计时|时间与计时]] · [[Lua接口/怪物相关|怪物相关]]</div>
</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;">
<div class="home-card c-plum">
<h3 style="margin:0 0 5px;padding:0;font-family:inherit;font-size:17px;font-weight:bold;">技能与珍兽</h3>
<div class="home-card-label">05 / SKILL & PET</div>
<div style="margin-bottom:10px;font-size:13px;color:#657078;">技能、心法、状态效果与珍兽操作。</div>
<div class="home-h3">技能与珍兽</div>
<div>[[Lua接口/技能相关|技能相关]] · [[Lua接口/心法相关|心法相关]]</div>
<p>技能、心法、状态效果与珍兽操作。</p>
<div>[[Lua接口/状态效果|状态效果]] · [[Lua接口/生活技能|生活技能]]</div>
<div class="home-card-links">[[Lua接口/技能相关|技能相关]] · [[Lua接口/心法相关|心法相关]]<br />[[Lua接口/状态效果|状态效果]] · [[Lua接口/生活技能|生活技能]]<br />[[Lua接口/珍兽查询|珍兽查询]] · [[Lua接口/珍兽操作|珍兽操作]]</div>
<div>[[Lua接口/珍兽查询|珍兽查询]] · [[Lua接口/珍兽操作|珍兽操作]]</div>
</div>
 
<div class="home-card c-clay">
<div class="home-card-label">06 / INTERACTION</div>
<div class="home-h3">交互与界面</div>
<p>队伍、帮会、消息与界面脚本。</p>
<div class="home-card-links">[[Lua接口/队伍相关|队伍相关]] · [[Lua接口/帮会相关|帮会相关]]<br />[[Lua接口/消息与提示|消息与提示]] · [[Lua接口/聊天与公告|聊天与公告]]<br />[[Lua接口/客户端窗口操作|客户端窗口操作]] · [[Lua接口/客户端事件|客户端事件]]<br />[[Lua接口/客户端界面索引|客户端界面索引]]</div>
</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>[[Lua接口/客户端界面索引|客户端界面索引]]</div>
</div>
</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 class="home-section">
<div style="margin-bottom:10px;font-size:13px;color:#657078;">服务端 Lua 接口</div>
<h2 class="home-h2" id="常用函数"><span class="home-section-no" aria-hidden="true">02</span>常用函数</h2>
{| class="wikitable" style="width:100%;margin:0;border-collapse:collapse;table-layout:fixed;font-size:13px;"
<div class="home-note">服务端 Lua 接口</div>
! scope="col" style="width:24%;padding:9px 10px;text-align:left;background:#edf3f2;" | 函数
<div class="home-table">
! scope="col" style="width:41%;padding:9px 10px;text-align:left;background:#edf3f2;" | Lua 调用
{| class="wikitable"
! scope="col" style="padding:9px 10px;text-align:left;background:#edf3f2;" | 用途
! scope="col" | 函数
! scope="col" | Lua 调用
! scope="col" | 用途
|-
|-
| style="padding:10px;" | [[Lua接口/服务端/GetName|GetName]]
| data-label="函数" | [[Lua接口/服务端/GetName|GetName]]
| style="padding:10px;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetName(sceneId, selfId)</code>
| data-label="Lua 调用" | <code>GetName(sceneId, selfId)</code>
| style="padding:10px;" | 获取角色名称。
| data-label="用途" | 获取角色名称。
|-
|-
| style="padding:10px;" | [[Lua接口/服务端/GetLevel|GetLevel]]
| data-label="函数" | [[Lua接口/服务端/GetLevel|GetLevel]]
| style="padding:10px;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetLevel(sceneId, selfId)</code>
| data-label="Lua 调用" | <code>GetLevel(sceneId, selfId)</code>
| style="padding:10px;" | 获取角色等级。
| data-label="用途" | 获取角色等级。
|-
|-
| style="padding:10px;" | [[Lua接口/服务端/GetHp|GetHp]]
| data-label="函数" | [[Lua接口/服务端/GetHp|GetHp]]
| style="padding:10px;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetHp(sceneId, selfId)</code>
| data-label="Lua 调用" | <code>GetHp(sceneId, selfId)</code>
| style="padding:10px;" | 获取角色当前生命值。
| data-label="用途" | 获取角色当前生命值。
|-
|-
| style="padding:10px;" | [[Lua接口/服务端/GetItemCount|GetItemCount]]
| data-label="函数" | [[Lua接口/服务端/GetItemCount|GetItemCount]]
| style="padding:10px;" | <code style="white-space:normal;overflow-wrap:anywhere;">GetItemCount(sceneId, selfId, itemTypeSn)</code>
| data-label="Lua 调用" | <code>GetItemCount(sceneId, selfId, itemTypeSn)</code>
| style="padding:10px;" | 统计指定物品数量，包含已装备与背包中的物品。
| data-label="用途" | 统计指定物品数量，包含已装备与背包中的物品。
|}
|}
</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 class="home-section">
<div style="display:flex;flex-wrap:wrap;gap:18px 32px;">
<h2 class="home-h2" id="示例与常见问题"><span class="home-section-no" aria-hidden="true">03</span>示例与常见问题</h2>
<div style="flex:1 1 380px;min-width:0;">
<div class="home-grid home-grid-2">
<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)
<div class="home-panel">
<div class="home-h3">读取角色信息</div>
<pre class="home-pre"><nowiki>local name = GetName(sceneId, selfId)
local level = GetLevel(sceneId, selfId)
local level = GetLevel(sceneId, selfId)
local hp = GetHp(sceneId, selfId)</nowiki></pre>
local hp = GetHp(sceneId, selfId)</nowiki></pre>
<div style="font-size:13px;color:#657078;">适用于服务端脚本回调中的有效角色。<code>sceneId</code> 为当前场景 ID，<code>selfId</code> 为场景内对象 ID，取自当前回调参数。</div>
<div class="home-note">适用于服务端脚本回调中的有效角色。<code>sceneId</code> 为当前场景 ID，<code>selfId</code> 为场景内对象 ID，取自当前回调参数。</div>
<div style="margin-top:10px;">[[Lua接口/参数说明|参数说明]] · [[Lua接口/返回值说明|返回值说明]] · [[Lua接口/示例索引|更多示例]]</div>
<div class="home-note">[[Lua接口/参数说明|参数说明]] · [[Lua接口/返回值说明|返回值说明]] · [[Lua接口/示例索引|更多示例]]</div>
</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 class="home-panel">
<div style="padding:7px 0;border-bottom:1px solid #edf0f2;">[[Lua接口/函数不存在|函数不存在或提示 nil]]</div>
<div class="home-h3">调用问题</div>
<div style="padding:7px 0;border-bottom:1px solid #edf0f2;">[[Lua接口/参数类型与顺序|参数类型与传入顺序]]</div>
<div class="home-faq">[[Lua接口/函数不存在|函数不存在或提示 nil]]</div>
<div style="padding:7px 0;border-bottom:1px solid #edf0f2;">[[Lua接口/返回值判断|返回值为 0、负数或空字符串]]</div>
<div class="home-faq">[[Lua接口/参数类型与顺序|参数类型与传入顺序]]</div>
<div style="padding:7px 0;border-bottom:1px solid #edf0f2;">[[Lua接口/对象ID与GUID|对象 ID 与 GUID 的区别]]</div>
<div class="home-faq">[[Lua接口/返回值判断|返回值为 0、负数或空字符串]]</div>
<div style="padding:7px 0;">[[Lua接口/服务端与客户端调用范围|服务端与客户端的调用范围]]</div>
<div class="home-faq">[[Lua接口/对象ID与GUID|对象 ID 与 GUID 的区别]]</div>
<div class="home-faq">[[Lua接口/服务端与客户端调用范围|服务端与客户端的调用范围]]</div>
</div>
 
</div>
</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 class="home-section">
<h2 class="home-h2" id="工程参考"><span class="home-section-no" aria-hidden="true">04</span>工程参考</h2>
<div class="home-links">
<div>[[工程参考/服务端外网设置|服务端外网设置]]</div>
<div>[[工程参考/服务端外网设置|服务端外网设置]]</div>
<div>[[工程参考/登录器配置|登录器配置（Launch.ini）]]</div>
<div>[[工程参考/登录器配置|登录器配置（Launch.ini）]]</div>
<div>[[工程参考/配置文件索引|配置文件索引]]</div>
<div>[[工程参考/配置文件索引|配置文件索引]]</div>
<div>[[工程参考/回收系统|回收系统（ItemRecycle…）]]</div>
<div>[[工程参考/影响逻辑清单|影响逻辑清单（StdImpact…）]]</div>
<div>[[工程参考/影响逻辑清单|影响逻辑清单（StdImpact…）]]</div>
<div>[[工程参考/活动系统|活动系统（ActivityNotice…）]]</div>
<div>[[工程参考/活动系统|活动系统（ActivityNotice…）]]</div>
第138行： 第153行：
<div>[[工程参考/修炼配置|修炼配置（7 表）]]</div>
<div>[[工程参考/修炼配置|修炼配置（7 表）]]</div>
<div>[[工程参考/其他功能配置|其他功能配置（7 表）]]</div>
<div>[[工程参考/其他功能配置|其他功能配置（7 表）]]</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 class="home-footer">
<div>天龙 Lua 函数手册</div>
<div class="home-footer-brand">XueWu 雪舞天龙</div>
<div>[[Lua接口/函数索引|函数索引]] · [[Lua接口/示例索引|调用示例]] · [[Special:RecentChanges|最近更新]]</div>
<div>[[Lua接口/函数索引|函数索引]] · [[Lua接口/示例索引|调用示例]] · [[Special:RecentChanges|最近更新]]</div>
</div>
</div>
</div>
</div>

2026年11月14日 (六) 21:34的最新版本

XUEWU / KNOWLEDGE ARCHIVE
雪舞天龙 · 开发者文库
天龙开发，
有据可循。

天龙 Lua 函数手册与工程资料。
从一个函数，到一片江湖。查接口、读示例，让每一次开发有据可循。

全部函数
服务端接口
客户端接口
脚本示例
搜索函数
01 服务端接口02 客户端脚本03 工程参考

接口分类

循着需求，找到你的下一行代码。
01 / CHARACTER
角色与属性

角色信息、等级、生命与经验。

角色信息 · 属性读取与修改
等级与经验 · 货币相关
GetName · GetLevel · GetHp
02 / INVENTORY
物品与背包

物品查询、数量判断与道具操作。

物品查询 · 物品发放与扣除
背包空间 · 装备操作
GetItemCount
03 / MISSION
任务与对话

任务状态、进度记录与 NPC 对话。

任务状态 · 任务变量
NPC 对话 · 对话选项
BeginEvent · AddText
04 / WORLD
场景与活动

场景信息、位置、传送与活动控制。

场景查询 · 坐标与传送
副本相关 · 活动相关
时间与计时 · 怪物相关
05 / SKILL & PET
技能与珍兽

技能、心法、状态效果与珍兽操作。

技能相关 · 心法相关
状态效果 · 生活技能
珍兽查询 · 珍兽操作
06 / INTERACTION
交互与界面

队伍、帮会、消息与界面脚本。

队伍相关 · 帮会相关
消息与提示 · 聊天与公告
客户端窗口操作 · 客户端事件
客户端界面索引

常用函数

服务端 Lua 接口
函数 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，取自当前回调参数。
参数说明 · 返回值说明 · 更多示例
调用问题
函数不存在或提示 nil
参数类型与传入顺序
返回值为 0、负数或空字符串
对象 ID 与 GUID 的区别
服务端与客户端的调用范围

工程参考

XueWu 雪舞天龙
取自“https://www.waylee.net/index.php?title=首页&oldid=24601”