热血江湖版本开发

讲解要点与指令拆解

1. 编辑器以"包"为单位组织资源，新建包后可创建组件；外部图片直接拖入包内即可使用。
2. 图片可双击设置平铺/九宫格；按钮组件支持普通/单选/复选，可自带动效与变色。
3. 使用前必须对组件右键"设为导出"（红点标记）再发布；发布路径指向客户端工程 export 目录。
4. 打开界面的唯一入口是 fgui.open(资源包名,组件名)，后续可选挂载点/层级；按键触发、点击 NPC、后端消息号最终都走它。
5. 前端 Lua 逻辑文件放在 layout 目录下与包同名的文件夹中，文件名/包名/组件名大小写必须严格一致。
6. 逻辑文件头部必须引用固定头文件并 return 一个表（等价于后端 class 实例化），否则界面 Lua 不加载。
7. 界面生命周期提供五个固定回调（创建/打开/关闭时等），用到哪个写哪个。
8. 排查"界面不出来"的坑：包名/文件名大小写、文件编码（需 UTF-8）；首次加载 GUI/Unity 要退回登录重进；界面改动发布后前端自动热更。
9. 通过 self.UI 获取界面子组件，用 UI.N1 注册点击回调并调用关闭界面接口。
10. 已发布组件可跨包拖拽复用；动态创建组件用"创建对象"命令（同步/异步两版），父节点填 UI 容器名。
11. item show 官方无原生组件，是引擎/底板自封装，需自己再包一层调用；换图用装载器而非直接替换图片。
12. 提出"公共包+统一封装"思路：把常用按钮、提示框放进公共包，后端用 class 方式统一驱动前端。

学完学员应掌握技能

• 能在 FGUI 编辑器中建包、建组件、拖素材、设导出并发布到热血江湖客户端工程。
• 会用 fgui.open 在游戏内打开界面，并配置空格键作为调试入口。
• 会按固定模板在 layout 中编写界面 Lua，处理创建/关闭生命周期并实现按钮关闭界面。
• 能独立排查"界面打开没反应/找不到文件"类问题（大小写、编码、路径对应、导出发布）。
• 理解公共包 + 动态创建对象接口 + 自封装 item show/列表的复用思路。
• ---

讲解要点与指令拆解

1. 热血江湖后端与传奇引擎同源：QF 入口、M2 控制台、热更、debug 结构一致；自定义变量区分临时型与可保存型。
2. 官方自带服务器全局变量、玩家源变量等模块，讲师统一封装成与传奇一致的 setvar/getvar 写法。
3. 玩家对象用"对象以身份证存入 → new 实例 → 继承大表"方式创建，内含常量、方法与动态映射表（__index 每次取索引时刷新）。
4. 用官方接口一次性取等级、名称等字段，把 name/level/job/sex/地图/坐标映射为对象属性。
5. 货币等离散值先做"中文名→ID"初始化映射表，函数按中文名返回 ID。
6. PM.setvar/getvar 用 type 区分存取：数字走 set int/get int、字符串走 set str、表自动转 JSON 存储还原。
7. 坑1：getvar 取不存在的变量返回空字符串而非 nil，判空需同时排除空串与 0；坑2：热更后重复定义不生效需重启端。
8. 天变量封装：用 os.date 拼"月日"存为天标识，登录/设置时对比判断跨天；0 点自动清理靠引擎"零点自动执行一次"。
9. 天变量列表取 table 后 for pairs 遍历按类型处理：数字清 0，字符串/表清空。
10. 定点定时任务写在服务端定时器文件里，函数名配合时间配置即定点触发，框架自动加载。
11. 变量推送测试以"走路触发"跑通：set 变量 → 本地打印验证 → 发送到前端 debug 接收。

学完学员应掌握技能

• 掌握热血江湖可保存自定义变量的 set/get 接口，及数字、字符串、table 三类的存储与还原写法。
• 会封装玩家对象与货币等 ID 映射配置，减少查说明书。
• 能独立实现"天变量/每日清零"类逻辑（含 0 点自动清理），并避开空字符串返回与热更注册两大坑。
• 理解"后端设置变量即推送前端"的整体思路。
• ---

讲解要点与指令拆解

1. Hub 注册即可建项目；开发期直接跟最新端；创建服务端、客户端目录后启动。
2. 需下载：界面工程文件、layout 逻辑文件、GUI 工具、美术资源包、Unity 工程；Unity 精确版本号必须与项目一致。
3. 前端基于 Unity（U3D）+ Lua 嵌入，FGUI 前端 Lua 与 Unity 内嵌 Lua 是不同嵌入点；字体打包比 Cocos 多一步。
4. 后端框架与传奇几乎一样：QF 入口、M2 控制台、热更；前端首次需"小退/重进"重载 GUI。
5. 官方说明书难用且有粘贴错误，建议自建说明书沉淀命令与协议。
6. 前后端通讯共 4 个函数：前端→后端发送、后端接收注册、后端→前端发送、前端接收注册；注意 Lua 协议与 TXT 命令两层不能发错。
7. 空格调试框架：前端空格重载脚本并向后端发 999 号协议，后端热更/重载 NPC，一键刷新。
8. 源变量是理解前端的核心：可读宽高等常量与背包数据；背包 key 为字符串主键，make 索引=物品唯一身份证，索引=模板类 ID，位置 -1 表示在背包。
9. SL 库管逻辑，GUI/FGUI 库管界面组件，可改名导入并统一封装点击事件。
10. 提出"后端下发前端代码"写法：后端把 FGUI 模块代码经协议发给前端执行并 open，前后端共享 config；代价是吃带宽且协议限制约 15000 字符。
11. 演示前端创建并执行动作（moveTo 等）控制组件，并讨论单包/多包 NPC 与图集预加载问题。

学完学员应掌握技能

• 会从 Hub 建热血江湖项目，并下载、配置 FGUI/layout 等工程工具。
• 掌握前后端 4 个协议接口的注册与调用，能收发自定义消息。
• 能搭起"空格一键重载前后端"调试框架。
• 会用源变量读取角色/背包/属性数据，理解物品唯一 ID（make）与模板 ID 的差别。
• 理解"后端下发前端代码"框架的收益、带宽成本与 15000 字符上限。
• ---

讲解要点与指令拆解

1. 改革做法：只用单个包 ACB，把所有资源放同一包，减少来回拖拽与发布。
2. NPC 配置沿用传统做法：地图 + 坐标 + 模型编号，再新建对应 Lua 脚本驱动。
3. 动态创建图片流程："创建组件/对象"命令（包名 + 组件名 + 是否显示）创建对象，再 add 到父节点显示。
4. 调用未发布的组件会报"没找到某包"——组件必须"设为导出"并 F9 发布。
5. 批量创建：for 循环替换资源名（string.format），用 (i-1)*间距 排位循环创建多张图/按钮。
6. 公共按钮组件：单独建 button 组件放包内，代码循环实例化挂到界面。
7. 获取子项：getChild/getChildIndex 等；容器内索引从 0 开始，写 1~5 必须 i-1。
8. 列表容器三步：子项设导出并设为列表"默认项模板"→ set number 设数量 → 循环 getChild(i) 取对象、setOnClick 绑点击。
9. 换图坑：编辑器用图形(Graphics)画的背景不能改图；拖入的实体图可 set 纹理替换；通用做法用装载器(Loader)。
10. 静态界面直接在编辑器摆好并命名，代码用 UI.Ai / UI.BG 直接拿节点改属性；动态部分交给列表与刷新。
11. 建议把常用操作封装成 GUI 层函数，避免翻官方说明书。

学完学员应掌握技能

• 会用 FGUI 编辑器搭建 NPC 界面（背景/文字/按钮/列表）并正确发布供代码调用。
• 掌握代码动态创建图片/按钮、循环实例化并挂父节点的方法。
• 会做"列表容器 + 默认项 + 数量 + 循环绑定点击"的完整列表，牢记索引从 0 开始。
• 能区分图形容器、图片、装载器的换图差异，选对控件实现图片切换。
• 形成"静态界面编辑器摆好、动态内容用列表/装载器"的开发习惯。
• ---

讲解要点与指令拆解

1. 两种打开 NPC 方式：①前端 NPC 触发发后端（后端审核，适合万人服）；②后端 NPC 触发发前端（官方/TXT 默认）。
2. 讲师框架选择"后端把前端代码整段下发"：牺牲带宽换取前后端共用函数与 config、免切编辑器、免打包更新，并可做混淆/加密。
3. 后端入口：QF 只保留 require 封装入口，内部按模块放常用函数、客户端加载、服务端协议发放等；NPC 点击主入口单独拆文件。
4. NPC 点击打包流程：按脚本名读文件 → 截取"前端开始…前端结束"标记段 → 装入带玩家名/脚本名的 data 表 → 校验不超约 15000 字符 → 经 1000 号协议发前端。
5. 文件读取带缓存：缓存命中直接返回，未命中才读盘并 load。
6. 前端 init 表：加载并改名 SL 与 GUI（包装 onClick 支持链式）；net 表注册监听；config 表放协议号/颜色/时间常量。
7. 前端收 1000 号协议后：load 编译代码 → 追加 return NPC 类并自动审核 main → 失败报编译错误 → 成功写缓存并关旧界面 → GUI.open 对应组件。
8. NPC 脚本与 FGUI 组件同名约定，传参即用中文 NPC 名，100 个 NPC 可统一走同一入口。
9. 现场全流程演示：新建"你好NPC"组件 → 新建脚本 → 后端补协议 → 点击 NPC 打开界面。
10. 对比官方"一 NPC 一包一界面"与讲师"一包多组件"，强调按实际灵活取舍。

学完学员应掌握技能

• 理解两种 NPC 打开方式的实现与适用场景。
• 掌握"后端下发前端代码"框架完整链路：读文件→截段→协议下发→前端编译→打开组件。
• 会写标准 NPC 模块（return NPC 类、自动审核 main），把生命周期挂到规定回调。
• 能搭建前端 init/net/config 体系，自封装 GUI 点击事件与链式写法。
• 了解该方案的带宽成本、15000 字符限制与混淆/加密演进方向。
• ---

讲解要点与指令拆解

1. 设计原则：只在"设置变量"时推送，获取时不推送；推送动作封装为 sendClient 类函数。
2. 复用前几节封装的 setvar/getvar（type：1 数字 / 2 字符串 / 3 表，表自动 JSON 化存储）。
3. 推送协议号自定（先用 999，因与重载协议冲突改 1234）；后端把 JSON 文本发往前端。
4. 用"前端变量列表"聚合：setvar 带推送标记时把 varName/varType/varValue 写入该表，最后整表 tojson 一次发出。
5. 大坑：连续设置多个变量会互相覆盖——必须先读回旧列表合并再写。
6. 前端 net 表注册接收 1234 协议，json to table 还原后存入前端全局变量供所有 NPC 共享。
7. SL 库增强：新增 getvar(name)——先从全局取 JSON，再按类型字段自动还原，取不到给空值提示。
8. 前后端类型约定一致（1/2/3）；setvar 内部按实际值类型自适应选存储接口。
9. 踩坑复盘：函数重名致协议串线、缓存未清改后不生效需大退重进、字符串与大小写参数错误逐一排查。
10. 实测：走路触发连续设置多个变量，前端能收到完整 name=值 列表，table 也能原样还原直接使用。
11. 扩展用法：大 data 表也可起变量名一次性下发，前端 getvar 取到即用。

学完学员应掌握技能

• 会实现"后端设变量 → 前端自动接收"的推送链路，理解为何用聚合变量列表推送。
• 掌握前端 net 协议监听、JSON 还原与 SL.getvar 类型自适应取值的封装写法。
• 能规避多变量互相覆盖、函数名/协议号冲突、缓存未清等实战坑。
• 具备独立调试"设→推→收→取→刷 UI"完整变量链路的能力。
• ---

讲解要点与指令拆解

1. 官方 item show 是 util 文件而非注册接口，需自行加载调用；内含创建、销毁、刷新、取头像/品质/数量等函数，均以"传入组件"方式工作。
2. 官方刷新函数内部调用品级、头像、层级、镶嵌、数量渲染五个子函数。
3. 官方另提供前端检测类函数（装备等级够不够、红点引导），可减轻服务器压力。
4. item 创建函数要传 item data、父节点、是否显示背景框等参数，PC 与手机端有差异，说明书未收录，只能翻底板/底层代码找。
5. 数据来源用源变量"背包所有物品"→ bag.data 表，主键即物品 key；for k,v in pairs 中 v 就是道具数据。
6. 场景1（背包展示）：循环取 UI.Ni 格子为父节点，把背包 data 逐个传入创建函数显示。
7. 场景2（按名字创建）：名字→转 IDX→再取数据，或用官方"按 ID 创建"接口省一步；封装成 createByID(id,节点) 两参。
8. 场景3（身上装备）：源变量/装备位接口取装备数据；位置表约定武器=0、衣服=1…；部分接口需带后缀才返回对象。
9. 点击回调：item 创建参数中带单击/双击回调，前端据此发协议给后端做交互。
10. 后端改属性后必须发前端刷新指令，否则前端数值不更新。
11. 刷新物品三种方式：①移除再创建（性能好）；②直接调官方刷新函数（演示未调通）；③自封装"创建与刷新同一接口"，最简单可控。
12. 结论：item 创建参数多且繁琐，必须封装成少量参数的工具函数。

学完学员应掌握技能

• 掌握 item show 的创建/销毁/刷新函数族，及"传入组件取头像/品质/数量"的用法。
• 能分别从背包数据、物品名字、身上装备位三种来源把物品展示到 UI 格子。
• 会用"移除再创建"与"创建=刷新同一接口"两种稳定方案刷新道具显示。
• 养成把 item 创建类操作封装成两参函数的习惯。
• ---

讲解要点与指令拆解

1. 后端自定义属性 = 往装备对象上 set 自定义 int/str 字段：接口形如"装备位/装备对象 + 位置 + 键 + 值"（武器位=0），另有获取及清除（-1）对应接口。
2. 官方对装备/道具接口的说明分散简陋，需耐心检索或直接使用已封装方法。
3. 显示文本支持两种语法：UBB 语法（[color=…]）与传奇富文本语法，可换行、可彩色。
4. 描述串建议自己拼好并封装：做成"传位置 + 组号"返回拼好的富文本字符串的函数。
5. 改 Tips 必须结合 FGUI 编辑器：定位对应 tip 包与组件（物品 tips、装备 tips，另有手机端包），改放属性文本的控件，不能只改文件。
6. 道具与装备分别走不同 Tips；Tips 打开走公共组件，内部按 PC 与手机读两套资源。
7. 排错辅助：官方 dump 打不出深层嵌套表，需自写递归打印（for pairs 多级 + 类型判断）。
8. 装备/道具自定义变量与人物变量一致可用 set int/str 类接口，通过装备对象或物品对象操作。
9. 演示游戏内 Tips 弹出并打印数据，逐层取到属性集，确认前端能拿到后端写入的自定义属性。
10. 多级数据打印/展示时注意为空判断，避免前端缺字段直接报错。

学完学员应掌握技能

• 会从后端给装备/道具写入自定义属性（set int/str + 装备位写法），并能读取验证。
• 能定位 FGUI 中物品/装备 Tips 包并修改文本控件，用 UBB/富文本语法实现彩色与换行。
• 掌握深层 table 的递归打印与取值，看懂官方装备数据结构层级。
• 具备"后端写属性 → 前端 Tips 显示"整链路的问题排查能力。
• ---

讲解要点与指令拆解

1. 服务端"装备穿在哪"由表配置：EQ POS 装备位置表定义各装备位（武器=0、衣服=1…）。
2. 加自定义装备位要选不与官方冲突的编号：官方预留约 0~13，自定义建议 201 及以上。
3. 装备行属性字段含义：职业列填 0 表示全职业通用；另需穿戴要求（等级）、外观池/极品等列。
4. 改表后必须导表并下发：服务端与客户端都要导/拉最新表，否则穿不上或前端不识别。
5. 客户端角色面板布局在 layout 的 PlayerInfo 文件，面板底图预挂了多个格子组件承载各部位 item。
6. 新增部位要在 FGUI 编辑器里补挂格子组件并设导出、F9 发布，否则代码"拿不到对象"。
7. 面板代码按装备位取数（无数据返回 nil 则跳过），再迭代 item show 刷新各格子。
8. 索引校准是本课难点：循环索引从 0 开始，格子编号、显示位置、服务端 pos 三套数字常差 1，映射表要逐个核对。
9. 改完组件必须 F9 发布并让客户端重新加载（缓存旧组件会致取不到/显示旧）。
10. 挂接点按组件层级定位，格子增多要注意层级遮挡。
11. 工具建议：国产 AI 写 Lua 易出废话与报错，复杂接口建议喂给更强的模型并用真实接口约束。

学完学员应掌握技能

• 会在服务端 EQ POS 表中新增不与官方冲突的自定义装备位，配置职业/属性/穿戴要求并正确导表下发。
• 会在 FGUI 角色面板组件中新增格子并发布，给新装备位提供 UI 挂点。
• 能读懂并修改角色面板刷新代码，把自定义装备数据显示到对应格子。
• 掌握装备"索引/组件号/服务端 pos"三套编号的对齐方法，能独立排查"穿上了但不显示/显示错位"。
• 理解"配表 → 导表 → 建 UI → 刷数据显示"的完整自定义装备开发流程。