仿复古版本开发

讲解要点与指令拆解

1. 界面搭建：底图 + 列表容器 + 文本组件搭"总排行榜"与"我的排名"两块，底图开九宫格，布局参考 0.618 比例。
2. 规则文案用富文本承载；排名数字讨论过字图集方案后改用脚本/数字组件控制。
3. 前端封装全局小函数：按钮点击 `onclick`、取输入框 `getInputString`、发消息 `toSendServer(消息ID,P1,P2,STR)`。
4. 后端用"全局字符串变量"累计捐赠：`data[玩家名]=原值+本次捐赠`（首次空则初始化为 0），用 table 转 JSON 序列化入全局存储。
5. 写变量带第三参时同步"推前端变量"，把榜单数据推给前端；前端开界面用 `getServerVR` 拉取。
6. 渲染：`pairs` 迭代，克隆模板行，`getChildByName` 取"名字/金额/属性"三个子组件赋值后 `ADD` 进列表。
7. 排序：键值对拷入新表用第二个值 `table.sort` 降序，解决"返回 string"等类型问题。
8. "我的排名"：遍历与玩家名比对，命中记名次与金额，未上榜走"未上榜"分支。
9. 属性奖励：按名次配置奖励表，用封装的 `setTextColor` 分名次上色（红/绿）。
10. 局部刷新：刷新榜单抽成独立函数传 UI，只重建列表容器内节点；期间排除了空值比较、`tonumber`、重复挂载 ID、延时刷新多个坑。

学完学员应掌握技能

• 能独立做出"NPC 打开 → 输入捐赠 → 后端累计存储 → 排行榜展示"的完整功能。
• 掌握"前端变量 + 全局字符串 + table 转 JSON"的跨端存取与推送刷新模式。
• 会用 `pairs` 迭代与 `table.sort` 把无序表渲染成有序排行榜。
• 会封装公共小函数、只刷新局部列表，并排查类型/空值/节点冲突问题。

讲解要点与指令拆解

1. 坐标系辨析：游戏坐标=后端/界面坐标；世界坐标=地图坐标、全图统一不随镜头变化（含 Z）；界面坐标=UI 组件位置。
2. 方案取舍：后端"地图放特效"接口只能放特效 ID，无法放装备，故改前端在世界坐标挂节点。
3. 取玩家 Actor 世界坐标 XY 验证（走一步差 48），世界坐标可用于定位与视觉类玩法。
4. 挂载套路：场景挂点下先建空节点容器，再挂图片/文本/特效；重载前 `GUI.removeChildren` 清理，避免"父节点已存在"。
5. 创建模型特效：EFF 模型类型 ID（玩家=4、武器=5、头发=7），配置位置、朝向 DIR（小键盘方向）、动作（0 待机/2 等）、播放速度。
6. 可点击雕像层：基础容器开启"可触摸 + 吞噬"防点击穿透，绑定点击事件开界面。
7. 还原本人外观：取当前武器/衣服/发型特效 ID 链路，名字用文本水平+垂直居中。
8. 申请与存储：点申请发后端，存 name/level，与现值比较等级更高才替换（含空值初始化防御），给出"已是第一"提示。
9. 触发创建：后端推送"天下第一"为前端变量，前端在切图/登录触发器读取并调创建函数；地图名做防御限制。
10. 同屏广播：申请成功后用视野内广播事件通知同屏玩家，前端收广播重新取数据刷新（去掉旧 data 传参）。

学完学员应掌握技能

• 能区分游戏/世界/界面三种坐标，会在世界坐标固定点挂图片、特效、文本。
• 掌握"场景挂点→空容器→子组件"层级与"重复创建先清理"规范，能复刻雕像玩法。
• 会封装取装备外观（武器/衣服/发型）特效 ID 接口，还原玩家本人模型。
• 掌握"全局变量+JSON+前端变量推送+切图触发"的状态保存与显示流程，理解服务端广播做同屏同步。

讲解要点与指令拆解

1. 数据准备：从老版本端提取图鉴表格资源，处理乱码后转 Lua 字典表（ID、索引、属性组、价格），前端直接引用。
2. 界面：九宫格底；左侧 16 个按钮"固定埋坑不用代码生成"；右侧 6 个格子+属性区+激活/一键提交，中上放页码与翻页。
3. NPC 接入：复制 NPC 模型脚本、UI 编号，加交互层防按钮点击穿透。
4. 左侧交互：`for` 批量绑 onclick，用 `buttonIndex` 记录选中；二次点击先还原上一按钮再高亮当前（红色）。
5. 封装 `BUTTONSTR(组件,文本[,color])` 填套装名，供初始化/翻页共用。
6. 分页：起始索引按 `16*(page-1)+i`，用总条数算页数边界，页码文本同步，翻页数据走缓存不重复遍历。
7. 右侧联动：按选中取数据，循环 6 格 `getChildByName` 取数量/名字组件，存在则 show+填充、不存在隐藏。
8. 提交：区分激活/一键提交两个按钮，点选把类型/索引发后端；后端直接取同屏 table（前后端共用，免序列化），只做位置判断（说明作弊风险）。
9. 后端存储、前端变量刷新、红点提示留给后续课。
10. 提效：AI 补嵌套结构/动画，强调"看得懂、改得快"，80-90% 工作量在前端。

学完学员应掌握技能

• 能把表格资源（CSV/老端数据）转成 Lua 配置表供前端使用。
• 掌握固定按钮批量绑定+选中高亮互斥、交互层防穿透的前端写法。
• 掌握按页码起止索引、翻页边界、共用刷新函数的分页列表写法。
• 能按选中动态刷新右侧详情实现左右两栏联动，理解"前端选数据→发消息→后端存共享表"直传模式。

讲解要点与指令拆解

1. 翻页默认选中：初始化把首按钮与首屏数据入缓存，进页面等效"点击第一项"刷新右侧。
2. 修翻页后右侧不刷新的问题：点左侧按钮同步刷新右侧 data，并把上页高亮恢复默认。
3. 红点：弃官方"红点表/绑定条件"（嫌麻烦），自建图片作红点。
4. 封装"检测背包物品显示红点"函数：按物品名查背包数量 `>0` 创建、否则移除。
5. 红点残留：进界面先 remove 清空挂点子节点再按需创建，移除/创建放同一函数。
6. 修空值：先判组件/索引存在再取 items，避免索引 nil。
7. 后端存储：一键提交发协议 → `check/takeItem` 扣物品 → 向图鉴表写"提交数量"（存数字便于多数量审核）。
8. 新增通用封装 `setVrTable/getVrTable`（服务端个人对象变量），强校验 table 类型，用 tableToJson/jsonToTable 序列化。
9. 表结构：两级菜单、首次空表按配置初始化主键，提交按索引 K 累加，提交后本地刷新防重复激活。

学完学员应掌握技能

• 能实现"分页列表默认选中 + 右侧详情初始化"标准 UI 流程。
• 掌握自制红点方案：先移除后创建、按背包数量动态挂/卸并封装成函数。
• 能写后端 table 变量存取通用接口，理解 table 不能直存必须 JSON 序列化的原因。
• 掌握图鉴类收集系统表结构（主键化、存数量）与扣物品-写入-刷新闭环。

讲解要点与指令拆解

1. 三种推送：①M2 全局变量前端推送（约每秒同步，改配置需重启）②自推：setVar 带第三参真即立刻发协议 ③发外部服务器、前端 HTTP GET（可跨服/便于做网站，有延时不适高频）。
2. table 必须 table→JSON→table 往返；注意 15000 字节传输上限，大数据可自做压缩序列化。
3. 自推实现：后端统一入口存值后把 name/value 写入"前端变量推送表"，整表迭代合并后 tableToJson 随协议发送。
4. 前端接收：注册协议（8001），jsonToTable 存前端全局 var 表避免被覆盖；等级变量实测"设置即秒收"。
5. 前端封装 `getVar(name)`：防御取值、自动识别 JSON 特征转回 table。
6. 时序：发送是毫秒级网络、本地执行微秒级，函数内发完立即取值拿不到，必须 `delay(0.5)` 再取。
7. 接入图鉴：提交后延时拉取，值>0 判定"已激活"（改红色文案、隐藏提交、清该位红点）。
8. 调试顺序坑：按钮缓存值必须先赋值再触发刷新，否则刷新用旧值。
9. 属性加载：pushEvent:add 暂不可用，改传统 QF 全局表"加载属性"，整套提交数都>0 才加属性组，用加减法接口叠加。
10. 属性配置抽到全局常量 config 大表复用；演示 GPT 把字符串拼接改表合并优化。

学完学员应掌握技能

• 能说清三种变量推送的原理/优缺点与选型，独立实现"后端 setVar 立即推前端"。
• 会写前端接收与 getVar 封装，理解"发送后需延时再取"的时序原因。
• 能把后端变量推送接入真实功能（刷新页面、激活态/红点切换）。
• 掌握传统"加载属性"流程：迭代收集数据→条件判断→按配置叠加属性。

讲解要点与指令拆解

1. 工程整理：独立版本 QF 只做加载，框架核心/玩家构造/常量统一 require，建临时文件验证加载。
2. UI：GUI 工具建任务栏面板（三模块布局）与任务界面，GUI 挂点找节点（如 110）插入，做可复用模板。
3. 交互/常量：按钮在初始化被注册进 G button 库可直接 GButton:onClick；用大写常量表管理协议号与 UI 位置避免硬编码。
4. 后端协议：服务端扫描目录自动加载 Lua 协议文件；801 开界面可前端直开，操作走独立协议。
5. 击杀推进：攻击触发 QF，用 event:add 把任务模块注册进表主键方法分发；击杀 push 怪物名/地图，名字匹配计数+1。
6. 任务数据：登录初始化变量；击杀后 setVrTable 存、8002 推前端；前端逐个 setVal 刷新任务名/进度，进度 math.min 封顶。
7. 领取流转：校验完成度与已领取标记，发奖励、置位、任务 ID+1 并清零进度、延时刷新进下一环；未解锁按钮禁用置灰。
8. 调试"前端数值落后"：前端读本地缓存旧值，需重载/初始化后重新下发；存储、推送、接收用同一变量名与同一 data 结构；先保存再刷新。
9. 开发方法：UI 截图+节点命名交给 AI 生成前后端代码（"中式英语"命名利于 AI 理解），讲师讲解封装与纠错。
10. 作业：仿做界面不同、奖励改为"发邮件"的任务系统。

学完学员应掌握技能

• 能独立重构一套不依赖官方配表的任务系统（页面、挂载、点击、后端协议全流程）。
• 掌握二级封装：启动统一加载、event:add 分发、GButton 复用、常量表管理协议与 UI 位置。
• 理解并会排查"前后端变量不一致"（缓存旧值/变量名不统一/顺序错），写出存储-推送-接收-刷新闭环。
• 能借助 AI 生成并自查脚本，知道清晰节点命名让 AI 产出可用代码。
• 掌握任务状态机最小实现：进行中→可领取→已领取→下一环，含禁用/进度封顶交互。

讲解要点与指令拆解

1. 界面：复古底图+按钮+列表排武器/项链/衣服/手饰四部位，空位加背景，下方三条属性文本+三复选框+洗练按钮（标 100 元宝/100 声望）。
2. 部位单选：保存当前按钮索引，点击先恢复上一按钮颜色再高亮当前。
3. 装备位刷新：按部位返回唯一 ID 再更新装备框（新三端接口），点击回调传 UI+部位调刷新。
4. 复选框互斥：遍历组件监听选中，选一个把其余 set false；封装 get checkbox 返回被勾选项确定"锁定位置"。
5. 前端发包：两按钮 onclick server send，P2=部位、P3=货币类型(1元宝/2声望)，未选部位弹 Tips。
6. 后端校验取装备：money 映射校验（其他值直接封号）；item link 按位置取装备对象。
7. 随机与概率：属性表改共享配置（前后端共用），沉淀"随机取键值"与"档位概率"(1\~10，档越高概率越低)；适配引擎版本差异替换失效随机接口。
8. 属性写入：追加属性用 ADD/属性组而非 "="（等号会整体替换）；属性组内部按 pairs 迭代，故配置改"大表套顺序小表"保持顺序。
9. 持久化：勾选锁定后随机只刷新未锁定项，用物品变量 set/get（int/string/table 经 JSON）保存 {attId,value}，下次不覆盖锁定。
10. 显示同步：装备数据更新有延时与 pairs 无序问题，改固定顺序结构迭代 V\[1]/V\[2]，必要时删建装备位刷新显示。

学完学员应掌握技能

• 能独立搭建鉴定/洗练界面，实现部位单选与复选框互斥。
• 能完成"发包→按部位取装备→随机洗练→写回与持久化"完整闭环。
• 掌握把属性表/随机与档位概率沉淀为共享配置与常用函数，排查引擎版本接口差异。
• 理解 pairs 无序对属性组顺序影响，会用固定顺序表结构保证前后端一致。
• 能用装备变量（JSON 编解码）保存复杂数据（锁定属性）。

讲解要点与指令拆解

1. 存储选型：个人/全局变量占内存有上限，只适合小数据；数据库/本地文件耗服务端资源；持续大日志走自有服务器 POST。
2. 协议机制：996 服务器单线程且关掉服务端 GET（防阻塞），服务端只有 POST；客户端 POST/GET 都有。
3. 发起方取舍：服务器发起占带宽但可信（带私有 key、防抓包），适充值等高价值日志；客户端可高并发但可被篡改，只用于排行榜等非关键数据。
4. 环境与代码：自购服务器装 Linux/宝塔/数据库/PHP，后端页面全部交 AI 生成直接套用。
5. 上报：POST 附带自定义 key，业务数据 table to json 发给 PHP 写库。
6. 联调排错顺序：key → 网址(先 http 通) → 数据库与日志 → 参数解析（参一/参二不匹配）。
7. 版本适配："get player diff" 报错是老三端接口，新三端需工具服接口。
8. 客户端 GET：前端测试函数重载取数，服务器按 CDK 校验返回 JSON，前端 json to table dump 校验。
9. 返回结构：让 AI 补齐 PHP，返回玩家表/充值金额/返利/分成比例等键值便于前端出界面。
10. 衔接：点 NPC 开界面时调接口，用进度条掩盖通信延时。

学完学员应掌握技能

• 能判断日志/数据该存变量、数据库还是自有服务器 POST 上报。
• 能区分服务端 POST 与客户端 POST/GET 的场景（可信度/并发/防篡改）。
• 能借 AI 搭 PHP 接口，实现数据上报入库与按条件查询返回。
• 能写前端 GET 并把 JSON 转 Lua 表用于界面展示，掌握联调排错方法。

讲解要点与指令拆解

1. 界面：NPC（综合服务员）+客户端 UI，左侧功能按钮、右侧按按钮切换容器页；UI 图取官方缓存，底层补背景做层次。
2. 接口设计：背包模块只收"容器、每行列数、物品列表、单选/多选开关"，职责单一，滑块单独封装。
3. 数据结构：先区分老三端源变量与新三端挂接口，dump 确认：主键=物品唯一 ID，数量用 has number。
4. 行列计算：行数=数量/列数向上取整(math.ceil)；"先建行容器、行内横铺列"二级挂载做规整网格。
5. 换行坐标：基础坐标+余数×间距在余 0（第5/10个）会重叠丢格，最终放弃逐格坐标改"行容器+列表间隔"。
6. 滚动联动：横向滑块旋转 90° 当纵向用，注册列表滚动事件把百分比写滑块实现双向联动。
7. 铺物品点选：按真实数据逐个创建（ID 递增防重复），挂"物品栏点击事件"实现对号/再点取消，选中表+唯一 ID 存储返回。
8. 发送与预算：勾选表 JSON 后 server send(message id 1)；按每物品约 41B、上限 12000-15000B 估，约可点选 300 个物品。
9. 后端删除：json 解码迭代勾选表，按唯一 ID 逐个删除（老三端 ACTR）。
10. 事件刷新：开界面注册"背包增删改"脚本事件回调刷新，关闭注销（标识防重复）；刷新只清列表容器子节点并防重复创建。

学完学员应掌握技能

• 能写出可复用背包/格子创建接口：传容器+行列+数据自动铺网格。
• 掌握列表容器二级挂载排版与滚动滑块联动写法。
• 能实现背包物品点选多选并封装发后端。
• 能借物品增删改事件与注销实现界面自动刷新并防重复创建。
• 理解消息字节上限，能估算单次可传输物品数。

讲解要点与指令拆解

1. 界面重做：参考 GUI 临时目录策划版型与中文映射表，嵌套基础容器组织层级，字号颜色统一。
2. 页面分发：按钮点击回调中 show/隐藏切换子页面，多页并存互不影响。
3. 放入框：设监听事件，放入记录物品唯一 ID（make\_id），立即刷新名字/品级/次数区域。
4. 品级判定：对比等级控/货币控/颜色控后选颜色控，用 255/251/215/249/69 映射五品级，再查配置表得鉴定次数 5/4/3/2/1（补拷配置进工程）。
5. 点击鉴定：唯一 ID 经按钮消息发后端（1号/110 协议），后端 `not money:check` 防御提示→扣 100 元宝→按配置生成词条→set 变量更新装备并推送。
6. 词条展示：刷新装备信息抽独立函数（传 UI 与 item，含 \~0.3s 延迟），无词条回退"暂无词条"。
7. 防误触：底层补"基础容器"背景层开触摸交互；放入框先清空再放入防误放。
8. 属性清洗：2号/1102 协议，扣 200 元宝校验，取自定义属性串把"#后数字全部置0"，删除/重设属性并刷新。
9. 排障习惯：打印/dump 区分空值、数字与字符串、协议号与配对结构；注意"发送 0.3s 延迟后重取放入框数据"。
10. 复用：刷新/清空/推送逻辑写进对象封装或独立函数，避免按钮处重复。

学完学员应掌握技能

• 能独立用 GUI 搭多分页、容器层级、放入框的 NPC 界面，实现按钮切页与放入监听。
• 掌握"颜色控值+配置表"做品级/鉴定次数映射，理解唯一 ID 在前后端消息中的作用。
• 能完成装备鉴定与属性清洗完整闭环（扣费防御、生成词条、属性清零、推送刷新）。
• 掌握点击穿透（背景层+触摸）、空值/类型/协议号打印定位、公共刷新封装等排障套路。

讲解要点与指令拆解

1. 代码复盘：按消息号（8002）反查前端任务 UI，从后端 QF 找登录/击杀触发，把杀怪计数复制为登录触发。
2. 修复"登录后不下发"：刚登录前端未加载完消息丢失，登录流程加 300ms\~1s 延时再推送。
3. 需求确认：悬赏=每 30 分钟刷新一轮、提交指定物品完成；晋级称号是另一入口，背包区只做查看。
4. 后端定时：挂 30 分钟定时器触发，物品一维数组随机取，连同 os time 存全局表；测试期改 5/60 秒验证。
5. 推送策略：打包 {物品名,time} json 经 8003 推前端；前端登录读全局变量并挂"服务器变量改变"事件自动刷新。
6. 三入口分开：击杀计数/初始化/登录补发拆独立分支，登录补发后再取全局数据下发，避免初始化条件不满足漏发。
7. 重复加载冲突：两个子任务节点 ID 冲突改名唯一，用"移除指定节点下内容"精确刷新。
8. 倒计时：剩余=刷新周期−(当前 os time−服务器下发时间)，调倒计时时间接口带回调，结束触发整界面刷新。
9. 界面重做：复古缓存小图重绘，含本轮需提交物品（红字）、剩余时间、背包列表容器、提交与奖励列表。
10. 配置化：所需物品写配置常量（改动只改配置不改代码），统一 8001/8002/8003 协议号对齐。

学完学员应掌握技能

• 能按协议号与触发点从旧工程反查并复用自己写过的代码，快速定位功能落点。
• 掌握"定时器刷新+全局表"承载玩法数据的服务端写法，理解登录/刷新/击杀多入口的下发时机。
• 掌握前端"监控服务器变量改变"代替全服推送，理解登录加载延时等时序成因。
• 会通过唯一节点命名与定向移除解决 UI 重复加载冲突，并做倒计时与配置表抽取。