377 lines
14 KiB
YAML
377 lines
14 KiB
YAML
# <!-- Powered by BMAD™ Core -->
|
|
template:
|
|
id: wechat-gdd-template-v1
|
|
name: WeChat Game Design Document (GDD)
|
|
version: 1.0
|
|
output:
|
|
format: markdown
|
|
filename: "docs/{{game_name}}-game-design-document.md"
|
|
title: "{{game_title}} Game Design Document (GDD)"
|
|
|
|
workflow:
|
|
mode: interactive
|
|
|
|
sections:
|
|
- id: initial-setup
|
|
instruction: |
|
|
This template creates a comprehensive Game Design Document that will serve as the foundation for all game development work. The GDD should be detailed enough that developers can create user stories and epics from it. Focus on gameplay systems, mechanics, and technical requirements that can be broken down into implementable features.
|
|
|
|
If available, review any provided documents or ask if any are optionally available: Project Brief, Market Research, Competitive Analysis
|
|
|
|
- id: executive-summary
|
|
title: Executive Summary
|
|
instruction: Create a compelling overview that captures the essence of the game. Present this section first and get user feedback before proceeding.
|
|
sections:
|
|
- id: core-concept
|
|
title: Core Concept
|
|
instruction: 2-3 sentences that clearly describe what the game is and why players will love it
|
|
- id: target-audience
|
|
title: Target Audience
|
|
instruction: Define the primary and secondary audience with demographics and gaming preferences
|
|
template: |
|
|
**Primary:** {{age_range}}, {{player_type}}, {{platform_preference}}
|
|
**Secondary:** {{secondary_audience}}
|
|
- id: platform-technical
|
|
title: Platform & Technical Requirements
|
|
instruction: Based on the technical preferences or user input, define the target platforms
|
|
template: |
|
|
**Primary Platform:** WeChat Mini-Game
|
|
**Engine:** WeChat Mini-Game Runtime
|
|
**Performance Target:** Smooth performance on {{minimum_device}}
|
|
- id: unique-selling-points
|
|
title: Unique Selling Points
|
|
instruction: List 3-5 key features that differentiate this game from competitors
|
|
type: numbered-list
|
|
template: "{{usp}}"
|
|
|
|
- id: core-gameplay
|
|
title: Core Gameplay
|
|
instruction: This section defines the fundamental game mechanics. After presenting each subsection, apply `tasks#advanced-elicitation` protocol to ensure completeness.
|
|
sections:
|
|
- id: game-pillars
|
|
title: Game Pillars
|
|
instruction: Define 3-5 core pillars that guide all design decisions. These should be specific and actionable.
|
|
type: numbered-list
|
|
template: |
|
|
**{{pillar_name}}** - {{description}}
|
|
- id: core-gameplay-loop
|
|
title: Core Gameplay Loop
|
|
instruction: Define the 30-60 second loop that players will repeat. Be specific about timing and player actions.
|
|
template: |
|
|
**Primary Loop ({{duration}} seconds):**
|
|
|
|
1. {{action_1}} ({{time_1}}s)
|
|
2. {{action_2}} ({{time_2}}s)
|
|
3. {{action_3}} ({{time_3}}s)
|
|
4. {{reward_feedback}} ({{time_4}}s)
|
|
- id: win-loss-conditions
|
|
title: Win/Loss Conditions
|
|
instruction: Clearly define success and failure states
|
|
template: |
|
|
**Victory Conditions:**
|
|
|
|
- {{win_condition_1}}
|
|
- {{win_condition_2}}
|
|
|
|
**Failure States:**
|
|
|
|
- {{loss_condition_1}}
|
|
- {{loss_condition_2}}
|
|
|
|
- id: game-mechanics
|
|
title: Game Mechanics
|
|
instruction: Detail each major mechanic that will need to be implemented. Each mechanic should be specific enough for developers to create implementation stories.
|
|
sections:
|
|
- id: primary-mechanics
|
|
title: Primary Mechanics
|
|
repeatable: true
|
|
sections:
|
|
- id: mechanic
|
|
title: "{{mechanic_name}}"
|
|
template: |
|
|
**Description:** {{detailed_description}}
|
|
|
|
**Player Input:** {{input_method}}
|
|
|
|
**System Response:** {{game_response}}
|
|
|
|
**Implementation Notes:**
|
|
|
|
- {{tech_requirement_1}}
|
|
- {{tech_requirement_2}}
|
|
- {{performance_consideration}}
|
|
|
|
**Dependencies:** {{other_mechanics_needed}}
|
|
- id: controls
|
|
title: Controls
|
|
instruction: Define all input methods
|
|
type: table
|
|
template: |
|
|
| Action | Input |
|
|
| ------ | ----- |
|
|
| {{action}} | {{gesture}} |
|
|
|
|
- id: progression-balance
|
|
title: Progression & Balance
|
|
instruction: Define how players advance and how difficulty scales. This section should provide clear parameters for implementation.
|
|
sections:
|
|
- id: player-progression
|
|
title: Player Progression
|
|
template: |
|
|
**Progression Type:** {{linear|branching|metroidvania}}
|
|
|
|
**Key Milestones:**
|
|
|
|
1. **{{milestone_1}}** - {{unlock_description}}
|
|
2. **{{milestone_2}}** - {{unlock_description}}
|
|
3. **{{milestone_3}}** - {{unlock_description}}
|
|
- id: difficulty-curve
|
|
title: Difficulty Curve
|
|
instruction: Provide specific parameters for balancing
|
|
template: |
|
|
**Tutorial Phase:** {{duration}} - {{difficulty_description}}
|
|
**Early Game:** {{duration}} - {{difficulty_description}}
|
|
**Mid Game:** {{duration}} - {{difficulty_description}}
|
|
**Late Game:** {{duration}} - {{difficulty_description}}
|
|
- id: economy-resources
|
|
title: Economy & Resources
|
|
condition: has_economy
|
|
instruction: Define any in-game currencies, resources, or collectibles
|
|
type: table
|
|
template: |
|
|
| Resource | Earn Rate | Spend Rate | Purpose | Cap |
|
|
| -------- | --------- | ---------- | ------- | --- |
|
|
| {{resource}} | {{rate}} | {{rate}} | {{use}} | {{max}} |
|
|
|
|
- id: level-design-framework
|
|
title: Level Design Framework
|
|
instruction: Provide guidelines for level creation that developers can use to create level implementation stories
|
|
sections:
|
|
- id: level-types
|
|
title: Level Types
|
|
repeatable: true
|
|
sections:
|
|
- id: level-type
|
|
title: "{{level_type_name}}"
|
|
template: |
|
|
**Purpose:** {{gameplay_purpose}}
|
|
**Duration:** {{target_time}}
|
|
**Key Elements:** {{required_mechanics}}
|
|
**Difficulty:** {{relative_difficulty}}
|
|
|
|
**Structure Template:**
|
|
|
|
- Introduction: {{intro_description}}
|
|
- Challenge: {{main_challenge}}
|
|
- Resolution: {{completion_requirement}}
|
|
- id: level-progression
|
|
title: Level Progression
|
|
template: |
|
|
**World Structure:** {{linear|hub|open}}
|
|
**Total Levels:** {{number}}
|
|
**Unlock Pattern:** {{progression_method}}
|
|
|
|
- id: social-and-monetization
|
|
title: Social and Monetization
|
|
instruction: Define how the game will integrate with WeChat's social features and generate revenue.
|
|
sections:
|
|
- id: social-mechanics
|
|
title: Social Mechanics
|
|
template: |
|
|
**Purpose:** Leverage WeChat's social graph to drive engagement and user acquisition.
|
|
|
|
**Features:**
|
|
- **Leaderboards:**
|
|
- **Type:** Friends-only leaderboard.
|
|
- **Update Frequency:** Weekly, resetting every Monday at midnight.
|
|
- **Display:** Shows the top 10 friends, plus the player's own rank.
|
|
- **Implementation:** Via OpenDataContext.
|
|
- **Sharing:**
|
|
- **Share Triggers:** New high score, unlocking a rare item.
|
|
- **Share Content:** "I just scored {{score}} in {{game_title}}! Can you beat my score?"
|
|
- **Rewards:** 100 Gold for each successful share (friend clicks the link).
|
|
- **Inviting Friends:**
|
|
- **Incentive:** 500 Gold for each friend who installs the game and completes the tutorial.
|
|
|
|
- id: monetization-design
|
|
title: Monetization Design
|
|
template: |
|
|
**Purpose:** Outline the strategy for generating revenue through a mix of ads and in-app purchases.
|
|
|
|
**Methods:**
|
|
- **Rewarded Video Ads:**
|
|
- **Placement:**
|
|
- "Continue Game": Watch an ad to continue a game after losing (once per game).
|
|
- "Get Daily Bonus": Watch an ad to receive a daily bonus of 200 Gold.
|
|
- **Frequency Cap:** 5 rewarded ads per player per day.
|
|
- **Banner Ads:**
|
|
- **Placement:** Bottom of the main menu and settings screens.
|
|
- **In-App Purchases (IAP):**
|
|
- **Virtual Currency:**
|
|
- **Gems:** Premium currency, purchased with real money.
|
|
- **Gold:** Soft currency, earned through gameplay and watching ads.
|
|
- **Items for Sale:**
|
|
- **Cosmetics:** Character skins, custom UI themes (purchased with Gems).
|
|
- **Power-ups:** "Coin Doubler" (permanent, purchased with Gems), "Extra Life" (consumable, purchased with Gold).
|
|
- **Ad Removal:** One-time purchase to permanently remove banner ads (purchased with real money).
|
|
|
|
- id: technical-specifications
|
|
title: Technical Specifications
|
|
instruction: Define technical requirements that will guide architecture and implementation decisions. Review any existing technical preferences.
|
|
sections:
|
|
- id: performance-requirements
|
|
title: Performance Requirements
|
|
template: |
|
|
**Frame Rate:** Smooth performance
|
|
**Memory Usage:** <{{memory_limit}}MB
|
|
**Load Times:** <{{load_time}}s initial, <{{level_load}}s between levels
|
|
**Package Size:** <{{package_size_limit}}MB initial package
|
|
- id: platform-specific
|
|
title: Platform Specific
|
|
template: |
|
|
**WeChat Mini-Game:**
|
|
|
|
- OS: iOS, Android
|
|
- Input: Touch
|
|
- id: asset-requirements
|
|
title: Asset Requirements
|
|
instruction: Define asset specifications for the art and audio teams
|
|
template: |
|
|
**Visual Assets:**
|
|
|
|
- Art Style: {{style_description}}
|
|
- Color Palette: {{color_specification}}
|
|
- Animation: {{animation_requirements}}
|
|
- UI Resolution: {{ui_specs}}
|
|
|
|
**Audio Assets:**
|
|
|
|
- Music Style: {{music_genre}}
|
|
- Sound Effects: {{sfx_requirements}}
|
|
- Voice Acting: {{voice_needs}}
|
|
|
|
- id: technical-architecture-requirements
|
|
title: Technical Architecture Requirements
|
|
instruction: Define high-level technical requirements that the game architecture must support
|
|
sections:
|
|
- id: engine-configuration
|
|
title: Engine Configuration
|
|
template: |
|
|
**WeChat Mini-Game Setup:**
|
|
|
|
- JavaScript/TypeScript
|
|
- Use of `game.json` for configuration
|
|
- id: code-architecture
|
|
title: Code Architecture
|
|
template: |
|
|
**Required Systems:**
|
|
|
|
- Page Management
|
|
- State Management
|
|
- Asset Loading
|
|
- Save/Load System
|
|
- Input Management
|
|
- Audio System
|
|
- Performance Monitoring
|
|
- id: data-management
|
|
title: Data Management
|
|
template: |
|
|
**Save Data:**
|
|
|
|
- Progress tracking
|
|
- Settings persistence
|
|
- Statistics collection
|
|
- {{additional_data}}
|
|
|
|
- id: development-phases
|
|
title: Development Phases
|
|
instruction: Break down the development into phases that can be converted to epics
|
|
sections:
|
|
- id: phase-1-core-systems
|
|
title: "Phase 1: Core Systems ({{duration}})"
|
|
sections:
|
|
- id: foundation-epic
|
|
title: "Epic: Foundation"
|
|
type: bullet-list
|
|
template: |
|
|
- Project setup and configuration
|
|
- Basic page management
|
|
- Core input handling
|
|
- Asset loading pipeline
|
|
- id: core-mechanics-epic
|
|
title: "Epic: Core Mechanics"
|
|
type: bullet-list
|
|
template: |
|
|
- {{primary_mechanic}} implementation
|
|
- Player controller
|
|
- id: phase-2-gameplay-features
|
|
title: "Phase 2: Gameplay Features ({{duration}})"
|
|
sections:
|
|
- id: game-systems-epic
|
|
title: "Epic: Game Systems"
|
|
type: bullet-list
|
|
template: |
|
|
- {{mechanic_2}} implementation
|
|
- {{mechanic_3}} implementation
|
|
- Game state management
|
|
- id: content-creation-epic
|
|
title: "Epic: Content Creation"
|
|
type: bullet-list
|
|
template: |
|
|
- Level loading system
|
|
- First playable levels
|
|
- Basic UI implementation
|
|
- id: phase-3-polish-optimization
|
|
title: "Phase 3: Polish & Optimization ({{duration}})"
|
|
sections:
|
|
- id: performance-epic
|
|
title: "Epic: Performance"
|
|
type: bullet-list
|
|
template: |
|
|
- Optimization and profiling
|
|
- Memory management
|
|
- id: user-experience-epic
|
|
title: "Epic: User Experience"
|
|
type: bullet-list
|
|
template: |
|
|
- Audio implementation
|
|
- Visual effects and polish
|
|
- Final UI/UX refinement
|
|
|
|
- id: success-metrics
|
|
title: Success Metrics
|
|
instruction: Define measurable goals for the game
|
|
sections:
|
|
- id: technical-metrics
|
|
title: Technical Metrics
|
|
type: bullet-list
|
|
template: |
|
|
- Frame rate: Smooth
|
|
- Load time: {{load_target}}
|
|
- Crash rate: <{{crash_threshold}}%
|
|
- Memory usage: <{{memory_target}}MB
|
|
- id: gameplay-metrics
|
|
title: Gameplay Metrics
|
|
type: bullet-list
|
|
template: |
|
|
- Tutorial completion: {{completion_rate}}%
|
|
- Average session: {{session_length}} minutes
|
|
- Level completion: {{level_completion}}%
|
|
- Player retention: D1 {{d1}}%, D7 {{d7}}%
|
|
|
|
- id: appendices
|
|
title: Appendices
|
|
sections:
|
|
- id: change-log
|
|
title: Change Log
|
|
instruction: Track document versions and changes
|
|
type: table
|
|
template: |
|
|
| Date | Version | Description | Author |
|
|
| :--- | :------ | :---------- | :----- |
|
|
- id: references
|
|
title: References
|
|
instruction: List any competitive analysis, inspiration, or research sources
|
|
type: bullet-list
|
|
template: "{{reference}}"
|