← 에디토리얼

바이브코딩 도구 · 2026.11.10 · 19분

바이브코딩 게임 만들기 — 스테이지와 보스 붙이는 무료 도구 5가지

AItoZ 개발팀 · 2026.11.10 발행

바이브코딩 게임 만들기 — 스테이지와 보스 붙이는 무료 도구 5가지 — 바이브코딩 도구

클로드 코드로 만든 휴대폰 게임에 스테이지 3개와 체력이 절반 아래로 떨어지면 분노하는 보스, 컷신 대사를 붙였습니다. 맵(Tiled) · 물리(matter.js) · 보스 행동(XState) · 대사(ink) · 직접 플레이 테스트(Playwright MCP) 다섯 도구의 설치 한 줄 · 라이선스 · 비용과 함께, 같은 요청을 도구 없이 '그냥 시킨 판'과 실제 코드로 비교한 결과, 걸린 시간(그냥 34분 / 도구 27분 + 플레이 테스트 22분), 클로드가 직접 플레이하며 찾은 버그 8개를 11월 10일 윈도 11에서 잰 그대로 담았습니다.

기준: 2026년 11월 10일 19:06 깃허브 API · README · COPYING · npm에서 확인, 같은 날 윈도 11(Node.js 24 · Claude Code 2.1.322 · 스마트 앱 컨트롤 켜짐)에서 직접 실행 · microsoft/playwright-mcp 별 39,401개(Apache-2.0, @playwright/mcp 0.0.85) · statelyai/xstate 별 30,434개(MIT, v5.33.4) · liabru/matter-js 별 18,616개(MIT, Phaser 내장) · mapeditor/tiled 별 13,041개(프로그램 GPL · libtiled BSD 2-clause, v1.12.2) · inkle/ink 별 5,011개(MIT, inkjs 2.4.0) · 다섯 개 합계 106,503개

지난 편에서 AI로 30초짜리 휴대폰 게임 「별똥별 피하기 30초」를 만들었습니다. 이번에는 그 게임에 스테이지 3개를 더하고, 마지막 방에 보스 '운석 골렘'을 넣었습니다. 보스는 체력이 절반 아래로 떨어지면 분노 패턴으로 바뀌고, 보스 방에 들어가기 전에는 선택지가 있는 컷신 대사가 나옵니다. 이 글은 그 일을 나눠 맡은 무료 도구 5개를 정리했습니다. 다섯 개 모두 11월 10일 이 컴퓨터(윈도 11)에서 직접 썼고, 같은 요청을 도구 이름 없이 '그냥 시킨 판'도 따로 만들어 실제 코드로 비교했습니다.

오늘 화제가 된 글도 비슷한 이야기입니다. 한 개발자가 Fable 5.2로 조카의 그림을 12스테이지 게임(이미지 약 175개 · 소리 140개)으로 만들었는데, AI가 봇을 짜서 헤드리스 브라우저로 12스테이지를 끝까지 직접 플레이해 봤다고 밝혔습니다(notesbylex.com, 11월 10일 작성자 글). 이번 시연의 다섯 번째 도구가 바로 그 '직접 플레이'를 맡습니다.

다섯 도구는 각각 무엇을 맡나요?

순서는 맵 → 물리 → 보스 행동 → 대사 → 플레이 테스트입니다. 게임 엔진은 지난 편의 Phaser를 그대로 썼습니다.

순서 도구(저장소) 맡는 일 별(11/10) · 라이선스 버전 · 설치
1 Tiled (mapeditor/tiled) 눈으로 보며 고치는 2D 맵 편집기 13,041 · 프로그램 GPL(libtiled BSD 2-clause) v1.12.2
2 matter.js (liabru/matter-js) 부딪힘 · 튕김 · 비탈을 계산하는 물리 엔진 18,616 · MIT Phaser 안에 들어 있음
3 XState (statelyai/xstate) 보스 행동을 상태로 나누는 상태 기계 30,434 · MIT npm xstate 5.33.4
4 ink (inkle/ink) 게임 대사 · 선택지를 쓰는 스크립트 언어 5,011 · MIT npm inkjs 2.4.0
5 Playwright MCP (microsoft/playwright-mcp) AI가 브라우저를 직접 열고 눌러 보는 도구 39,401 · Apache-2.0 @playwright/mcp 0.0.85

도구 다섯 개는 모두 무료입니다. 이번 시연의 AI 작업은 모두 Claude Code(claude -p, 구독)로 했습니다.

그냥 시키면 어떻게 나오나요?

먼저 같은 요구를 도구 이름 없이 클로드 코드에 그대로 시켜 봤습니다(그냥 시킨 판). 34분 28초(71턴) 만에 빌드가 성공했고, 클로드가 스스로 헤드리스 Chrome 스크립트를 짜서 자동 조종으로 끝까지 돌려 본 뒤 보스 난이도를 한 번 조정했습니다. 게임은 잘 돌아갔습니다.

차이는 코드 구조에 있었습니다.

  • 맵: src/game/stage/stages.ts 안의 좌표 숫자(ground: [[0, FLOOR_Y], [640, FLOOR_Y], [940, 640] …])
  • 충돌: "Arcade Physics는 비탈을 처리하지 못해서 직접 계산"한다며 groundYAt · rectsOverlap · circleRectOverlap 을 하나하나 직접 짰습니다.
  • 보스: Boss.ts 의 switch(state) 안에 분노 여부를 rage 참거짓 값으로 섞었습니다.
  • 대사: BossIntro.ts 안의 BOSS_LINES 문자열 배열

그냥 시킨 판의 실제 코드 일부 — 맵은 stages.ts 좌표 숫자, 충돌은 StageGame.ts 직접 계산, 대사는 BossIntro.ts 문자열(11월 10일 직접 실행)

스테이지가 3개일 때는 괜찮습니다. 그런데 10개로 늘리면, 비탈 하나를 옮길 때마다 코드 속 숫자를 고쳐야 합니다. 그래서 같은 요구를 이번에는 도구 네 개(Tiled · matter.js · XState · ink)를 쓰라고 해서 다시 만들었고(도구 판, 27분 18초 · 53턴, tsc · 빌드 통과), 마지막에 Playwright MCP로 클로드가 직접 플레이하게 했습니다.

1. Tiled — 맵은 눈으로 보면서 고치기

Tiled는 무료 2D 맵 편집기입니다. 별 13,041개, 최신 v1.12.2. 프로그램(tiled.exe)에 서명(SignPath Foundation, 유효)이 있어서, 스마트 앱 컨트롤이 켜진 이 컴퓨터에서도 막히지 않고 바로 열렸습니다. 이번에는 설치 파일(msi)을 관리자 설치 없이 풀어서(msiexec /a) 실행했습니다.

클로드에게 Tiled 형식으로 스테이지 3개를 만들게 했습니다. 넓은 언덕(스테이지 1), 상자가 가득한 지그재그 길(스테이지 2), 보스 방(스테이지 3)입니다. 맵은 public/assets/maps/stage1~3.tmj(18×32칸, 한 칸 30px)이고, 타일셋 tiles.png 에는 타일 12종이 들어 있습니다. 비탈 타일에는 삼각형 충돌 모양을 넣었습니다.

클로드가 만든 맵 3장 — 넓은 언덕 · 상자 지그재그 길 · 보스 방(tmxrasterizer로 그린 그림, 11월 10일 직접 실행)

솔직히 밝히면, 맵은 클로드가 tools/make_maps.mjs 스크립트로 만든 파일입니다. 사람이 Tiled에서 그린 것은 아닙니다. 대신 이 파일을 Tiled에서 열면 눈으로 보면서 칸을 칠하고 상자를 옮길 수 있습니다. 실제로 stage2.tmj를 Tiled 창으로 열어 봤습니다.

Tiled 1.12.2에서 stage2.tmj를 연 화면 — 18×32칸 · 타일 30px, 상자(crate) · 별(star) · 출구(exit) · 자동 조종 경로가 보입니다(11월 10일 직접 실행)

게임 쪽에서는 한 줄로 읽습니다.

this.load.tilemapTiledJSON('stage2', 'maps/stage2.tmj');

설치: 깃허브 릴리스(mapeditor/tiled)에서 윈도 설치 파일을 받아 설치(이번에는 msiexec /a 로 풀어서 실행). 게임에는 tilemapTiledJSON 한 줄.

2. matter.js — 부딪힘은 물리 엔진에 맡기기

matter.js는 웹용 2D 물리 엔진입니다. 별 18,616개, 라이선스 MIT. Phaser 안에 이미 들어 있어서 따로 깔 필요가 없습니다. 다만 기본은 꺼져 있어서 설정 한 줄로 켭니다.

physics: {
    default: 'matter',
    matter: { gravity: { x: 0, y: 1.4 } }
},
// 스테이지에서
this.matter.world.convertTilemapLayer(layer);

이번 게임에서는 세 가지를 맡겼습니다.

  1. 넉백: 운석에 맞으면 수달이 반대쪽으로 튕겨 나갑니다(setVelocity).
  2. 부서지는 상자: 운석이나 보스 돌진에 닿으면 상자가 부서집니다.
  3. 비탈: Tiled 비탈 타일에 넣은 삼각형 충돌 모양이 그대로 비탈이 됩니다.

그냥 시킨 판은 기본 물리(Arcade)로는 비탈을 못 다룬다며 땅 높이와 겹침 계산을 직접 짰습니다. 물리 엔진은 모양만 정하면 나머지를 계산해 줍니다.

설치: 따로 없음(Phaser 내장) → 게임 설정에 physics.default: 'matter'.

3. XState — 보스 행동은 상태도로 나누기

XState는 상태 기계 라이브러리입니다. 별 30,434개, 라이선스 MIT, 버전 5.33.4. npm i xstate 한 줄로 설치합니다.

운석 골렘(체력 24)의 행동을 src/game/boss/bossMachine.ts 에 네 상태로 나눴습니다.

  1. 대기(idle) 와 돌진(charge) 을 오갑니다.
  2. 체력이 절반 이하가 되면 분노(rage) 로 넘어갑니다. 분노 안에서는 떠다니며(hover) 운석 3개를 부채꼴로 쏘다가 더 빠르게 돌진(charge)합니다.
  3. 체력이 다하면 사망(dead).

bossMachine.ts 상태도 — 대기 ⇄ 돌진, 체력 절반에서 분노(떠다니며 운석 3개 부채꼴 ⇄ 더 빠른 돌진), 사망(영상 장면, 이 PC에서 만든 코드 기준)

분노 조건은 이렇게 한 줄로 적혀 있습니다.

willEnrage: hp - damage <= maxHp / 2

그냥 시킨 판도 상태를 나누긴 했지만, switch 문 안에 분노 여부를 참거짓 값으로 섞어 놨습니다. 상태 기계 파일은 Phaser를 몰라서 게임을 켜지 않고도 따로 시험할 수 있습니다. 이번에도 클로드가 Node에서 상태 기계만 따로 돌려 확인했습니다. 실제 자동 플레이 녹화에서는 55.8초에 체력이 12(절반)로 떨어지는 순간 분노 대사가 뜨고, 그다음부터 운석이 3개씩 날아왔습니다.

설치: npm i xstate

4. ink — 대사는 대본 파일로 빼기

ink는 게임 대사와 선택지를 쓰는 스크립트 언어입니다. 별 5,011개, 라이선스 MIT. 윈도용 대사 편집기 Inky가 있고, 웹 게임에는 npm i inkjs(2.4.0)로 붙입니다. 본체 저장소의 마지막 업데이트는 2026년 5월 5일입니다.

보스 방에 들어가기 전 대사를 src/story/boss.ink(32줄)에 적었습니다. 보스 대사 3줄과 해설 1줄, 선택지 2개(「별을 돌려줘!」 · 「우리 싸우지 말자…」)이고, 고른 선택지에 따라 분노할 때 대사도 달라집니다. 대본은 Vite 플러그인이 빌드할 때 컴파일합니다.

boss.ink 대본(왼쪽)과 게임 속 선택지 화면(오른쪽) — 선택지 2개, 분노 대사가 선택에 따라 달라짐(11월 10일 직접 실행)

그냥 시킨 판은 대사가 코드 안 문자열입니다. 대본 파일로 빼 두면 코드를 열지 않고도 대사를 고칠 수 있고, 대본이 틀리면 빌드가 몇 번째 줄인지 알려 주며 멈춥니다. 일부러 없는 곳으로 가는 줄(-> no_such_knot)을 넣고 빌드해 보니 이렇게 멈췄습니다.

ERROR: line 16: Divert target not found: '-> no_such_knot'

설치: npm i inkjs(대사 편집은 Inky)

5. Playwright MCP — 클로드가 직접 해 보게 하기

Playwright MCP는 AI가 브라우저를 직접 열고 누르게 해 주는 도구입니다. 별 39,401개, 라이선스 Apache-2.0, 버전 @playwright/mcp 0.0.85. README의 설치는 claude mcp add playwright npx @playwright/mcp@latest 한 줄입니다.

이 컴퓨터에서는 이렇게 붙였습니다.

  1. claude mcp add -s project playwright -- npx @playwright/mcp@latest --headless — 브라우저 창이 안 뜨게 --headless 를 붙였습니다. 프로젝트의 .mcp.json 에 저장되고, 뒤에 --viewport-size 540x960 · --output-dir 를 더했습니다.
  2. 프로젝트 서버라 claude mcp list 에서는 "Pending approval"(승인 대기)로 나왔습니다. claude -p 로 돌릴 때는 --mcp-config .mcp.json 으로 불러서 연결했습니다.
  3. 윈도인데도 cmd /c 를 붙이지 않고 명령 그대로 연결(connected)됐습니다. 이 PC에서 확인한 사실이고, README에 적힌 내용은 아닙니다.

그리고 처음부터 끝까지 해 보라고 했습니다. 클로드가 스크린샷을 보고 키를 눌러 가며 키보드로 두 번, 자동 조종으로 한 번 끝까지 갔고, 스크린샷 45장을 남겼습니다. 22분 24초(116턴) 동안 버그 8개를 찾아 하나씩 고친 뒤 다시 플레이해 확인했습니다. 고친 파일은 Stage.ts 하나입니다.

Playwright MCP 스크린샷 3장 — 스테이지 1 '출구 열림!' 글자 잘림, 스테이지 2 벽 옆 상자, 보스 방 분노 대사(클로드가 직접 찍음, 11월 10일)

# 클로드가 찾은 문제 원인 · 고친 방법
1 자동 조종이 언덕 앞에서 멈춤 막힘을 속도 값으로 판정해 벽에 막혀도 '움직이는 중' → 이동 거리로 판정
2 상자 더미에서 멈춤 경유점 건너뛰기
3 상자가 벽에 붙어 공중에 뜸 벽 타일 정지 마찰에 붙잡힘 → 옆벽만 마찰 0
4 보스 방 배너가 컷신 위에 굳음 컷신이 장면을 멈춰 배너 애니메이션도 멈춤 → 배너 뒤에 컷신
5 체력 바와 천장 기둥 겹침 Stage.ts에서 고침
6 분노 컷신 때 상태 값(__state)이 늦음 Stage.ts에서 고침
7 '출구 열림!' 글자가 화면 밖으로 잘림 Stage.ts에서 고침
8 피격 번쩍임이 안 보임 Phaser 4 틴트가 곱하기라 안 보임 → FILL로

직접 해 보니 버그 8개 — 대표 3개의 원인과 고친 방법(영상 장면, 이 PC 실행 기록 기준)

고친 뒤 빌드한 게임을 다시 처음부터 자동으로 돌려 녹화했습니다(720×1280). 스테이지 두 개를 지나 보스 방에서 분노 패턴까지 버티고, 시작부터 약 1분 8초 만에 운석 골렘을 격파했습니다.

설치: claude mcp add playwright npx @playwright/mcp@latest(창 없이 하려면 --headless)

설치는 어떻게 하나요?

이 컴퓨터(윈도 11)에서 쓴 명령을 모으면 이렇습니다.

  1. Tiled: 깃허브 릴리스에서 윈도 설치 파일 받기 → 게임에서 this.load.tilemapTiledJSON('stage2', 'maps/stage2.tmj')
  2. matter.js: 설치 없음(Phaser 내장) → physics: { default: 'matter' } · this.matter.world.convertTilemapLayer(layer)
  3. XState: npm i xstate
  4. ink: npm i inkjs(대사 편집기 Inky)
  5. Playwright MCP: claude mcp add -s project playwright -- npx @playwright/mcp@latest --headless

이번에 쓴 지시문은 무엇인가요?

지시문 세 개를 차례로 썼습니다. 원문이 아니라 요지만 옮기면 이렇습니다.

① 그냥 시킨 판: 지난 편 게임에 스테이지 3개와, 체력이 절반 아래로 떨어지면 분노 패턴으로 바뀌는 보스, 보스 방 앞 컷신 대사를 붙여 줘(도구 이름은 말하지 않음).

② 도구 판: 같은 요구를 맵은 Tiled 형식, 물리는 Phaser 안의 matter.js, 보스 행동은 XState 상태 기계, 대사 · 선택지는 ink 대본으로 만들어 줘. 브라우저 확인은 다음 단계에서.

③ 플레이 테스트: Playwright MCP로 게임을 처음부터 끝까지 직접 플레이해 보고, 찾은 문제를 고친 뒤 다시 플레이해 확인해 줘.

이 컴퓨터에서 잰 결과는?

11월 10일 윈도 11에서 클로드 코드(claude -p)로 돌린 기록입니다. 모두 한 번씩 잰 값입니다.

단계 한 일 걸린 시간 결과 API 요금 환산
그냥 시킨 판 스테이지 3 + 보스 + 컷신(도구 이름 없이) 34분 28초(71턴) 빌드 성공, 스스로 헤드리스 시험 · 난이도 조정 $5.72
도구 판 Tiled · matter.js · XState · ink로 같은 요구 27분 18초(53턴) tsc · 빌드 통과 $6.28
플레이 테스트 Playwright MCP로 직접 플레이 22분 24초(116턴) 스크린샷 45장, 버그 8개 고침 $5.46
다시 돌려 보기 고친 게임 자동 플레이 녹화 약 1분 8초 분노(체력 12) → 격파 —

돈은 얼마나 들었나요?

도구 다섯 개는 모두 무료입니다. 돈이 드는 곳은 클로드 코드 사용료뿐입니다.

  • 이번에는 세 번 모두 구독(claude -p)으로 돌렸습니다.
  • 결과에 찍힌 API 요금 환산값은 그냥 시킨 판 $5.72, 도구 판 $6.28, 플레이 테스트 $5.46입니다. 구독으로 쓰면 실제로 이 돈을 내는 것은 아닙니다.
  • 플레이 테스트는 스크린샷을 계속 보면서 키를 누르기 때문에 사용량이 꽤 듭니다(이번 22분에 환산 약 $5.5).

오늘 하나만 해 본다면?

Playwright MCP부터입니다. 지금 만든 게임이 무엇이든 그대로 붙일 수 있고, 사람이 못 본 버그를 클로드가 직접 찾아 줍니다.

  1. 게임 폴더에서 claude mcp add -s project playwright -- npx @playwright/mcp@latest --headless
  2. 클로드 코드에 "처음부터 끝까지 직접 플레이해 보고, 찾은 문제를 고친 뒤 다시 플레이해 확인해 줘"라고 부탁합니다.
  3. 고친 뒤 직접 한 번 더 플레이해 봅니다.

주의할 점은 무엇인가요?

  • Tiled는 GPL 프로그램: Tiled 프로그램은 GPL이고, 안의 libtiled · tmxrasterizer는 BSD 2-clause입니다. Tiled로 만든 맵과 게임은 보통 자유롭게 쓴다고 알려져 있지만, 이 글에서는 단정하지 않습니다. 게임을 판매할 계획이면 판매 전에 라이선스를 꼭 확인하세요(법적 검토 필요).
  • 맵 스크립트 덮어쓰기: 이번 맵은 클로드가 tools/make_maps.mjs 로 만들었습니다. 이 스크립트를 다시 돌리면 Tiled에서 고친 맵을 덮어씁니다. Tiled에서 고치기 시작했다면 스크립트는 다시 돌리지 마세요.
  • 플레이 테스트 = 사용량: 이번 22분 플레이 테스트는 API 요금 환산 약 $5.5였습니다(구독으로 실행).
  • 승인 대기: 프로젝트에 추가한 MCP 서버는 claude mcp list 에서 "Pending approval"로 나옵니다. claude -p 로 돌릴 때는 --mcp-config .mcp.json 으로 불러 썼습니다.
  • 한 번씩 잰 값: 시간과 금액은 이 컴퓨터에서 한 번씩 잰 값이라 늘 같지는 않습니다.

자주 묻는 질문

그냥 시켜도 게임은 돌아가지 않나요? 돌아갑니다. 이번 그냥 시킨 판도 34분 28초 만에 빌드가 됐고, 클로드가 스스로 헤드리스 시험까지 했습니다. 차이는 맵 · 충돌 · 보스 · 대사가 코드 속 숫자와 문자열로 들어가느냐, 고치기 쉬운 파일과 도구로 나뉘느냐입니다. 스테이지를 늘릴수록 이 차이가 커집니다.

다섯 개를 다 써야 하나요? 아닙니다. 맵이 많아지면 Tiled, 비탈 · 튕김이 필요하면 matter.js, 보스 패턴이 복잡하면 XState, 대사가 많으면 ink를 고르면 됩니다. Playwright MCP 플레이 테스트는 어떤 게임에나 붙일 수 있습니다.

윈도에서도 되나요? 됩니다. 11월 10일 스마트 앱 컨트롤이 켜진 윈도 11에서 다섯 개 모두 직접 썼습니다. Tiled는 서명이 있어 막히지 않았고, Playwright MCP는 cmd /c 없이 연결됐습니다.

한 번에 정리하면

  • 맵: Tiled 형식으로 만들고 Tiled에서 눈으로 고치기, 게임은 한 줄로 읽기.
  • 물리: Phaser 안의 matter.js를 설정 한 줄로 켜서 넉백 · 상자 · 비탈.
  • 보스: XState로 대기 · 돌진 · 분노 · 사망, 체력 절반에서 분노.
  • 대사: ink 대본(선택지 2개), 틀리면 빌드가 줄 번호로 알려 줌.
  • 플레이 테스트: Playwright MCP로 클로드가 직접 플레이 — 22분에 버그 8개(그냥 34분 / 도구 27분 + 테스트 22분).

다음 편에서는 AI로 만든 이 게임을 링크 하나로 친구에게 보내 봅니다.

출처

다음 글클로드 코드에 먼저 깔 무료 스킬 · MCP 5개 — 같은 요청으로 직접 비교한 결과→