선적 서류 비치

ForgeaX는 AI 기반 게임 개발 스튜디오입니다. 게임을 일반 언어로 설명합니다. AI 리드라는 사람이노 계획하고, 디자인하고, 실행 중인 게임 코드 자체에 기록합니다., 결과를 브라우저에 핫 리로드합니다. 말하는 내용이 바로 플레이되는 내용입니다.

아래에는 두 개의 사내 재단이 있습니다.AI의 관점에 맞게 재설계된 엔진(보다AI 기반 엔진이 필요한 이유) 그리고올바른 결과에 기능을 수렴하는 개발 루프(보다AI가 기능을 올바르게 가져오는 방법).

어울린다2D / 2.5D / 3D웹 게임. 플레이 가능한 FPS, 디아블로 스타일 ARPG, 2단계 서바이벌 및 슈팅 게임 데모가 이미 존재합니다.유리 진열장); 엔진은 PBR/IBL/SSAO 렌더링, 2D/3D 물리, 골격 애니메이션 및 듀얼 RHI를 다룹니다(하단의 "엔진 기능" 참조).유리 진열장).

모든 것이 브라우저(WebGPU), 웹, 데스크톱에서 하나의 스택으로 실행됩니다. Apache License 2.0에 따른 오픈 소스(특허).

전제 조건: 자식,혈액 요소 질소≥ 1.3,마디≥ 22,컬. (깨끗한 호스트에서는롤빵 FX 설정bun / node 22+ / pnpm / Rust+wasm 툴체인을 부트스트랩할 수도 있습니다. 기본적으로 프롬프트가 0입니다.--대화형도구별로 묻고,--skip-부트스트랩생략합니다.)

git clone --recurse-submodules \
  https://github.com/ForgeaX-Games/forgeax-studio.git
CD forgeax-스튜디오
bun fx 설정 # 일회성 설정
bun fx 시작 # → http://localhost:18920

무엇롤빵 FX 설정하다:전제조건 확인 → 하위 모듈 초기화 → 엔진 패키지 빌드 → 실행롤빵 설치각 하위 저장소에서 → 마켓플레이스 플러그인 빌드 → 스캐폴드$ROOT/.env~에서.env.예제. 와 함께--대화형그것은 또한 다음을 요구합니다.ANTHROPIC_API_KEY; 그렇지 않으면 경고하고 편집합니다..env나중에.

롤빵 FX 시작세 가지 서비스를 부팅합니다. 섬기는 사람(:18900, 런타임 코어 — 채팅/백엔드/세션),인터페이스(:18920, vite HMR이 포함된 Studio UI) 및엔진(:15173, 렌더러). 포트 재정의.env~을 통해FORGEAX_{서버,인터페이스,엔진}_PORT. 그런 다음 열어http://localhost:18920.

일상적인 명령(1개 항목,롤빵 FX):달리다롤빵 FX 설정환경을 준비하기 위해 한 번; 나중에 업데이트를 가져옵니다.롤빵 FX 업데이트(루트 저장소 업데이트 + 하위 모듈 동기화, 재설치/재구축 없음)롤빵 FX 시작/Bun FX 시작 앱웹/데스크톱 실행;롤빵 FX 중지그리고롤빵 FX 다시 시작중지 / 다시 시작;롤빵 FX 상태그리고롤빵 FX 의사설정을 진단합니다.Bun FX 빌드 앱데스크톱 앱을 패키징합니다. 달리다롤빵 FX모든 명령을 나열하는 인수가 없습니다.

데스크톱 앱: Bun FX 시작 앱라이브 소스에서 기본 창을 엽니다(먼저 자동 설치를 실행하고 스택을 시작합니다. 닫으면 스택이 중지됩니다).Bun FX 빌드 앱독립된 패키지를 만든다.앱/.dmg. 보다실행 및 미리보기모든 모드에 대해.

플랫폼 지원(macOS/Linux/Windows, 최고 수준):설치와 실행은 하나의 세트입니다.크로스 플랫폼 Bun 스크립트, 따라서 세 시스템 모두 다음을 실행합니다.같은롤빵 FX명령동일한 행동으로 — 그리고Windows에는 더 이상 Git-Bash가 필요하지 않습니다.(오래된 듀얼.쉿/.박쥐/.ps1스크립트가 삭제되었습니다). 구체적으로:웹 개발자(롤빵 FX 시작) 그리고데스크탑 개발자(Bun FX 시작 앱, 라이브 소스의 기본 Tauri 창)은 macOS/Linux/Windows에서 작동합니다.게임을 두 번 클릭할 수 있는 형태로 패키징.앱/.dmg(Bun FX 빌드 앱)은 현재 macOS에서 수행됩니다. 일반적인 Windows 관련 문제(검은색 미리보기, 턴당 콘솔 창, 완전히 닫히지 않는 프로세스, 시스템의 스텁 Python)가 모두 수정되었습니다.변경 내역 · 2026-06-28.

손으로 하지 않는 것을 선호하시나요? AI 코딩 CLI 복제 및 실행 - 참조AI CLI 복제본을 갖고 실행하세요.; 그런 다음 첫 번째 게임을 빌드하세요.빠른 시작. API 키는 다음을 참조하세요.고급 · AI 백엔드 전환/구성.

인터페이스는 상단 표시줄, 왼쪽의 채팅, 오른쪽의 미리보기/워크벤치 등 세 부분으로 구성됩니다.

• 상단바—⊕새로운 메뉴, 아프로젝트 전환기(게임 간 이동 - "프로젝트"가 무엇인지 다룹니다.핵심 개념) 및세션 전환기(과거 대화 검토/전환)
• 좌·채팅(ChatPanel)— 팀 레일(Forge 및 하위 에이전트), 메시지 스트림(하위 에이전트 카드, Forge의 사고 및 도구 호출) 및 하단의 작성기백엔드 스위치오른쪽 하단에 있습니다(참조고급의).
• 오른쪽 · 메인 영역 (MainArea)— 사이를 전환합니다.시사(귀하의 게임은 iframe에 라이브) 그리고작업대(파일 편집/디자인 문서); 보다장면 및 편집기.

오른쪽 상단 톱니바퀴가 열립니다.설정: API 키, 모델 선택, CLI 백엔드 및 플러그인 관리. 데스크톱 앱에는 처음 열 때 키를 묻는 첫 실행 오버레이도 표시됩니다.

ForgeaX에서는"프로젝트"와 "게임"은 같은 것입니다— 게임은 하나이다게임/<슬러그>/접는 사람. 실제 게임 폴더는 일반적으로 다음과 같습니다.

• forge.json — 게임 매니페스트. 최소 3개 필드:ID,이름, 그리고기입(입력 코드를 가리킵니다. 예:src/main.ts).
• FORGE.md — 게임 자체의 읽어보기/게임 플레이 개요(컨트롤, 메커니즘, 스토리 비트).
• src/ — 게임 코드. 게다가main.ts항목은 일반적으로 관심사에 따라 모듈로 분할됩니다(예:player.ts,적/,효과.ts,setup.ts).
• design/ · assets/ — 디자인 문서 및 예술/오디오 자산.
• package.json · tsconfig.json — 표준 TS 프로젝트 파일.

그만큼main.ts항목은 다음에서 엔진 기능을 가져옵니다.@forgeax/엔진 런타임/엔진 EC/엔진 앱그리고 수출게임입장— 엔진이 게임을 로드하는 계약입니다. 전체 기능 세트에 대해서는 "엔진 기능"을 참조하십시오.유리 진열장.

여러 게임 = 여러 프로젝트, 상단 표시줄 프로젝트 전환기에서 전환됩니다. 장면/레벨 구성 방법은 다음을 참조하세요.장면 및 편집기.

포지(주요원)게임 코드를 직접 작성하는 유일한 프로그램입니다.games/<슬러그>/src/main.ts, 미리보기핫 리로드, 실행 결과를 보고 다음 단계를 결정합니다. 해당 편집 → 보기 → 편집 루프는 미리보기를 볼 수 있는 사람, 즉 Forge(Forge 참조)에게 있어야 합니다.채팅으로 구축).

하위 에이전트(예: Iori 게임플레이, Suzu 디자인, Kotone 내러티브, Iro 아트, Tsumugi 빌드) 계획/디자인/자산 만들기/문서 작성 및절대 만지지 마세요소스/— 실시간 미리보기 피드백이 없으므로 그들이 작성한 코드는 이를 조정할 수 없습니다. 전체 출연진은 다음에서 확인하세요.시장그리고10장 · 에이전트 팀.

파견 작동 방식:Forge는 하나의 도구 호출로 하위 에이전트를 파견합니다(예:하위 에이전트(type="iori", task="…")); 서버의/api/하위 에이전트스트림은 실시간으로 출력을 기본 대화로 다시 연결합니다. 이는 메시지 스트림에 표시되는 내장된 하위 에이전트 카드입니다. 하위 에이전트의 디자인 문서는 워크벤치의 자체 섹션 아래에 보관됩니다(참조:장면 및 편집기).

에이세션에이전트의 메모리입니다.추가 전용이벤트 스트림(각각은 사용자 메시지/보조 메시지/생각/도구 호출/도구 결과)입니다. Forge(메인)와 각 하위 에이전트는 각각 자신의 것을 유지합니다.

UI는 이벤트를 메인 스레드와 하위 에이전트로 내보낸 사람에 따라 이벤트를 분할하여 각 하위 에이전트의 슬라이스를 내장된 카드로 렌더링합니다. 따라서 한 화면에서 Forge의 메인 스레드와 Forge가 파견한 하위 에이전트가 실제로 수행한 작업을 모두 볼 수 있습니다.

상단 표시줄 세션 전환기를 사용하여 지난 세션을 검토하고 전환하세요.세션을 전환해도 아무것도 다시 시작되지 않습니다.— UI는 다른 에이전트의 이벤트 스트림을 읽습니다.

더 구체적일수록 더 적은 수의 다시 실행으로 Forge가 먼저 시도하는 것이 더 좋습니다. 좋은 프롬프트는 일반적으로 다음을 포함합니다.

• 장르 및 견해— 하향식 / 1인칭 / 2.5D 횡스크롤러...
• 코어 루프— 플레이어가 계속하는 한 가지 일
• 통제 수단,승리/패배,적/장애물, 그리고느끼다

작게 시작하여 실행한 다음 메커니즘을 추가하세요. 예를 들어:

하향식 게임: 캐릭터가 경기장을 돌아다니고, 우주에서 총알이 발사되고, 적들이 계속 생성되고, 명중하면 제거되고 점수가 추가됩니다.

단계별 첫 번째 게임은 다음을 참조하세요.빠른 시작; 무엇을 달성할 수 있는지 알아보려면 다음을 찾아보세요.유리 진열장. 더 무거운 디자인의 경우 Forge는 디자인 하위 에이전트를 가져옵니다(참조:핵심 개념).

요청을 보내면 체인은 다음과 같습니다.

• 이해 + 계획— Forge는 더 무거운 작업을 위해 디자인/게임 플레이 하위 에이전트를 파견하여 요구 사항을 명확히 했습니다(참조:핵심 개념).
• 코드 작성— 포지는 쓴다그 자체~ 안으로games/<슬러그>/src/main.ts(그리고 분리된 모듈).
• 핫 리로드— 저장 시 엔진의 vite가 변경 사항과 미리보기를 감지합니다.모듈을 즉시 교체합니다.제자리에 — 완전히 다시 로드하지 않고 사진이 거의 즉시 업데이트됩니다.
• 결과 보기— Forge는 미리보기를 통해 실행 결과를 확인합니다(게임의 결과도 전달함).콘솔뒤로) 다음 단계를 결정합니다.

전체 프로세스는 투명합니다. 메시지 스트림에는 Forge의 생각, 각 도구 호출 및 파견된 하위 에이전트의 카드가 표시됩니다. 미리보기와 워크벤치를 전환/제어하려면 다음을 참조하세요.장면 및 편집기; 핫 리로드 작동 방식은 다음을 참조하세요.실행 및 미리보기.

행복하지 않나요? 계속 이야기하세요. 각 피드백은 또 다른 변경 사항이 되며 핫 리로드를 통해 즉시 확인할 수 있습니다.

더 빠른 총알, 두 배의 적 체력, 밤 배경.

미리보기에는재생/일시 중지/새로고침테스트를 진행하면서 제어할 수 있습니다. 미리보기를 특정 게임에 고정하려면 프로젝트 전환기를 전환하세요(참조:스튜디오를 열고 인터페이스를 배워보세요).

기본 루프는설명 → 생성 → 재생 → 다시 설명. 원활하게 실행하면 문장에서 플레이 가능한 게임으로 전환됩니다. 전체 온보딩은 다음과 같습니다.빠른 시작.

오른쪽 기본 영역은 두 가지 보기 사이를 전환합니다.

• 시사— 게임은 FPS 판독 및 재생/일시 중지/다시 로드 제어 기능을 갖춘 iframe에서 실시간으로 실행됩니다. Forge가 코드를 작성하면 여기에서 즉시 핫 리로드됩니다(참조:채팅으로 구축).
• 작업대— 파일 브라우저 + 편집기: 텍스트 및 코드 보기/편집/저장, 마크다운 디자인 문서 렌더링, 이미지, 오디오, 비디오 및 3D 모델 미리보기. 또한 파일 활동 및 "편집 중인 사람" 잠금을 표시하므로 사용자와 AI가 방해 없이 동일한 파일을 편집할 수 있습니다.

파일이 열려 있지 않으면 워크벤치에 모든 생성 워크벤치(캐릭터/애니메이션/3D/장면/UI/음악...)에 대한 항목이 표시됩니다. — 참조창작 도구그리고시장. 자산을 만드는 방법은 다음을 참조하세요.자산.

장면 편집기는 레벨의 내용을장면 데이터 파일게임 폴더(장면.팩.json) —단일 진실 소스해당 레벨에서는 디스크에 있는 것이 게임에서 실행되는 것입니다.

개체를 배치하고 편집 모드를 종료하면 변경 사항은 다음과 같습니다.디스크에 플러시되고 실행 중인 게임이 이를 다시 읽습니다., 미리보기에 편집 내용이 즉시 반영됩니다(편집→재생 왕복). 반대로, Forge가 채팅을 통해 코드를 변경하면 동일한 핫 리로드 경로를 따릅니다(참조:채팅으로 구축그리고실행 및 미리보기).

게임은여러 장면/레벨, 각각의 장면 데이터는 필요에 따라 전환 및 재사용됩니다. "Cow Survivor" 데모는 주간 목초지와 야간 묘지 사이를 전환합니다(참조:유리 진열장).

정리하는 방법:사물장면 데이터에 살고 있는 동안예술/오디오 자산게임 폴더에 라이브(프로젝트 레이아웃핵심 개념, 자산 생성자산). 장면별로 분할하면 성장하는 게임을 유지 관리할 수 있습니다.

사용캐릭터 에디터(wb 문자) 캐릭터 컨셉 디자인: 한 줄의 브리핑을 작성하고,초상화 + 턴어라운드. 게임용 캐릭터를 얻기 위해 그림 기술이 필요하지 않습니다.

출력(캐릭터 매니페스트 + 초상화/턴어라운드)은 게임 내 캐릭터별로 저장되며다운스트림 입력으로 애니메이션 워크벤치에 바로 피드— 따라서 "캐릭터 디자인 → 움직이게 만들기"는 하나의 연속 파이프라인입니다(다음 항목 참조).

각 작업대는 패널과 도구 세트로 구성됩니다. 당신이 직접 그리고 AI가 파견하여 동일한 아티팩트를 편집합니다. 전체 목록은시장그리고작업대 튜토리얼.

2D:애니메이션 작업대(wb-anim) 캐릭터 초상화를 템플릿으로 사용하여 걷기, 공격, 4방향 모션, 짧은 클립까지 변환합니다.얼굴 드리프트 없이, 따라서 이동 후에도 동일한 문자를 유지합니다.

3D:엔진이 기본적으로 지원골격 애니메이션— 유휴 / 걷기 / 달리기 / 시전 / 죽음 사이의 부드러운 크로스페이드를 사용하여 FBX에서 조작된 스킨 모델과 애니메이션 클립을 가져옵니다. 이 파이프라인은 실제이며 배송됩니다. 쇼케이스에 등장하는 어둠의 판타지 마녀가 움직이는 방식입니다. 참조뼈대 애니메이션의 이정표그리고쇼케이스 (헬포지).

캐릭터 외에도 전체 파이프라인에 걸쳐 작업대가 있습니다.

품목별 적용 범위는 다음과 같습니다.9장 · 생성 도구,작업대 튜토리얼, 그리고시장.

이 페이지에서 실시간으로 실행되는 실제 ForgeaX 엔진 예제(WebGPU - Chrome/Edge 권장) 더 많은 실행 가능한 데모예그리고계략.

전체 화면 열기 ↗

동일한 코드베이스는 세 가지 형식으로 실행됩니다.

• 웹 개발—롤빵 FX 시작세 가지 서비스(서버/UI/엔진)를 부팅합니다. 열려 있는http://localhost:18920브라우저에서 실시간으로 핫 리로드를 편집합니다. macOS/Linux/Windows에서 작동합니다. 설치 위치시작하기 전에.
• 데스크탑 개발—Bun FX 시작 앱동일한 라이브 소스와 HMR을 사용하여 동일한 개발 서버를 로드하는 기본 창을 엽니다. 먼저 자동 설치를 실행하고 스택을 시작한 후 창을 닫으면 스택이 중지됩니다. macOS/Linux/Windows에서 사용 가능합니다.
• 데스크톱 .app(패키지)—Bun FX 빌드 앱독립적인 제품을 생산합니다..앱/.dmg자체 사이드카를 사용하여 두 번 클릭하면 실행됩니다(포트 18810/15273, 의도적으로 개발자의 18900/15173에서 오프셋되어 둘 다 공존할 수 있음). 그 열쇠는~/ForgeaxProjects/.env, 첫 실행 오버레이 포함. 포장은게시 및 공유.

3개의 포트는 모두 재정의 가능합니다..env~을 통해FORGEAX_{서버,인터페이스,엔진}_PORT. ⚠️ 데스크톱 창은 시스템 WebView를 사용하므로 3D는 Chrome보다 약간 약한 WebKit의 WebGPU에서 실행됩니다.최상의 영상을 보려면 브라우저를 사용하세요.

저장하면 적용됩니다. 수동 새로 고침이 필요하지 않습니다.

• 편집하다게임 코드(게임/<슬러그>/src/…) → 엔진이 모듈을 제자리에 핫스왑하고 미리보기가 즉시 업데이트됩니다(Forge의 편집도 이 기능을 사용합니다.채팅으로 구축).
• 변경 사항장면 편집기디스크에 플러시하고 실행 중인 게임으로 다시 흐름(참조장면 및 편집기).

• 빈 미리보기/엔진 오류— 엔진이 제작되지 않았습니다. 재실행롤빵 FX 설정.
• SSL 오류가 발생했습니다.:18920— 다음을 통해 액세스http://localhost(WebGPU는 여전히 localhost에서 작동합니다).
• 사용 중인 포트— 사용 중인 포트에서 오류가 발생합니다(다른 포트는 자동으로 선택되지 않습니다). 달리다롤빵 FX 중지그 다음에롤빵 FX 시작또는 다음에서 포트를 변경하세요..env.
• 채팅에 API 키가 없다고 말합니다- 세트ANTHROPIC_API_KEY~에.env(처음 실행 시 데스크톱 앱에 메시지가 표시됨) 키 설정이 완료되었습니다고급의.
• 데스크탑에서는 3D가 약해 보입니다.— 시스템 WebView의 WebGPU 제한 사항 최상의 렌더링을 위해 Chrome 브라우저 빌드를 사용하세요.

Bun FX 빌드 앱스튜디오 전체를 게임과 함께 하나의 패키지로 패키징합니다.독립형 데스크탑 번들(맥OS.앱/.dmg): 잘린 런타임, 서버, Studio UI, 마켓플레이스 및 게임 콘텐츠가 모두 내부에 있으므로제로 설정으로 두 번 클릭으로 실행됩니다.사용자를 위해.

자체 포트(18810 / 15273)에 내장된 사이드카에서 실행되므로 개발 스택과 충돌하지 않습니다(참조:실행 및 미리보기). 패키징은 macOS에서 실행되어야 합니다. 포장된.앱더블클릭하면 열립니다.

게임은 하나다독립된게임/<슬러그>/접는 사람(forge.json+소스/+ 디자인 문서 + 자산, 참조핵심 개념). 해당 폴더를 공유하거나 커밋하면 다른 사람이 자신의 스튜디오에서 해당 폴더를 열어 계속 플레이하거나 구축할 수 있습니다. 데모 라이브러리에는 여러 게임(fps, hellforge, cow-survivor, Shoot-opt)이 나란히 저장되어 있습니다.유리 진열장.

현재로서는 플레이어에게 게임을 전달하는 가장 신뢰할 수 있는 방법은데스크탑 패키지위에; 보다 원활한 "원클릭 웹 게시/온라인 플레이"는 아직 작업 중입니다.

백엔드 전환(칩 교체):작곡가의 오른쪽 하단에 있는 백엔드 스위치에서 커널을 선택하거나CLI설정 섹션 —Claude Code / Codex / Cursor / Kimi Code / CodeBuddy / DeepSeek Harness / forgeax-cli. CLI 섹션에는 각 백엔드의건강그리고시험단추. 백엔드를 전환하면 기본 페르소나도 교체됩니다(참조:에이전트 팀); 백엔드별 세부정보시장.

키/모델:모델 API 키를 설정하세요(예:ANTHROPIC_API_KEY) 설정 → 키 아래 —실시간 적용, 재시작 없음(편집도 가능합니다.env곧장); 설정 → 모델에서 모델을 선택합니다. 키 누락 문제 해결이 진행 중입니다.실행 및 미리보기.

ForgeaX의 거의 모든 기능은런타임 로드 플러그인(개요는시장), 직접 추가할 수 있습니다.

오늘 가장 빠른 경로:기존 워크벤치 플러그인을 복사하고 조정합니다., 와 함께플러그인 작성자(wb-플러그인-작성자) 돕는다; 더욱 풍부한 인앱 비주얼 편집기(파일 트리 + 코드 편집기, 저장 → 자동 다시 로드)가 곧 출시됩니다. 빌드한 후에는 다음에서 활성화하고 순서를 변경하세요.관리자 패널— 플러그인은 런타임 시 CLI에 의해 마운트됩니다. 작업대의 종류를 확인하세요.창작 도구.

사용페르소나 편집자(wb-에이전트-페르소나): 목록에서 에이전트를 선택하고 텍스트 영역에서 페르소나를 편집한 다음저장 → 핫 리로드, 재시작 없음. 코드를 건드리지 않고도 에이전트에게 다른 캐릭터나 음성을 제공할 수 있습니다.

주 상담원과 하위 상담원이 누구인지, 기본 페르소나는 어디서 나오는지 알아보려면 다음을 참조하세요.핵심 개념그리고에이전트 팀; 전체 출연진은시장.

이들 모두는로드 가능한 플러그인; 필터링 가능한 전체 카탈로그는시장, 튜토리얼 연습은작업대 튜토리얼.

아린 · 프로듀서— 디자인/코드/아트/오디오를 조율하고 게임 전체를 소유하는 만능 프로듀서입니다.

레이아 · 릴 디렉터— 프롬프트를 생성하고, QTE를 진행하고, 분기와 엔딩을 엮어 wb-reel Reel Studio를 구동하여 하나의 아이디어를 클릭 가능하고 재생 가능한 서스펜스 영화로 바꾸는 대화형 FMV 감독입니다.

이들은지명된 대리인Forge가 요청 시 파견합니다(기본 대 하위 에이전트 관계는 다음과 같습니다).핵심 개념); 전체 출연진은시장.

이들 전문가계획과 디자인만 하고 게임 코드는 건드리지 않습니다.(Forge는 코드를 작성합니다.핵심 개념); 그 결과는 작업대에 저장됩니다(참조:장면 및 편집기), 예술 자산은 다음과 같이 생산됩니다.자산.

세트도 있어요예술/자산 전문 에이전트(2D 캐릭터/애니메이션, 3D 로우 폴리/VFX, 대화형 영화 감독 등), 각각 일치하는 제작 워크벤치에 연결됩니다(참조:창작 도구).

각 CLI 백엔드는 즉시 사용 가능한 페르소나와 함께 제공됩니다.클로드(클로드 코드),사본,커서, 그리고ForgeaX(자체 제작 forgeax-cli).백엔드를 전환하면 기본 페르소나가 교체됩니다. 설정이 필요하지 않습니다.; 어떤 커널을 선택하든 기본 페르소나가 함께 제공됩니다.

백엔드를 전환하고 페르소나를 편집하는 방법은고급의; 전체 에이전트 캐스팅과 로드 가능한 페르소나는시장.