# FPS 게임 만들기
id: make-fps-game · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/make-fps-game
기준일: 2026-11-17 (여기서 고친 날)
도구: Claude Code, Three.js
써 본 모델: Claude Code (Fable 5.2) (2026-11), Three.js 0.187.0 · Chromium (Playwright 1.65) (2026-11)
걸리는 시간: 약 40분
평가 점수: 32/100 (확인 없음 · 검수 대기)

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

달라진 점: 프롬프트 세 번으로 한 파일짜리 1인칭 슈팅 게임 완성. 설정 값만 바꾸는 프롬프트 한 번으로 배경·적·무기·난이도가 다른 게임으로 바뀜 (결과물로 확인)
- Claude Code의 역할: 프롬프트대로 index.html 작성과 수정, 브라우저로 열어 동작과 콘솔 점검
- Three.js의 역할: 브라우저에서 3D 장면을 그리고 1인칭 시점 조작 제공

결과물 (샘플 데이터로 실행 · OpenCurrent 편집 에이전트 (Claude Code) · 예시 입력값(소금 평원, 신호총, 정전기 덩이)으로 절차의 프롬프트를 순서대로 실행):
- 프롬프트 세 번 뒤: 밤의 소금 평원 무대에서 신호총으로 떠 있는 다면체 적을 맞혀 적이 하얗게 번쩍이는 1인칭 화면. 왼쪽 아래에 체력 100, 신호탄 11/12, 웨이브 1, 점수 0 (/results/make-fps-game/base-game.jpg)
- 취향 프롬프트 한 번 뒤: 같은 게임이 붉은 모래 바닥과 자주색 하늘, 초록색 적, 20발 탄창으로 바뀐 1인칭 화면. 가까운 적이 맞아 번쩍이고 뒤에 초록 적 셋 (/results/make-fps-game/after-taste-prompt.jpg)

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

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

입력값 (프롬프트의 {{이름}}에 넣는다):
- {{world}} 배경과 분위기 (필수) 예: 밤의 소금 평원에 버려진 기상 관측소. 하얗게 갈라진 바닥, 청록빛 안개, 호박색 관측 등
- {{weapon}} 무기 (필수) 예: 빛줄기를 쏘는 신호총
- {{enemy}} 적 (필수) 예: 공중에 떠서 천천히 도는 보라색 각진 덩어리(정전기 덩이), 가운데에 밝은 알맹이
- {{taste_change}} 취향대로 바꿀 것 (선택) 예: 해 질 녘 붉은 모래 사막 느낌으로. 적은 형광 초록색에 더 빠르고 약하게, 대신 더 많이. 탄창은 20발, 연사는 더 빠르게. 게임 이름은 '붉은 모래 야간조'

단계:
1. [사람이] 배경·무기·적을 내 말로 정하기 — 세 가지를 한두 줄씩. '○○ 같은 게임' 대신 장소, 색, 생김새를 직접 묘사. 그림 파일 없이 만들 것이므로 상자·공·다면체로 표현되는 모양이 유리
   기대 결과: 배경, 무기, 적 설명 세 개
   확인 방법: 기존 게임의 이름·캐릭터·맵 이름이 들어가지 않았는지 확인
2. [AI에게 · Claude Code] 걸어 다니는 빈 무대 만들기 — 총과 적 없이 무대, 이동, 충돌까지만. 파일 하나(index.html)에 전부
   프롬프트:
   > 빈 폴더에 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] 무기와 적 넣기 — 이동이 된 뒤에 추가. 탄창·적 수 같은 숫자는 나중에 바꿀 수 있으니 그대로 두어도 무방
   프롬프트:
   > index.html에 무기와 적을 넣어 줘. 지금 되는 이동과 충돌은 건드리지 마.
   > 
   > - 무기: {{weapon}}. 화면 오른쪽 아래에 도형으로 만든 총, 화면 가운데에 조준점. 클릭하면 조준점 방향으로 바로 맞는 방식(레이캐스트), 누르고 있으면 연사. 탄창 12발, R 재장전, 다 쓰면 자동 재장전. 쏠 때 반동과 빛줄기, 맞은 자리에 불꽃. 기둥 뒤에 있는 적은 맞지 않게.
   > - 적: {{enemy}}. 플레이어를 따라오고, 기둥에 막히면 옆으로 돌아서 오고, 서로 겹치지 않게. 세 발 맞으면 터지고, 맞을 때 하얗게 깜빡임. 플레이어에게 닿으면 체력이 깎이고 적은 뒤로 튕겨 나가고, 화면 가장자리가 붉게 번쩍.
   > - 적 5마리가 경기장 가장자리, 플레이어에게서 떨어진 곳에서 등장.
   > - 화면 왼쪽 아래에 체력과 남은 탄 표시.
   > 
   > 끝난 기준: 적이 다가오고, 쏘면 터지고, 닿으면 체력이 줄어듦.
   기대 결과: 총과 조준점, 따라오는 적, 체력과 탄 표시가 들어간 index.html
   확인 방법: 새로 고침 뒤 적이 다가오는지, 쏘면 터지는지, 닿으면 체력이 줄어드는지, 기둥 뒤의 적은 안 맞는지 확인
5. [AI에게 · Claude Code] 웨이브·점수·소리로 한 판 완성 — 규칙과 끝 화면을 넣고, 바꿀 값을 파일 맨 위 한 곳에 모으기. 다음 단계의 취향 고치기가 이 묶음을 사용
   프롬프트:
   > index.html을 한 판짜리 게임으로 완성해 줘.
   > 
   > - 웨이브: 1웨이브는 적 4마리, 웨이브마다 2마리씩 늘고 조금씩 빨라짐. 적은 한꺼번에 말고 조금씩 등장. 다 정리하면 3초 쉬면서 체력 20 회복, 그다음 웨이브 시작. 화면 위쪽에 '웨이브 2' 같은 알림.
   > - 점수: 적을 터뜨릴 때마다 점수. 최고 점수는 브라우저에 저장.
   > - 끝: 체력이 0이 되면 마우스 잠금을 풀고 웨이브·점수·최고 점수를 보여 주고, 클릭하면 처음부터 다시 시작. Esc로 멈추면 '멈춤' 화면, 클릭하면 이어서.
   > - 소리: 파일 없이 코드로 만든 짧은 효과음(발사, 명중, 터짐, 피격, 웨이브 시작, 끝).
   > - 마지막으로 색·속도·체력·탄창·적 수·난이도 같은 값을 파일 맨 위 '설정' 묶음 한 곳에 모으고, 줄마다 한국어 설명을 달아 줘.
   > 
   > 끝난 기준: 죽을 때까지 한 판을 하고 다시 시작할 수 있고, 브라우저 콘솔에 오류와 경고가 없음.
   기대 결과: 웨이브 알림, 점수, 끝 화면과 다시 시작, 효과음, 맨 위 '설정' 묶음
   확인 방법: 일부러 맞아서 끝 화면이 나오는지, 클릭으로 다시 시작되는지, 파일 맨 위에 한국어 설명이 달린 설정 값이 모여 있는지 확인
6. [AI에게 · Claude Code] 한 판 해 보고 이상한 곳 고치기 — 두세 판 플레이. 오류 메시지나 이상한 동작은 한 번에 하나씩 그대로 전달. 직접 해 봤을 때는 'THREE.Clock … deprecated' 경고와 Space를 짧게 누르면 점프가 안 되는 문제가 이 방식으로 해결
   프롬프트:
   > index.html을 열어서 해 보니 아래와 같아. 원인을 찾아 그 부분만 고치고, 무엇을 바꿨는지 한 줄로 알려 줘. 다른 기능은 건드리지 마.
   > 
   > (화면 아래나 브라우저 콘솔에 나온 메시지, 또는 이상한 동작을 그대로 붙여 넣기)
   기대 결과: 고친 index.html과 바뀐 점 한 줄
   확인 방법: 새로 고침 뒤 같은 문제가 다시 나오지 않는지, 콘솔에 오류가 없는지 확인
7. [AI에게 · Claude Code] 내 취향으로 고치기 — 색·무기·적·난이도는 설정 값만 바꿔도 달라짐. 고치기 전에 index.html을 복사해 두면 되돌리기 쉬움. 새 무기나 새 적 종류처럼 값으로 안 되는 변화는 한 번에 하나씩 따로 요청
   프롬프트:
   > index.html 맨 위 '설정' 묶음의 값만 바꿔서 게임을 이렇게 고쳐 줘: {{taste_change}}
   > 
   > 조작·충돌·규칙 코드는 건드리지 마. 끝나면 바꾼 값을 '이름: 이전 → 이후' 목록으로 알려 줘.
   기대 결과: 분위기와 난이도가 바뀐 게임, 바꾼 값 목록
   확인 방법: 새로 고침 뒤 색과 탄창·적 수가 요청대로인지, 이동과 사격이 전과 같이 되는지 확인

최종 결과 예시:
입력:
> world: 밤의 소금 평원에 버려진 기상 관측소. 하얗게 갈라진 바닥, 청록빛 안개, 호박색 관측 등
> weapon: 빛줄기를 쏘는 신호총
> enemy: 공중에 떠서 천천히 도는 보라색 각진 덩어리(정전기 덩이), 가운데에 밝은 알맹이
```
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