SpecKit, Rust 및 Bevy를 활용한 게임 개발
Source: Dev.to
Overview
brkrs — 재미있고 플레이 가능한 브릭‑브레이커 게임 & 학습 놀이터
brkrs는 Rust 🦀와 Bevy 엔진을 사용해 만든 실제 플레이 가능한 Breakout/Arkanoid‑스타일 게임입니다. 또한 핸즈‑온 학습 프로젝트로, 다음을 탐험할 수 있게 해줍니다:
- GitHub speckit을 이용한 Spec‑first 개발
- 이슈와 PR을 통한 점진적 기능 개발
- AI‑보조 및 에이전트 기반 코딩 실험
모든 기능은 스펙으로 시작해 이슈 또는 PR을 거쳐 최종적으로 동작하는 Rust 코드가 됩니다. 게임을 플레이하고, 코드를 탐색하며, 최신 Rust/Bevy 워크플로우를 동시에 학습할 수 있습니다.
“Talk is cheap. Show me the code.” – Linus Torvalds
brkrs는 여러분이 플레이하고, 만지고, 스펙이 실제 게임으로 살아나는 모습을 볼 수 있게 합니다.
The Story Behind brkrs
나는 항상 예전 Arkanoid/Breakout‑스타일 게임, YaAC 🐧 를 최신 게임 프레임워크로 다시 만들고 싶었습니다. 핵심 게임플레이 기반을 수동으로 구현하면서 시작했죠: 문서를 읽고, 예제를 따라가며, 기본 메커니즘(공, 패들, 벽돌)으로 간단한 프로토타입을 만들었습니다.
하지만 모든 것을 수동으로 하려면 학습 곡선이 가파르고 시간도 많이 소요된다는 것이 금방 드러났습니다.
brkrs는 해결책으로 탄생했습니다: 현대 Rust 게임 개발을 배우고, Spec‑first 워크플로우를 적용하며, AI‑보조 코딩을 실험하는 동시에 실제 게임을 즐길 수 있는 방법이죠.
Try it now
Play the web version on GitHub Pages.
Key Features
- 클래식 Breakout‑스타일 게임플레이: 패들, 공, 벽돌, 레벨
- 레벨은 인간이 읽을 수 있는 형식이며 쉽게 수정 가능
- Spec‑first 워크플로우: 모든 기능이 스펙으로 시작해 동작하는 Rust 코드로 끝남
- 작고 점진적인 PR이 개발 워크플로우와 학습 경로를 보여줌
- 크레이트‑준비 상태이며 크로스‑플랫폼(데스크톱 + WebAssembly 빌드) 지원
Rust, Bevy, 최신 코딩 관행을 배우기에 재미있고 접근하기 쉬운 방법.
Quickstart (play & learn)
Prerequisites: Rust, Cargo, Git
git clone https://github.com/cleder/brkrs.git
cd brkrs
cargo run --release- Enter fullscreen mode
- Exit fullscreen mode
Controls: move paddle with mouse, scroll wheel to rotate (if enabled), ESC to pause.
Play, tweak, and learn — modify levels, bricks, or mechanics to see specs turn into features.
Core Systems
- Physics (Rapier3D) – 3D 물리 엔진을 평면 플레이 영역에 제한.
- Game State – (예정) 메뉴, 플레이 중, 일시 정지, 게임 오버, 전환.
- Level Loader – RON 파일 파싱, 엔티티 스폰, 레벨별 중력 설정.
- Brick System – 컴포넌트와 이벤트를 통한 확장 가능한 벽돌 동작.
- Pause System –
ESC로 일시 정지, 클릭으로 재개, 창 모드 전환 지원 (네이티브).
Learning Path & Contribution
This project is intended to be fun and educational. Suggested learning steps:
- Read a spec in the repo or wiki.
- Pick a small issue to implement.
- Submit a PR that fulfills the spec.
- Experiment with AI‑assisted features or gameplay tweaks.
Documentation
Full documentation is available at brkrs.readthedocs.io:
- Quickstart Guide — Get running in 10 minutes
- Developer Guide — Set up a development environment
- API Reference — Rust API documentation
Why You’ll Enjoy It
- Play a real game while learning coding practices
- Watch specs transform into working features
- Experiment safely with Rust, Bevy, and AI‑assisted workflows
Learn by doing in a hands‑on, playful way.