项目详情
🃏小丑牌：命运反转
面向微信 / 抖音小游戏生态的轻社交纸牌项目骨架，Cocos Creator + 云函数串联命运卡循环与好友房。
Cocos Creator 3.x + TypeScript 将 Home / Room / Game / Result 场景与 GameManager / RoomManager 循环脚本搭好
命运卡、随机事件、i18n JSON 配置与 seed RNG，热更新内容即可调整节奏和文案
joinRoom/startGame/turnAction 示例云函数 + AdManager / ShareManager / Telemetry 平台层，打通好友房与广告分享链路
前端 UI云与发布
Cocos Creator 3.xTypeScriptNode.jsWeChat Cloud FunctionsDouyin Mini Game
项目简介
《小丑牌：命运反转》是我基于 docs 策划沉淀搭建的 Cocos Creator + 云函数脚手架，目标是让微信/抖音小游戏能快速落地命运卡社交玩法，直接导入 assets/ 即可继续接 SDK、素材与运营配置。
我的角色与贡献
- 整理 workspace/ 目录，固定 assets/scenes/prefabs/scripts 与 cloud/functions/schema 的结构，保证导入 Cocos Creator 即能运行
- 在 assets/scripts/core 中实现 GameManager、RoomManager、DeckSystem、FateSystem、EffectFactory，将抽牌、触发、回合推进、结算串联起来
- 提供 assets/config 下的 gameConfig.json、fateCards.json、randomEvents.json、i18n.zh-CN.json，并写进 docs/ 的策划表方便热更内容
- 抽象 platform/AdManager、ShareManager、Telemetry、Storage，封装微信/抖音平台差异的广告频控、分享截图、埋点能力
- 交付 cloud/functions (joinRoom/ready/startGame/turnAction/metrics) 与 schema JSON，包含内存 mock DB，方便迁移到云开发环境调试好友房
技术亮点
- 核心循环 TypeScript：GameManager 与 RoomManager 驱动牌堆、命运卡、战绩结算，同时导出 GameTypes 提供可选 UI 回调接口
- EffectFactory + FateSystem.apply 将命运卡效果表驱动成可扩展的命令树，便于在 UI/Buff 上挂接不同动画
- 平台适配层：AdManager/ShareManager/CloudClient/Telemetry 拆分广告、分享、云调用、埋点，所有 API 经由 Bridge.ts 做平台分支
- 可复现随机性：utils/Random.ts 提供 seed-based RNG，回放或联机调试时能复现整局命运卡顺序
- 云端最小集：joinRoom/turnAction 等函数共享 lib/db.js 的房间状态 mock，可直接粘贴到微信/抖音云函数并加上鉴权/锁控制
系统架构
客户端以 Cocos Creator 场景 (Home/Room/Game/Result) 驱动 core 系统，平台适配层封装广告/分享/云调用，再访问部署在云开发的房间/指标函数与集合。
架构图渲染中...
Cocos 场景驱动 core 系统，统一通过 Bridge 调用平台 SDK 与云函数，保障好友房与命运事件链路。
使用场景
- 小游戏立项阶段：导入脚手架即具备单局循环、命运卡逻辑与房间脚本，验证玩法可玩度
- 好友房 MVP：将 cloud/functions 迁入微信/抖音云开发，快速实现拉人对局、ready、turnAction 同步
- 运营实验：通过 fateCards/randomEvents/i18n JSON 热更内容，调节广告频次、事件掉率与节奏
项目价值
- 展示我在小游戏前端 + 云函数一体化交付的能力，既能搭建 Cocos 场景又能封装平台 SDK
- 完整交付文档 (DEV_GUIDE.md / DEVELOPMENT_PLAN.md) + checklist，方便团队承接并按周推进
- 配置驱动 + seed RNG 让内容与调试都可复现，利于审核、联机与长线运营扩展
项目成果
- Balatro Reversal of Fate MVP开发中
核心循环、配置、云函数与平台适配层已完成，正在接入真实 SDK、好友房部署与美术/音效资源。