首页：修订间差异

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

Waylee​（留言 | 贡献）

3个用户组
17,126次编辑
Waylee​（留言 | 贡献）
行政员、​界面管理员、​管理员
17,126次编辑
工程参考新增角色/武器坐骑外观、兽魂珍兽装备、修炼、其他功能配置入口
Waylee​（留言 | 贡献）
行政员、​界面管理员、​管理员
17,126次编辑
优化首页排版：样式外置为 .tlbb-wiki-home 类，桌面三栏/平板两栏/手机单栏
第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-kicker">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 class="home-title" role="heading" aria-level="2">天龙 Lua 函数手册</div>
<div style="color:#526168;">游戏内置接口的 Lua 用法：函数说明、参数含义、返回值与脚本示例。</div>
<p class="home-lead">游戏内置接口的 Lua 用法：函数说明、参数含义、返回值与脚本示例。</p>
<div style="display:flex;flex-wrap:wrap;gap:8px 24px;margin-top:14px;font-size:13px;">
<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>[[Lua接口/客户端函数索引|客户端接口]]</div>
<div class="home-btn">[[Lua接口/客户端函数索引|客户端接口]]</div>
<div>[[Lua接口/示例索引|脚本示例]]</div>
<div class="home-btn">[[Lua接口/示例索引|脚本示例]]</div>
<div>[[Special:Search|搜索函数]]</div>
<div class="home-btn">[[Special:Search|搜索函数]]</div>
</div>
</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行： 第23行：
</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="接口分类">接口分类</h2>
<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-h3">角色与属性</div>
<div style="margin-bottom:10px;font-size:13px;color:#657078;">角色信息、等级、生命与经验。</div>
<p>角色信息、等级、生命与经验。</p>
<div>[[Lua接口/角色信息|角色信息]] · [[Lua接口/属性读取与修改|属性读取与修改]]</div>
<div class="home-card-links">[[Lua接口/角色信息|角色信息]] · [[Lua接口/属性读取与修改|属性读取与修改]]<br />[[Lua接口/等级与经验|等级与经验]] · [[Lua接口/货币相关|货币相关]]</div>
<div>[[Lua接口/等级与经验|等级与经验]] · [[Lua接口/货币相关|货币相关]]</div>
<div class="home-code">[[Lua接口/服务端/GetName|GetName]] · [[Lua接口/服务端/GetLevel|GetLevel]] · [[Lua接口/服务端/GetHp|GetHp]]</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>


<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-h3">物品与背包</div>
<div style="margin-bottom:10px;font-size:13px;color:#657078;">物品查询、数量判断与道具操作。</div>
<p>物品查询、数量判断与道具操作。</p>
<div>[[Lua接口/物品查询|物品查询]] · [[Lua接口/物品发放与扣除|物品发放与扣除]]</div>
<div class="home-card-links">[[Lua接口/物品查询|物品查询]] · [[Lua接口/物品发放与扣除|物品发放与扣除]]<br />[[Lua接口/背包空间|背包空间]] · [[Lua接口/装备操作|装备操作]]</div>
<div>[[Lua接口/背包空间|背包空间]] · [[Lua接口/装备操作|装备操作]]</div>
<div class="home-code">[[Lua接口/服务端/GetItemCount|GetItemCount]]</div>
<div style="margin-top:8px;font-family:Consolas,monospace;font-size:13px;">[[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-h3">任务与对话</div>
<div style="margin-bottom:10px;font-size:13px;color:#657078;">任务状态、进度记录与 NPC 对话。</div>
<p>任务状态、进度记录与 NPC 对话。</p>
<div>[[Lua接口/任务状态|任务状态]] · [[Lua接口/任务变量|任务变量]]</div>
<div class="home-card-links">[[Lua接口/任务状态|任务状态]] · [[Lua接口/任务变量|任务变量]]<br />[[Lua接口/NPC对话|NPC 对话]] · [[Lua接口/对话选项|对话选项]]</div>
<div>[[Lua接口/NPC对话|NPC 对话]] · [[Lua接口/对话选项|对话选项]]</div>
<div class="home-code">[[Lua接口/服务端/BeginEvent|BeginEvent]] · [[Lua接口/服务端/AddText|AddText]]</div>
<div style="margin-top:8px;font-family:Consolas,monospace;font-size:13px;">[[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-h3">场景与活动</div>
<div style="margin-bottom:10px;font-size:13px;color:#657078;">场景信息、位置、传送与活动控制。</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>[[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-h3">技能与珍兽</div>
<div style="margin-bottom:10px;font-size:13px;color:#657078;">技能、心法、状态效果与珍兽操作。</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>[[Lua接口/珍兽查询|珍兽查询]] · [[Lua接口/珍兽操作|珍兽操作]]</div>
 
<div class="home-card c-clay">
<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="常用函数">常用函数</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="示例与常见问题">示例与常见问题</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="工程参考">工程参考</h2>
<div class="home-links">
<div>[[工程参考/服务端外网设置|服务端外网设置]]</div>
<div>[[工程参考/服务端外网设置|服务端外网设置]]</div>
<div>[[工程参考/登录器配置|登录器配置（Launch.ini）]]</div>
<div>[[工程参考/登录器配置|登录器配置（Launch.ini）]]</div>
第138行： 第142行：
<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>天龙 Lua 函数手册</div>
<div>[[Lua接口/函数索引|函数索引]] · [[Lua接口/示例索引|调用示例]] · [[Special:RecentChanges|最近更新]]</div>
<div>[[Lua接口/函数索引|函数索引]] · [[Lua接口/示例索引|调用示例]] · [[Special:RecentChanges|最近更新]]</div>
</div>
</div>
</div>
</div>

2026年11月8日 (日) 02:25的版本

TLBB LUA REFERENCE
天龙 Lua 函数手册

游戏内置接口的 Lua 用法：函数说明、参数含义、返回值与脚本示例。

全部函数
服务端接口
客户端接口
脚本示例
搜索函数

接口分类

角色与属性

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

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

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

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

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

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

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

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

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

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

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

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

常用函数

服务端 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 的区别
服务端与客户端的调用范围

工程参考

天龙 Lua 函数手册
取自“https://www.waylee.net/index.php?title=首页&oldid=19491”