Files
fruit-pop-googleplay/docs/orchard-gameplay.md
T

4.4 KiB
Raw Blame History

Fruit Pop 主游戏

运行与界面

  • Welcome 保持启动入口。两步游客认证成功后,获取同游客的独占存档权限,恢复本地游戏并加载 Orchard 场景;依赖就绪后 loading 收满并同步切入首屏。
  • Orchard 为独立 1080×1920 场景。主界面、5 列裁切窗口、动态数字、8 组弹窗和操作按钮均为已保存的独立节点;运行时更新已有节点,不创建整套 UI。
  • 正常状态按主参考图排版。自动状态使用与免费旋转相同结构的 AUTO SPINS/数字/LEFT 横幅,STOP 完成本局后停止。免费状态使用独立 CURRENT WIN/TOTAL WIN 区,锁下注和主按钮。
  • 所有新增切图、字体、图集和工程目录均重新命名;assets/orchard 下绑定 81 张切图,符号目录为 emblems,弹窗为 dialogs,字体为 typefaces。amber-numerals.fnt 内 page 指向 amber-glyph-atlas.png,包含 0–9、逗号、小数点。WIN、BET、累计金额和剩余次数使用该字体,钱包白字与英文保持参考样式。
  • 每日金币包含可领取与已领取美术状态、UTC 倒计时。帮助页由实际赔率表和赔付线数据生成,不使用整张参考图覆盖。

代码职责

  • SlotsMath:10 符号权重、20 条固定线、每线最优赔付、SCATTER 及免费列转换。
  • GameSession:下注、金币、每日赠币、免费阶段与结算快照;对外读取为深拷贝。
  • GameRepository:单 JSON 快照、校验与读回、旧版本冲突及同页重入保护。
  • OrchardRuntime:认证游客作用域、均匀加密随机、浏览器独占存档锁和场景预载。
  • AutoSpinQueue:尚未开始的普通局队列;不保存或恢复自动旋转。
  • OrchardView:输入、三态界面、动画时序及屏幕适配。
  • ReelPresentation:只展示已提交结果,离开裁切区后回收符号,中奖线与免费列提示。
  • OrchardDialogs:设置、自动配置、每日领取、余额不足、免费触发/结果、规则、错误恢复。
  • OrchardAuthoring/OrchardComposer:仅通过显式编辑开关批量排版,保存后节点可独立修改。

规则与存档

按根目录 fruit-pop-rules-v1.md 实现。初始 100,000 金币、默认总下注 2,000,普通旋转每局扣一次;结果、扣款、奖金和 pending 在同一快照提交。动画中刷新仅重放 pending,不重抽或重复派奖。

3/4/5 个及以上 SCATTER 分别奖励 8/12/16 次免费旋转。免费局沿用触发下注,每局均匀选择一列,将其中非 SCATTER 转 WILD,不再触发免费。累计只包含免费局奖金,结果窗不重复发钱。

每 UTC 日领取 20,000 一次,旧日期或倒退时钟不能再次领取同一/更早日期。真实权威校时和跨设备同步尚无服务协议,本版为本机金币存档。

真实浏览器入口先取得 Web Locks 独占权限,同游客其他文档不能同时写档。读取损坏或不确定保存会阻止继续并保留原档;确认提示后返回登录重新恢复,不重赠初始金币。需要支持 Web Locks 的安全浏览器环境,当前不支持原生运行。

验证

  • pnpm@11.17.0 安装,pnpm typecheck 通过,88 项测试通过。
  • 包含全部赔付线与普通符号的 3/4/5 连、WILD 最优/全 WILD、SCATTER、列转换、免费锁注、原子扣奖、pending 恢复、坏档/写失败/并发、UTC 日奖、自动队列、字体引用及保存场景契约。
  • 发布页真实两步认证进入主游戏,存档恢复保留领取后的余额;服务偶发超时可重试。
  • 自动 25 次启动显示剩余 24,STOP 完成本局后停止;每日领取 +20,000,重复点击无二次入账。
  • 内存隔离测试存档完整执行免费触发、8 局转换及结果确认,累计与余额增量一致,自动未恢复;未修改真实存档的概率或免费状态。
  • 540×960、390×844、390×640、844×390 检查主控件与常用弹窗边界均在可见区域内。
  • 同源独立文档共享存储时,已有独占锁使第二文档抢锁失败,存档未变。集成浏览器新顶层页面使用隔离存储,未将它误认为共享存档测试。
  • web-mobile 最终交付输出 build/web-mobile-orchard-delivery;发布时包含 Welcome 与 Orchard 两场景。

无音频素材,音乐和音效仅保存偏好,尚无实际音轨;震动按浏览器能力执行。未构建原生包或进行真机测试。规则中的理论 RTP 保持设计值,不代表本轮完成了正式数学认证。