下载 App
生成正面、背面、侧面,可以走动的角色形象
当前 NPC 角色编辑器的数据结构
编辑器使用 32×32 像素画布,数据结构大致是:
3 个朝向:正面、背面、侧面
2 个动画状态:静止(idle)、行走(walk)
每个状态可以有多帧,支持帧率控制
每帧本质上是一个 32×32 的颜色数组
要解决的 3 个问题
步骤 问题 方案
1. 图片→编辑器 128×128 PNG 导入为 32×32 像素数据 加载图片后逐像素采样(每4×4取1像素)

耳内有灰:
对话框和列表都正常了。但有两个问题:导入了 0 个像素 — 日志显示 (128.0x128.0 -> 32x32) 但 导入完成: 0 个像素KTX 格式错误 — Unsupported texture format in KTX file,说明 cache:GetResource("Image", ...) 加载了 GPU 压缩格式,GetPixel 无法正确读取需要改用 Image() 直接加载文件来读取原始像素数据。Image 有 IsCompressed() 方法。问题是 cache:GetResource("Image", ...) 可能自动加载了 KTX 压缩格式。需要用 Image:new() 创建并手动从文件加载,绕过缓存的压缩格式。我可以用 cache:GetFile() 获取文件,然后用 Image:new() 创建 Image 对象并从文件 load。Bot Avatar现在修改 CharData:ImportFromImage,改用 Image:new() + cache:GetFile() 加载原始 PNG 数据。构建成功。修复方案:改用 cache:GetFile() + Image:new() + image:Load(file) 加载原始 PNG 数据绕过 cache:GetResource("Image") 可能返回的 KTX GPU 压缩格式加了 IsCompressed() 检查作为额外保险可以预览测试——再次点击「导入」选择一张图片,应该能看到像素被正确导入到画布上了。
留言墙牌匾设计
1. 列表项跳转 + 返回定位
VirtualList 本身只渲染可见行,点击跳转到砖块详情不会有性能问题。返回定位的方案:
牌匾弹窗(VirtualList,记住 scrollOffset)
↓ 点击某条留言
砖块详情弹窗(showBrickViewModal)
↓ 关闭
牌匾弹窗(恢复之前的 scrollOffset)
实现方式:打开砖块详情前,记录当前 VirtualList 的 scr

:
问题原因:拆除屋檐/柱子时调用的是旧版全局方法 mapData:UninstallRoof(),它只检查已弃用的 self.roofInstalled 全局字段。而实际屋檐数据存储在 wallParts[wk].roofInstalled 中。修复:从 piece.data.wallKey 解析出 anchorRow, anchorCol,改为调用 mapData:UninstallWallParts(row, col),这个方法会正确清除对应墙段的 pillarsInstalled 和 roofInstalled。
:
分析两个核心 bug:Bug 1 - 加载界面不显示:beginPreloading() 的"快速路径"调用 PreloadOne() 时,实际执行了加载(不是仅检查缓存),所以 15 个纹理全部同步加载完,allCached=true,直接跳到 setupGameUI(),跳过了加载界面。Bug 2 - 预加载无效,地图仍然渐进加载:预加载用的 NVG 上下文来自 ImageCache.GetContext(),但当 MapCanvas:Render(nvg) 被调用时,它传入的 nvg 参数再次调用 TerrainRegistry.SetNVG(nvg) — 如果这两个 nvg 的 Lua userdata 身份不同(即使指向同一个底层对象),nvg_ ~= nvg 判断为 true,整个 texCache_ 被清空!解决方案:移除快速路径,添加一个仅检查缓存的方法(不加载)不在 beginPreloading 中设置 NVG 上下文,而是让预加载在 HandleUpdate 中进行,并确保使用的 NVG 上下文与 MapCanvas 后续使用的完全相同但根本问题是:我们无法保证 ImageCache.GetContext() 返回的 userdata 与 Widget Render(nvg) 回调中的 nvg 是同一个 Lua 对象引用。让我先验证这一点。
:
构建成功。完整流程总结:保存并同步到游戏选角的完整流程步骤 操作 背后发生了什么1 编辑器里修改角色 画布上编辑像素2 点击 “保存” CharStorage.Save() → 写入 characters/{id}.json3 点击 “<- 返回” 回到游戏 进入主界面4 角色选择弹窗自动弹出 buildRoster() 扫描 characters/*.json,你的角色出现在列表最前面,带缩略图5 选角色 → 点"进入游戏" loadCharData() 从 sandbox 读取你修改后的角色数据两种场景都已覆盖全新自建角色:编辑器新建 → 保存 → 游戏选角弹窗自动出现(带动态生成的缩略图)导入并修改内置角色(如"爸爸"):导入 → 修改 → 保存 → 游戏中选"爸爸"时会优先加载你修改后的版本(sandbox 优先于 assets)不需要任何额外操作,编辑器的"保存"就是唯一入口。
:
改动清单CollisionMap.lua:构造函数新增 self.wallStrips = {} 数组Rebuild() 步骤 4 从网格阻挡改为门槛条:遍历 GetWallGroups() 按砖块跨度计算宽度,有柱子时加 PILLAR_VIS_W新增 RebuildWallStrips() 方法(增量更新,添砖/装柱后调用)IsAreaBlocked() 新增段落 C 检测 wallStrips_IsInAnyStrip() 新增 wallStrips 循环(防 Q/E 旋转卡住)删除旧的 MarkWallBlocked() 方法main.lua:3 处 MarkWallBlocked() 调用全部替换为 RebuildWallStrips()MapCanvas.lua:新增绿色调试可视化,渲染留言墙门槛条(与建筑的蓝色区分)宽度计算逻辑halfW = (maxBX - minBX + 1) * 16 / 2如果 pillarsInstalled: halfW += 48 * 0.32 (≈15.36)1 砖 → halfW=83 砖 → halfW=246 砖 → halfW=486 砖+柱子 → halfW≈63可以预览看看绿色门槛条的位置是否和砖墙对齐。




