이 페이지는 영어에서 기계 번역되었습니다. 영어 원문 읽기.

블로그

AI와 함께하는 Three.js 게임 개발 — 채팅 옆에서 웹 게임을 만들고 플레이하기

AI Game Developer가 이제 Three.js 웹 게임을 만들고, 채팅 옆 라이브 게임 패널에서 실행하며, AI 에이전트가 보고 플레이하고 테스트할 수 있게 합니다.

AI와 함께하는 Three.js 게임 개발 — 채팅 옆에서 웹 게임을 만들고 플레이하기

AI Game Developer는 내장 AI 에이전트가 있는 데스크톱 앱으로, 이제 새로운 엔진인 Web(Three.js)을 지원합니다. 앱에서, 명령줄에서, 또는 에이전트에게 요청하기만 하면 three.js 게임을 만들 수 있고, 게임은 채팅 바로 옆의 라이브 패널에서 실행됩니다. 에이전트는 코드를 작성하는 것만 하지 않습니다. 실행 중인 게임을 보고, 키를 누르고, 스크린샷을 찍고, 플레이라이트를 실행할 수 있어서 "뭔가 바꾸고, 확인하고, 고치는" 루프가 한 창 안에서 일어납니다.

이 글에서는 Three.js 지원이 무엇을 하는지, 새 프로젝트가 어떻게 시작되는지, 그리고 여러분과 에이전트가 같은 실행 중인 게임 위에서 어떻게 함께 작업하는지 설명합니다.

AI와 함께하는 Three.js 게임 개발

Three.js는 웹에서 가장 인기 있는 3D 라이브러리 중 하나입니다. three.js 게임은 하나의 웹 페이지입니다. 장면, 카메라, 프레임 루프를 만드는 TypeScript 코드가 개발 서버에서 제공되고 브라우저에서 플레이됩니다. 그래서 AI 에이전트와 함께 작업하기에 아주 잘 맞습니다. 모든 변경은 평범한 코드이고, 페이지는 순식간에 다시 로드되며, 게임은 브라우저가 돌아가는 어디서든 열 수 있습니다.

보통 발목을 잡는 것은 코드 주변의 설정입니다. 올바른 Node.js를 설치하고, 프로젝트를 만들고, 개발 서버를 시작한 다음, 스크린샷과 오류 메시지를 다시 채팅으로 복사해 오는 일이죠. AI Game Developer가 그 부분을 처리하므로, 대화는 게임 자체에 머물 수 있습니다.

스타터 장면으로 프로젝트 만들기

Web(Three.js) 프로젝트를 만드는 방법은 세 가지이며, 모두 같은 결과를 냅니다. 군더더기 없는 three.js + Vite + TypeScript 프로젝트입니다. 게임에 필요한 라이브러리는 에이전트가 추가합니다.

  • 데스크톱 앱에서 프로젝트 만들기 대화상자를 열고 Web(Three.js)을 선택합니다.
  • AI Game Developer CLI에서 아래에 표시된 create 명령을 실행합니다.
  • 아무 채팅에서나 에이전트에게 three.js 게임을 만들어 달라고 요청합니다. 같은 create 단계를 사용합니다.
BashAI Game Developer CLI
/create-project threejs my-game --starter island

모든 새 프로젝트는 스타터에서 시작합니다. Empty는 캔버스, 장면, 카메라, 프레임 루프만 있는 빈 흰 페이지로, 여러분의 아이디어를 위한 준비가 되어 있습니다. 네 가지 샘플 장면은 보기 좋은 출발점을 제공합니다. Studio는 조명이 비치는 받침대 위의 광택 있는 매듭이고, Blueprint는 파란 도면 위에 그려진 기계 부품이며, Checker는 축과 단순 도형이 있는 체커 바닥이고, Island는 새벽의 로우폴리 떠 있는 섬입니다. 각 샘플은 코드 맨 위에 무엇을 여러분의 게임으로 교체해야 하는지 적어 두고, 조정 가능한 값들을 하나의 settings 객체에 모아 두어 여러분과 에이전트가 어디서 시작할지 알 수 있습니다.

네 가지 샘플 스타터 장면: Studio, Blueprint, Checker, Island
샘플 스타터: Studio, Blueprint, Checker, Island

이미 Unity, Godot, Unreal Engine에서 작업 중이신가요? 앱은 해당 프로젝트 안에 웹 프로토타입을 만들 수 있습니다. 엔진이 임포트하지 않는 WebPrototypes 폴더에 말이죠. 본 게임에서 구현하기 전에 브라우저에서 메커니즘을 빠르게 시험해 보는 방법입니다.

Node.js는 알아서 준비됩니다

웹 게임에는 Node.js와 npm이 필요합니다. 직접 설치할 필요는 없습니다. 앱이 nodejs.org에서 자체 Node.js를 내려받고, 공개된 SHA-256 체크섬과 대조해 검증한 뒤, 이미 컴퓨터에 있는 Node.js와 분리된 자체 폴더에 보관합니다. 앱이 시작된 직후 백그라운드에서 이 작업을 하므로, 보통 첫 게임은 다운로드를 기다리지 않고 시작됩니다.

여러분이나 에이전트가 프로젝트 안에서 npm을 실행할 때, 그것은 앱의 설정이 적용된 앱의 npm입니다. 회사 프록시나 사설 레지스트리 뒤에서 작업한다면, 여러분의 npm 구성에서 관련된 설정(레지스트리, 프록시, 인증서, 자격 증명)만 그대로 가져오고 나머지 설정은 제외됩니다.

채팅 옆에서 게임 플레이하기

제목 표시줄에서 Play를 누르거나 Projects 패널의 프로젝트에서 누르면 게임이 시작됩니다. 시작하는 동안 하나의 진행 카드가 각 단계를 보여줍니다. Node.js 확인, 의존성이 바뀌었을 때의 설치, 개발 서버 시작입니다. 그다음 게임이 세션 옆의 게임 패널에서 열립니다.

Studio 스타터 장면: 카메라가 주변을 떠도는 동안 받침대 위에서 회전하는 광택 있는 매듭
실행 중인 Studio 스타터, three.js로 렌더링

게임 패널은 실행 중인 게임의 실제 브라우저 보기이며, 새로 고침, 일시 정지 및 프레임 단계, 음소거, FPS 카운터, 팝아웃을 위한 도구 모음이 있습니다. 게임을 클릭하면 게임이 키보드를 가져가고, Esc를 누르면 키보드가 앱으로 돌아옵니다. 팝아웃은 게임을 별도 창에 띄우므로 보조 모니터에서 유용하며, 평소 쓰는 브라우저에서도 열 수 있습니다. 프로젝트 메뉴에서 또는 Ctrl+Shift+G(macOS에서는 Cmd+Shift+G)로 패널을 열 수 있습니다.

편집은 핫 리로드됩니다. 에이전트가 파일을 바꾸면 Vite가 페이지를 제자리에서 갱신하므로 재시작할 것이 없습니다. 변경 사항이 컴파일되지 않으면 페이지는 마지막 정상 빌드를 유지하고 에이전트는 컴파일 오류를 확인합니다.

에이전트가 게임을 보고 조작할 수 있습니다

이 부분이 AI와 함께 작업하는 느낌을 바꿉니다. 에이전트가 Web(Three.js) 프로젝트에 연결되면 실시간 게임 도구 세트를 얻습니다.

  • 상태와 로그: 열린 페이지, 프레임 레이트, 콘솔 출력, 스택이 포함된 잡히지 않은 오류, 컴파일 오류.
  • 렌더링된 프레임 이후의 게임 캔버스 스크린샷으로, 에이전트가 여러분이 보는 것을 봅니다.
  • three.js 장면 트리와 게임이 노출하기로 선택한 값들로, 추가 게임 코드가 필요 없습니다.
  • 입력: 키보드, 마우스, 휠, 터치, 게임패드, 그리고 일시 정지, 지정한 프레임 수만큼 진행, 시간 스케일 변경.
  • 플레이라이트: 입력, 프레임 단계, 검사, 스크린샷으로 이루어진 스크립트 시퀀스로, 하나의 PASSED 또는 FAILED 보고서로 끝납니다.

그래서 "점프를 더 높게 만들고, 플레이어가 두 번째 플랫폼에 도달할 수 있는지 확인해 줘" 같은 요청을 할 수 있고, 에이전트는 변경을 적용하고, 실제 입력으로 레벨을 플레이하고, 결과를 보고, 무슨 일이 있었는지 알려줄 수 있습니다. 테스트를 위해 숨겨진 뷰를 열 수 있고, 여러 개를 동시에 열 수도 있어서 테스트 실행이 여러분의 화면을 차지하지 않습니다.

휴대폰에서 플레이하기

앱에서 실행되는 게임은 원격 링크로 앱과 페어링된 휴대폰에서도 플레이할 수 있습니다. 게임이 컴퓨터에서 실행되는 동안 휴대폰은 해당 프로젝트의 Play를 보여주고, 게임은 원격 연결이 이미 사용하는 동일한 암호화 링크를 통해 스트리밍됩니다. 로컬 네트워크 설정, 포트 포워딩, 공개 URL이 필요 없습니다. 에이전트가 입력과 스크린샷으로 휴대폰 뷰를 조작할 수도 있어서 터치 조작을 확인하는 데 유용합니다.

필요할 때 멀티플레이어

스타터 중 어느 것에도 서버가 없습니다. 대부분의 게임은 처음에는 서버가 필요 없기 때문입니다. 필요해지면 모든 새 프로젝트에 에이전트를 위한 멀티플레이어 스킬이 포함되어 있습니다. WebSocket 릴레이 서버와 클라이언트로 이루어진 검토된 작은 스캐폴드와, 그것을 게임에 연결하는 단계가 담겨 있습니다. 앱은 게임 옆에서 그 게임 서버를 실행하고, 충돌하면 재시작하며, 게임 자체의 주소에서 제공하므로 휴대폰에서도 작동합니다.

시작하기

ai-game.dev/download 에서 AI Game Developer를 내려받고, Studio 또는 Island 스타터로 Web(Three.js) 프로젝트를 만들고, Play를 누른 뒤 에이전트에게 첫 번째 변경을 요청하세요. ai-game.dev/docs/app 의 앱 가이드에서 앱 설치와 로그인을 다룹니다. 네이티브 엔진을 선호한다면 ai-game.dev/blog/bevy-game-development-with-ai 의 Bevy와 ai-game.dev/blog/brutal-dotnet-game-development-with-ai 의 BRUTAL에 관한 동반 글을 읽어 보세요.

이미지 출처: 이 글의 장면들은 앱 자체의 스타터 장면이며, three.js로 렌더링했습니다(MIT License, Copyright 2010-2026 three.js authors).

블로그의 다른 글

전체 글