---
name: opencurrent-make-fps-game
description: "코딩을 몰라도 AI에게 말로 시켜서, 브라우저에서 바로 돌아가는 내 취향의 FPS 게임을 갖게 됩니다. 이럴 때 사용: 배경·무기·적을 내 말로 정한 뒤 AI에게 걸어 다니는 무대, 무기와 적, 웨이브와 점수 순서로 세 번에 나눠 시킵니다. 매번 브라우저에서 직접 해 보고, 마지막에 파일 맨 위에 모아 둔 설정 값을 말로 바꿔 색·무기·난이도를 취향대로 고칩니다. 도구: Claude Code, Three.js."
metadata:
  source: "https://opencurrent.ai/w/make-fps-game"
  opencurrent-id: "make-fps-game"
  verification: "pending"
  exported-at: "2026-11-21T11:13:13.161Z"
---

# FPS 게임 만들기

코딩을 몰라도 AI에게 말로 시켜서, 브라우저에서 바로 돌아가는 내 취향의 FPS 게임을 갖게 됩니다.

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/make-fps-game
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("make-fps-game")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 입력값(inputs)을 사용자에게 받아 프롬프트의 {{이름}} 자리에 넣을 것. 필수값이 없으면 먼저 물어볼 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

배경·무기·적을 내 말로 정한 뒤 AI에게 걸어 다니는 무대, 무기와 적, 웨이브와 점수 순서로 세 번에 나눠 시킵니다. 매번 브라우저에서 직접 해 보고, 마지막에 파일 맨 위에 모아 둔 설정 값을 말로 바꿔 색·무기·난이도를 취향대로 고칩니다.

## 준비물

- 파일을 만들고 고칠 수 있는 AI (직접 해 본 것은 Claude Code · 대화형 앱이면 매번 index.html 전체를 받아 같은 이름으로 저장)
- 데스크톱 브라우저(Chrome 등)와 키보드·마우스
- 인터넷 연결 (게임이 Three.js를 CDN에서 불러옴 · 설치할 것 없음)
- 게임 파일을 둘 빈 폴더

## 입력값

시작하기 전에 사용자에게 받아서 프롬프트의 `{{이름}}` 자리에 넣을 것.

- `{{world}}` 배경과 분위기 (필수): 어디서 벌어지는 일인지, 색과 시간대. 기존 게임 이름 대신 내 말로
  - 예: 밤의 소금 평원에 버려진 기상 관측소. 하얗게 갈라진 바닥, 청록빛 안개, 호박색 관측 등
- `{{weapon}}` 무기 (필수): 무엇을 쏘는지와 느낌
  - 예: 빛줄기를 쏘는 신호총
- `{{enemy}}` 적 (필수): 생김새와 움직임. 도형으로 만들 수 있는 모양
  - 예: 공중에 떠서 천천히 도는 보라색 각진 덩어리(정전기 덩이), 가운데에 밝은 알맹이
- `{{taste_change}}` 취향대로 바꿀 것 (선택): 완성 뒤 바꾸고 싶은 색·무기·적·난이도
  - 예: 해 질 녘 붉은 모래 사막 느낌으로. 적은 형광 초록색에 더 빠르고 약하게, 대신 더 많이. 탄창은 20발, 연사는 더 빠르게. 게임 이름은 '붉은 모래 야간조'

써 본 모델: Claude Code (Fable 5.2) (2026-11), Three.js 0.187.0 · Chromium (Playwright 1.65) (2026-11)

## 단계

### 1. 배경·무기·적을 내 말로 정하기 (사람이)

세 가지를 한두 줄씩. '○○ 같은 게임' 대신 장소, 색, 생김새를 직접 묘사. 그림 파일 없이 만들 것이므로 상자·공·다면체로 표현되는 모양이 유리

기대 결과: 배경, 무기, 적 설명 세 개

확인 방법: 기존 게임의 이름·캐릭터·맵 이름이 들어가지 않았는지 확인

### 2. 걸어 다니는 빈 무대 만들기 (AI에게 · Claude Code)

총과 적 없이 무대, 이동, 충돌까지만. 파일 하나(index.html)에 전부

프롬프트:

```text
빈 폴더에 index.html 파일 하나로 브라우저 1인칭 3D 게임의 뼈대를 만들어 줘. 총과 적은 아직 넣지 마.

- 설정: {{world}}
- Three.js를 CDN에서 import map으로 불러와. three와 three/addons/를 같은 CDN, 같은 버전으로 고정하고, 버전은 npm에서 지금 최신을 확인해서 써. 시점 조작은 PointerLockControls.
- 그림·소리·3D 모델 파일은 쓰지 마. 모든 모양은 도형과 코드로 만들고, 바닥 무늬는 캔버스에 그려서 입혀.
- 무대: 네모난 경기장, 바깥 벽 넷, 숨을 수 있는 기둥 20개쯤(매번 같은 배치), 안개, 조명, 하늘.
- 조작: 시작 화면을 클릭하면 마우스가 잠기고, W A S D 이동, 마우스로 둘러보기, Space 점프, Esc 멈춤.
- 충돌: 벽과 기둥을 뚫지 못하고, 비스듬히 부딪히면 벽을 따라 미끄러지게.
- 오류가 나면 화면 아래에 그 메시지가 그대로 보이게.

끝난 기준: index.html을 브라우저로 열면 무대가 보이고, 클릭한 뒤 걸어 다닐 수 있고, 벽과 기둥에 막힘. 다 만들면 여는 방법을 한 줄로 알려 줘.
```

기대 결과: 폴더 안의 index.html 하나. 시작 화면, 무대, 이동, 점프, 벽 충돌

확인 방법: 파일에 import map이 있고 three와 three/addons/ 주소의 버전 숫자가 같은지 확인

### 3. 브라우저에서 열어 걸어 보기 (사람이)

index.html을 더블클릭해 브라우저로 열기. 화면 클릭 후 W A S D, 마우스, Space. 벽과 기둥에 일부러 부딪혀 보기. Esc로 마우스 풀기

기대 결과: 무대가 보이고 클릭 뒤 마우스로 둘러보며 이동. 벽에서 멈춤

확인 방법: 빈 화면이면 화면 아래 붉은 칸의 메시지나 브라우저 콘솔(F12) 내용을 복사해 6단계 프롬프트로 전달

### 4. 무기와 적 넣기 (AI에게 · Claude Code)

이동이 된 뒤에 추가. 탄창·적 수 같은 숫자는 나중에 바꿀 수 있으니 그대로 두어도 무방

프롬프트:

```text
index.html에 무기와 적을 넣어 줘. 지금 되는 이동과 충돌은 건드리지 마.

- 무기: {{weapon}}. 화면 오른쪽 아래에 도형으로 만든 총, 화면 가운데에 조준점. 클릭하면 조준점 방향으로 바로 맞는 방식(레이캐스트), 누르고 있으면 연사. 탄창 12발, R 재장전, 다 쓰면 자동 재장전. 쏠 때 반동과 빛줄기, 맞은 자리에 불꽃. 기둥 뒤에 있는 적은 맞지 않게.
- 적: {{enemy}}. 플레이어를 따라오고, 기둥에 막히면 옆으로 돌아서 오고, 서로 겹치지 않게. 세 발 맞으면 터지고, 맞을 때 하얗게 깜빡임. 플레이어에게 닿으면 체력이 깎이고 적은 뒤로 튕겨 나가고, 화면 가장자리가 붉게 번쩍.
- 적 5마리가 경기장 가장자리, 플레이어에게서 떨어진 곳에서 등장.
- 화면 왼쪽 아래에 체력과 남은 탄 표시.

끝난 기준: 적이 다가오고, 쏘면 터지고, 닿으면 체력이 줄어듦.
```

기대 결과: 총과 조준점, 따라오는 적, 체력과 탄 표시가 들어간 index.html

확인 방법: 새로 고침 뒤 적이 다가오는지, 쏘면 터지는지, 닿으면 체력이 줄어드는지, 기둥 뒤의 적은 안 맞는지 확인

### 5. 웨이브·점수·소리로 한 판 완성 (AI에게 · Claude Code)

규칙과 끝 화면을 넣고, 바꿀 값을 파일 맨 위 한 곳에 모으기. 다음 단계의 취향 고치기가 이 묶음을 사용

프롬프트:

```text
index.html을 한 판짜리 게임으로 완성해 줘.

- 웨이브: 1웨이브는 적 4마리, 웨이브마다 2마리씩 늘고 조금씩 빨라짐. 적은 한꺼번에 말고 조금씩 등장. 다 정리하면 3초 쉬면서 체력 20 회복, 그다음 웨이브 시작. 화면 위쪽에 '웨이브 2' 같은 알림.
- 점수: 적을 터뜨릴 때마다 점수. 최고 점수는 브라우저에 저장.
- 끝: 체력이 0이 되면 마우스 잠금을 풀고 웨이브·점수·최고 점수를 보여 주고, 클릭하면 처음부터 다시 시작. Esc로 멈추면 '멈춤' 화면, 클릭하면 이어서.
- 소리: 파일 없이 코드로 만든 짧은 효과음(발사, 명중, 터짐, 피격, 웨이브 시작, 끝).
- 마지막으로 색·속도·체력·탄창·적 수·난이도 같은 값을 파일 맨 위 '설정' 묶음 한 곳에 모으고, 줄마다 한국어 설명을 달아 줘.

끝난 기준: 죽을 때까지 한 판을 하고 다시 시작할 수 있고, 브라우저 콘솔에 오류와 경고가 없음.
```

기대 결과: 웨이브 알림, 점수, 끝 화면과 다시 시작, 효과음, 맨 위 '설정' 묶음

확인 방법: 일부러 맞아서 끝 화면이 나오는지, 클릭으로 다시 시작되는지, 파일 맨 위에 한국어 설명이 달린 설정 값이 모여 있는지 확인

### 6. 한 판 해 보고 이상한 곳 고치기 (AI에게 · Claude Code)

두세 판 플레이. 오류 메시지나 이상한 동작은 한 번에 하나씩 그대로 전달. 직접 해 봤을 때는 'THREE.Clock … deprecated' 경고와 Space를 짧게 누르면 점프가 안 되는 문제가 이 방식으로 해결

프롬프트:

```text
index.html을 열어서 해 보니 아래와 같아. 원인을 찾아 그 부분만 고치고, 무엇을 바꿨는지 한 줄로 알려 줘. 다른 기능은 건드리지 마.

(화면 아래나 브라우저 콘솔에 나온 메시지, 또는 이상한 동작을 그대로 붙여 넣기)
```

기대 결과: 고친 index.html과 바뀐 점 한 줄

확인 방법: 새로 고침 뒤 같은 문제가 다시 나오지 않는지, 콘솔에 오류가 없는지 확인

### 7. 내 취향으로 고치기 (AI에게 · Claude Code)

색·무기·적·난이도는 설정 값만 바꿔도 달라짐. 고치기 전에 index.html을 복사해 두면 되돌리기 쉬움. 새 무기나 새 적 종류처럼 값으로 안 되는 변화는 한 번에 하나씩 따로 요청

프롬프트:

```text
index.html 맨 위 '설정' 묶음의 값만 바꿔서 게임을 이렇게 고쳐 줘: {{taste_change}}

조작·충돌·규칙 코드는 건드리지 마. 끝나면 바꾼 값을 '이름: 이전 → 이후' 목록으로 알려 줘.
```

기대 결과: 분위기와 난이도가 바뀐 게임, 바꾼 값 목록

확인 방법: 새로 고침 뒤 색과 탄창·적 수가 요청대로인지, 이동과 사격이 전과 같이 되는지 확인

## 최종 결과 예시

입력:

```text
world: 밤의 소금 평원에 버려진 기상 관측소. 하얗게 갈라진 바닥, 청록빛 안개, 호박색 관측 등
weapon: 빛줄기를 쏘는 신호총
enemy: 공중에 떠서 천천히 도는 보라색 각진 덩어리(정전기 덩이), 가운데에 밝은 알맹이
```

```text
index.html 하나(625줄, 외부 파일 없음, Three.js 0.187.0을 CDN에서 불러옴). 게임 이름 '소금밭 야간조'. W A S D 이동, 마우스 조준, Space 점프, 클릭 발사, R 재장전. 웨이브마다 적이 늘고 빨라짐. 체력 0이면 끝 화면에 웨이브·점수·최고 점수, 클릭으로 다시 시작. 파일 맨 위 설정 묶음에 색·속도·탄창·적 수 등 36개 값
```

## 주의할 점

- 기존 게임의 이름·캐릭터·맵·무기 생김새·음악·그림 베끼기 금지 · '○○ 같은 게임' 대신 원하는 느낌을 내 말로 묘사 · 남에게 공개할 때 특히 주의
- 한 번에 전부 시키면 어디서 깨졌는지 찾기 어려움 · 프롬프트 하나에 한 묶음, 끝날 때마다 직접 플레이
- AI가 예전 Three.js 쓰임새를 기억으로 적는 경우 있음 · 직접 해 봤을 때 0.187.0에서 THREE.Clock 경고 발생, THREE.Timer로 바꿔 해결 · 경고 문구를 그대로 붙여 넣으면 고쳐짐
- three와 three/addons/의 버전이나 CDN이 다르면 빈 화면 · import map의 두 주소를 같은 버전으로 고정
- 대화 앱 안의 미리보기 창에서는 마우스 잠금이 막힐 수 있음(샌드박스 iframe은 별도 허용 필요) · 파일을 내려받아 브라우저에서 직접 열기
- Esc로 멈춘 직후 바로 클릭하면 브라우저가 마우스 잠금을 거절하는 경우 있음 · 1초쯤 뒤 다시 클릭
- 키를 짧게 누르면 점프가 안 먹는 문제 발생 가능(매 프레임 키 상태만 볼 때) · '키를 누른 순간 점프 예약'으로 요청해 해결
- 인터넷이 끊기면 Three.js를 못 불러와 빈 화면
- 그래픽 가속이 꺼진 환경에서는 느림 · 같은 게임이 소프트웨어 렌더링에서 초당 12장, GPU에서 61장 · 느리면 기둥·조명 수 줄이기 요청
- 키보드·마우스 전제라 휴대폰 터치로는 조작 불가
- 적은 길 찾기 없이 막히면 옆으로 도는 단순한 방식 · 미로처럼 복잡한 맵에서는 낄 수 있음
- 에이전트가 자동으로 확인할 때 Playwright 기본 헤드리스(headless shell)는 마우스 잠금 불가 · channel 'chromium'의 새 헤드리스로 실행

## 출처

- [three.js docs · PointerLockControls](https://threejs.org/docs/pages/PointerLockControls.html)
- [three.js docs · Timer](https://threejs.org/docs/pages/Timer.html)
- [MDN · Pointer Lock API](https://developer.mozilla.org/en-US/docs/Web/API/Pointer_Lock_API)
- [Summer Engine · How to Make a Browser Game with AI (Step by Step, 2026)](https://www.summerengine.com/blog/make-a-browser-game-with-ai)
- [Artificial Analysis MicroEvals · three.js retro FPS (한 파일 프롬프트 예)](https://artificialanalysis.ai/microevals/threejs-retro-fps-1784134891176)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/make-fps-game 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
