# BMad Game Dev Studio

[![Version](https://img.shields.io/npm/v/bmad-game-dev-studio?color=blue&label=version)](https://www.npmjs.com/package/bmad-game-dev-studio)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Python Version](https://img.shields.io/badge/python-%3E%3D3.10-blue?logo=python&logoColor=white)](https://www.python.org)
[![uv](https://img.shields.io/badge/uv-package%20manager-blueviolet?logo=uv)](https://docs.astral.sh/uv/)
[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)

**BMGD brings BMad's structured development to game development.** Create working prototypes quickly in Unity, Unreal, Godot—or any engine you choose.

![BMGD Logo](docs/bmgd-logo.png)

## About BMGD

BMad Game Dev Studio (BMGD) adapts the BMad Method framework for game development. Developed by game industry veterans, BMGD guides you through product research, technical design, narrative design, and a full epic-driven production cycle.

## Supported Engines

BMGD has first-class support for:

- [Unity](https://unity.com) — C# scripting, industry-standard for many game types
- [Unreal Engine](https://www.unrealengine.com/) — Blueprint and C++, AAA powerhouse
- [Godot](https://godotengine.org/) — Open-source, GDScript, rapidly growing

But you're not limited to these—BMGD works with any platform, from pure C to custom engines.

## What You Can Create

BMGD supports **21 game types**, including:

| Genre | Examples |
|-------|----------|
| Action | Platformers, shooters, hack-and-slash |
| RPG | Action RPG, tactical RPG, dungeon crawlers |
| Strategy | Turn-based, RTS, tower defense |
| Simulation | Life sim, tycoon, management |
| Adventure | Visual novels, point-and-click, walking simulators |
| And more... | Survival, horror, puzzle, racing, etc. |

## What BMGD Does

- **Product Research** — Market analysis, competitor research, positioning
- **Game Design Document** — Comprehensive GDD with mechanics, progression, and balance
- **Narrative Design** — Story structure, characters, dialogue, world-building
- **Technical Architecture** — Engine patterns, performance considerations
- **Production Planning** — Epic-driven sprints, story tracking, retrospectives
- **Quick Prototyping** — Skip the planning, jump straight into building

## What BMGD Doesn't Do

BMGD works *with* coding agents like Claude Code, Cursor, or GitHub Copilot—but it can't create everything:

- Art assets (models, textures, sprites)
- Animations
- Music and sound effects
- Full game implementation from scratch

Think of BMGD as your senior game dev colleague—not a replacement for your entire team.

## Installation

BMGD is installed as a module during BMad Method setup:

```bash
npx bmad-method@alpha install
```

Select **Game Dev Studio** from the modules list.

## Quick Start

After installing, run from your project root:

```
/bmad-help          # Get guided help for game development
/bmgd-quick-dev     # Jump straight into prototyping
/bmgd-gdd           # Create a Game Design Document
/bmgd-narrative     # Design your game's story
```

## Two Ways to Work

| Approach | When to Use | Workflow |
|----------|-------------|----------|
| **Quick Flow** | Rapid prototyping, small projects | `/bmgd-quick-dev` |
| **Full Production** | Full games, teams, long-term | `/bmad-help` for guided path |

## Example: Starting a New Game

```
You: /bmad-help
BMGD: What kind of game are you making?
You: A tactical sci-fi RPG
BMGD: Great choice! Here's what I recommend...
    [Guides you through genre-specific planning]
    [Helps select appropriate workflows]
```

## Documentation

**[BMad Game Dev Studio Documentation](http://game-dev-studio-docs.bmad-method.org)** — Tutorials, how-to guides, and reference

- [Getting Started](http://game-dev-studio-docs.bmad-method.org/tutorials/)
- [BMad Method Docs](http://docs.bmad-method.org) — Core framework documentation

## Community

- [Discord](https://discord.gg/gk8jAdXWmj) — Get help from other game devs
- [YouTube](https://youtube.com/@BMadCode) — Tutorials, master class, and more
- [X / Twitter](https://x.com/BMadCode)
- [Website](https://bmadcode.com)
- [GitHub Issues](https://github.com/bmad-code-org/bmad-module-game-dev-studio/issues) — Report bugs

## Support BMad

BMad is free for everyone and always will be. Star this repo, [buy me a coffee](https://buymeacoffee.com/bmad), or email contact@bmadcode.com for corporate sponsorship.

## License

MIT License — see [LICENSE](LICENSE) for details.

---

**BMad Game Dev Studio** — Part of the [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD) ecosystem.

[![Contributors](https://contrib.rocks/image?repo=bmad-code-org/bmad-module-game-dev-studio)](https://github.com/bmad-code-org/bmad-module-game-dev-studio/graphs/contributors)

See [CONTRIBUTORS.md](CONTRIBUTORS.md) for contributor information.

*If you can dream it, you can build it.*
