diff --git a/开发交接文档.md b/开发交接文档.md new file mode 100644 index 0000000..284fc71 --- /dev/null +++ b/开发交接文档.md @@ -0,0 +1,388 @@ +# 📋 剪刀石头布跑酷 - 开发交接文档 + +**版本：** v0.6（纯广告变现版） +**日期：** 2026-04-05 +**适用对象：** 程序开发团队 + +--- + +## 🎯 一、核心玩法配置 + +### 1.1 基础数值配置 + +```yaml +# 核心战斗配置 +combat: + base_distance: + win: 10 # 胜利前进距离 (米) + draw: 3 # 平局前进距离 (米) + lose: 0 # 失败前进距离 (米) + + combo_bonus: + - threshold: 1 + multiplier: 1.0 + effect: none + - threshold: 3 + multiplier: 1.2 + effect: blue_flame + - threshold: 5 + multiplier: 1.5 + effect: purple_flame + - threshold: 10 + multiplier: 2.0 + effect: gold_flame + - threshold: 15 + multiplier: 2.5 + effect: red_flame + - threshold: 20 + multiplier: 3.0 + effect: rainbow + + sports_coefficients: + track: { coefficient: 1.0, difficulty: normal } + swimming: { coefficient: 1.1, difficulty: easy } + basketball: { coefficient: 1.2, difficulty: medium } + football: { coefficient: 1.3, difficulty: medium } + tennis: { coefficient: 1.4, difficulty: hard } + boxing: { coefficient: 1.5, difficulty: hard } + gymnastics: { coefficient: 1.6, difficulty: expert } +``` + +### 1.2 游戏流程时序 + +``` +单轮流程（总时长 4.5-5.5 秒）： +┌─────────────────────────────────────────────────────────┐ +│ 准备阶段 (0.5s) → 出拳阶段 (1.0-1.5s) → 判定阶段 (0.3s) │ +│ ↓ │ +│ 表现阶段 (1.5-2.5s) → 前进阶段 (0.5s) → 循环继续 │ +└─────────────────────────────────────────────────────────┘ + +单局流程（10-20 轮，总时长 1-3 分钟）： +准备 → 第 1 轮 → 第 2 轮 → ... → 第 N 轮 → 结算 +``` + +--- + +## 🏃 二、关卡配置 + +### 2.1 关卡结构 + +| 章节 | 关卡数 | 编号 | 主题 | 解锁条件 | +|------|--------|------|------|----------| +| 教学关 | 5 关 | 1-5 | 新手引导 | 初始 | +| 短跑赛道 | 10 关 | 6-15 | 直道竞速 | 通关 1-5 | +| 跳高赛道 | 10 关 | 16-25 | 障碍跨越 | 通关 6-15 | +| 跳远赛道 | 10 关 | 26-35 | 沟壑跨越 | 通关 16-25 | +| 投掷赛道 | 8 关 | 36-43 | 铅球/铁饼 | 通关 26-35 | +| 水上赛道 | 7 关 | 44-50 | 跳水 + 游泳 | 通关 36-43 | +| BOSS 关 | 5 关 | 51-55 | 特殊挑战 | 通关 44-50 | + +### 2.2 教学关详细配置 + +| 关卡 | 长度 (m) | RPS 次数 | 教学目标 | 三星条件 | 奖励 | +|------|----------|----------|----------|----------|------| +| 1-1 | 50 | 3 | 移动 + 出拳基础 | 30 秒内完成 | 100 金币 | +| 1-2 | 80 | 5 | 胜利前进机制 | 全胜通过 | 150 金币 | +| 1-3 | 100 | 7 | 平局原地机制 | 平局≤2 次 | 200 金币 | +| 1-4 | 120 | 8 | 失败后退机制 | 失败≤1 次 | 250 金币 | +| 1-5 | 150 | 10 | 综合运用 | 45 秒内完成 | 300 金币 | + +### 2.3 BOSS 配置 + +| BOSS | 关卡 | 血量 | 长度 | RPS 次数 | 阶段数 | 奖励 | +|------|------|------|------|----------|--------|------| +| 速度魔王 | 51 | 3000 | 800m | 50 | 3 | 3000 金币 + 皮肤 | +| 跳跃恶魔 | 52 | 3600 | 900m | 60 | 3 | 4000 金币 + 特效 | +| 投掷巨人 | 53 | 4000 | 1000m | 70 | 4 | 5000 金币 + 道具 | +| 水神挑战 | 54 | 4800 | 1100m | 80 | 4 | 6000 金币 + 称号 | +| 终极冠军 | 55 | 5000 | 1200m | 100 | 5 | 10000 金币 + 奖杯 | + +--- + +## 📊 三、成长系统配置 + +### 3.1 等级经验曲线 + +```javascript +// 升级经验公式 +function getExpForLevel(level) { + return Math.floor(100 * Math.pow(level, 1.5)); +} + +// 关键等级解锁 +const keyLevels = { + 5: { unlock: "跳高项目" }, + 10: { unlock: "铁饼项目", feature: "排位赛" }, + 15: { unlock: "跳水项目" }, + 20: { unlock: "游泳项目" }, + 25: { unlock: "跨栏项目" }, + 30: { unlock: "标枪项目", feature: "自定义房间" }, + 50: { feature: "教练系统" }, + 100: { feature: "名人堂" } +}; +``` + +### 3.2 段位系统 + +```javascript +const rankSystem = { + bronze: { range: [1000, 1199], coefficient: 0.8, target: 0.20 }, + silver: { range: [1200, 1399], coefficient: 0.9, target: 0.25 }, + gold: { range: [1400, 1599], coefficient: 1.0, target: 0.25 }, + platinum: { range: [1600, 1799], coefficient: 1.1, target: 0.15 }, + diamond: { range: [1800, 1999], coefficient: 1.2, target: 0.10 }, + master: { range: [2000, 2199], coefficient: 1.3, target: 0.04 }, + king: { range: [2200, 99999], coefficient: 1.5, target: 0.01 } +}; + +// 积分计算 +function calculateRankPoints(win, currentRank, opponentRank) { + const baseWin = 20; + const baseLose = 15; + const coefficient = rankSystem[currentRank].coefficient; + + if (win) { + return baseWin * coefficient * (1 + streakBonus); + } else { + return baseLose * coefficient * (1 - streakReduction); + } +} +``` + +--- + +## 💰 四、金币系统配置 + +### 4.1 金币产出 + +```yaml +gold_income: + match_win: 50 + match_lose: 20 + daily_quest: 100 + weekly_quest: 500 + event_reward: 200 + daily_checkin: 50 + ad_reward: + - type: "double_gold" + amount: 100 + - type: "free_gacha" + amount: 50 +``` + +### 4.2 金币消耗 + +```yaml +gold_consumption: + skin_common: [500, 2000] + skin_rare: [3000, 5000] + skin_legendary: [8000, 12000] + emote: [500, 1500] + avatar_frame: [1000, 3000] + trail_effect: [2000, 5000] + gacha_ticket: 500 + gacha_ticket_10x: 4500 +``` + +### 4.3 经济平衡 + +| 玩家类型 | 月产出 | 月消耗 | 结余 | +|----------|--------|--------|------| +| 免费玩家（不看广告） | 15,000 | 10,000 | +5,000 | +| 活跃玩家（适度广告） | 20,000 | 15,000 | +5,000 | +| 重度玩家（大量广告） | 25,000 | 20,000 | +5,000 | + +**设计原则：** 所有物品均可通过金币购买，看广告加速获取 + +--- + +## 📈 五、广告系统配置 + +### 5.1 广告场景配置 + +```yaml +ad_config: + rewarded_video: + - scene: "double_gold" + trigger: "match_end" + reward: "gold × 2" + limit: 1 per match + eCPM: 30-50 + - scene: "revive" + trigger: "match_fail" + reward: "continue_match" + limit: 1 per level + eCPM: 40-60 + - scene: "checkin_double" + trigger: "daily_checkin" + reward: "checkin × 2" + limit: 1 per day + eCPM: 30-45 + - scene: "free_gacha" + trigger: "gacha_shop" + reward: "1_gacha_ticket" + limit: 5 per day + eCPM: 20-35 + + interstitial: + - scene: "level_end" + trigger: "level_complete" + frequency: 1 per 3 levels + eCPM: 15-25 + - scene: "shop_exit" + trigger: "leave_shop" + frequency: 1 per 5 min + eCPM: 12-20 + + banner: + - scene: "lobby_bottom" + position: "bottom" + always_show: true + eCPM: 3-5 + - scene: "shop_bottom" + position: "bottom" + always_show: true + eCPM: 3-5 +``` + +### 5.2 广告频率控制 + +```javascript +const adLimits = { + rewarded_video: { + daily: 50, + hourly: 10, + per_match: 1 + }, + interstitial: { + daily: 10, + min_interval: 180, // seconds + per_match: 1 + }, + banner: { + always_on: true + } +}; + +// 新手保护 +const newbieProtection = { + levels_1_5: { ads: false }, + levels_6_20: { ads: "banner_only" }, + levels_21_50: { ads: "rewarded + banner" }, + levels_51_plus: { ads: "all" } +}; +``` + +--- + +## 🎮 六、UI/UX 规范 + +### 6.1 核心界面布局 + +``` +大厅页： +┌─────────────────────────────────────────┐ +│ [头像] 玩家名 Lv.25 💰5680 │ +├─────────────────────────────────────────┤ +│ │ +│ 🏃 快速开始 │ +│ │ +│ ┌──────┐ ┌──────┐ ┌──────┐ │ +│ │ 对战 │ │ 关卡 │ │ 活动 │ │ +│ └──────┘ └──────┘ └──────┘ │ +│ │ +├─────────────────────────────────────────┤ +│ 👥好友 🛒商城 📋任务 🏅成就 ⚙️设置 │ +├─────────────────────────────────────────┤ +│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │ ← 横幅广告 +│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │ +└─────────────────────────────────────────┘ +``` + +### 6.2 出拳界面 + +``` +┌─────────────────────────────────────────┐ +│ 对手信息 │ +│ [头像] [名字] [段位] │ +├─────────────────────────────────────────┤ +│ │ +│ 赛道展示区 │ +│ │ +│ [玩家]═══════════>[对手] │ +│ │ +├─────────────────────────────────────────┤ +│ 倒计时：3 2 1 │ +│ │ +│ ┌──────┐ ┌──────┐ ┌──────┐ │ +│ │ 剪刀 │ │ 石头 │ │ 布 │ │ +│ │ ✌️ │ │ ✊ │ │ ✋ │ │ +│ └──────┘ └──────┘ └──────┘ │ +│ │ +└─────────────────────────────────────────┘ +``` + +--- + +## 📝 七、开发优先级清单 + +### P0 - 核心功能（必须完成） + +- [ ] 剪刀石头布核心逻辑 +- [ ] 胜负判定与前进 +- [ ] 连击系统 +- [ ] 教学关 5 关 +- [ ] 短跑赛道 5 关（6-10） +- [ ] 激励视频接入（双倍金币） +- [ ] 插屏广告接入（关卡结束） +- [ ] 金币系统 + +### P1 - 重要功能（首版本建议完成） + +- [ ] 短跑赛道完整（11-15） +- [ ] 跳高赛道（16-25） +- [ ] 三星评价系统 +- [ ] 段位系统 +- [ ] 每日任务系统 +- [ ] 签到系统 +- [ ] 更多广告场景 + +### P2 - 后续更新 + +- [ ] 跳远赛道（26-35） +- [ ] 投掷赛道（36-43） +- [ ] 水上赛道（44-50） +- [ ] BOSS 战（51-55） +- [ ] 无尽模式 +- [ ] 排行榜 +- [ ] 1v1 对战 + +--- + +## 📊 八、完整配置表 + +详细配置表请参考以下文档： + +| 配置 | 文档位置 | +|------|----------| +| 核心战斗数值 | `docs/05-数值设计.md` 第一章 | +| 关卡详细设计 | `docs/04-关卡设计.md` 第二章 | +| 成长系统 | `docs/05-数值设计.md` 第二章 | +| 金币系统 | `docs/08-广告变现设计.md` 第八章 | +| 广告系统 | `docs/08-广告变现设计.md` 第一 - 五章 | +| UI/UX 规范 | `docs/06-UIUX 设计.md` | + +--- + +## 📞 九、问题反馈 + +如有任何配置疑问，请查阅： + +1. **整合策划案** - `docs/整合策划案_v0.6.md` +2. **飞书多维表格** - https://basegames.feishu.cn/base/Joc4bhUqEa6wJdsmevFc9YVhnH0 +3. **专项文档** - 见上表 + +--- + +*文档版本：v1.0 | 最后更新：2026-04-05*