20 lines
2.6 KiB
Markdown
20 lines
2.6 KiB
Markdown
# Coin Madness 前端模拟版
|
||
|
||
> 2026-09-20：已增加真实接口路径，以下为历史模拟版说明。现在仅编辑器预览使用模拟数据；微信开发／体验版连接测试服，正式版连接现有正式服，入口由后端活动状态控制。正式规则、恢复流程和验收见 [GoldMiner接入说明.md](GoldMiner接入说明.md)。
|
||
|
||
入口挂在首页，编辑器预览及微信开发/体验版显示，正式版不展示模拟活动。打开后加载 `coin_madness` Asset Bundle，关闭销毁节点并在绘制帧后 releaseAll/removeBundle；加载途中离开也清理迟到资源。平台磁盘缓存和已注册脚本不承诺被物理删除。
|
||
|
||
界面、阶段规则与模拟接口均在新 Bundle 内。常驻部分只有入口/生命周期桥接和轻量本地通关计数；旧业务仅增加 JiaZai 挂载和 GameTool 主线胜利通知，没有改登录、支付上传或后端业务。关闭时无需保留活动 UI 资源，购买后真实主线通关仍可累计模拟进度。
|
||
|
||
模拟数据按 uid 本地隔离，独立测试余额，不扣款、不增加真实金币、不修改真实关卡。提供购买、通关、领取、到期补发、重置和下一次接口失败按钮，点击底部联调提示展开工具。
|
||
|
||
界面现为完整预制体 `assets/coin_madness/prefab/CoinMadness.prefab`。在 Creator 中双击即可编辑 Card 下的背景、标题、时间、购买区、任务列表与按钮。图片及 SpriteFrame 子资源都位于分包的 texture 下；主程序只按需加载预制体，其依赖由引擎加载，不再额外预加载整个图片目录。
|
||
|
||
`CoinMadnessPanel.ts` 只绑定数据、切换节点状态及处理交互；`CoinMadnessDigits.ts` 替换预制体已有数字槽位的图片，不创建数字节点。预制体预设五行，配置超过五行时复制第一行模板并刷新数据。已有行刷新不销毁、不重建。正式活动参数仍待策划定稿。
|
||
|
||
日常布局以 Creator 内的预制体为准；一次性历史布局生成器已移除。
|
||
|
||
测试：`node tools/coin-madness/check-api.cjs`；`node tools/coin-madness/check-types.cjs`。Cocos 实机组件夹具：运行 `node tools/coin-madness/preview.cjs`，访问 `http://127.0.0.1:8765/?open=1`；安装 Playwright 后运行 `check-preview.cjs`。预览夹具需要本地 Cocos Creator 2.4.15 和项目已导入的内置资源。
|
||
|
||
未来将 Bundle 内模拟请求替换为真实接口适配，并移除模拟入口控制台及本地计数，按《CoinMadness后端接口需求》接入现有支付、结算和权威钱包；本轮不实施该部分。
|