← 튜토리얼로 돌아가기

빠른 시작: 첫 번째 게임

ForgeAX의 핵심 작업흐름은 한 문장으로 되어 있습니다:Forge하려는 게임을 설명하고 나머지는 처리하도록 하세요.

✅ 오픈 소스(Apache-2.0). 전체 설치 명령은 다음을 참조하세요.다운로드 및 설치; 이 페이지에서는 일단 작업 흐름이 어떤 느낌인지 설명합니다.

The target: a complete tiny loop

Start small enough that the agent can implement and verify the whole experience in one pass. This guide uses a neon collectathon:

  • WASD movement
  • 8 collectibles
  • progress + win state
  • browser Play build

1 · 스튜디오 시작

종속성이 설치된 후 하나의 명령으로 스튜디오를 불러옵니다. 브라우저에는 다음 두 영역이 표시됩니다.

BUILD BRIEF · Small scope · complete loop

Build a small 3D neon collectathon in the active ForgeAX game.
- Move with WASD and keep the camera readable.
- Place 8 glowing energy shards in a compact arena.
- Collecting a shard updates an on-screen counter.
- Collecting all shards shows a clear win state.
Use the installed Engine Skills and exact SDK declarations; do not guess APIs.
Run the game, open the Play URL, test movement and collection, and fix any failure you observe.

2 · What the agent does behind the scenes

ForgeAX turns a free-form request into a bounded, evidence-producing loop:

  1. Inspect — Read the active game, Runtime and Engine SDK identity.
  2. Learn — Open the relevant Engine Skills, declarations and working templates.
  3. Implement — Edit the smallest coherent set of files in the active game.
  4. Run — Build through the verified Runtime and obtain the Play URL.
  5. Verify — Exercise real behavior, inspect errors and repair until proven.

3 · Engine capabilities used by this tiny game

Player-facing resultEngine capabilityWhy it is AI-friendly
Player, shards and arena exist as game objectsECS World, components and schedulesState and update order are explicit and queryable.
A lit 3D scene appears in the browserRender projections, materials, lights and cameraRendering inputs and pass structure can be inspected instead of guessed.
Movement and collision feel stableInput and physics domainsEach domain owns its data and execution contract.
Progress and win feedback are visibleState + HTML/CSS or Engine UIState transitions are explicit and presentation can be tested independently.
The project can be rebuilt consistentlyPack, asset GUIDs and versioned RuntimeSources, published assets and runtime identity stay traceable.

4 · Iterate by player experience, not by file

Once the core loop works, ask for one experience-level change at a time. The agent can decide which systems and assets need to change.

SECOND PASS · GAME FEEL

Make movement feel more responsive, add a short pickup pulse and sound,
and keep the win feedback readable on both desktop and a narrow browser window.
Re-run and verify the complete loop after the change.

THIRD PASS · VISUAL DIRECTION

Give the arena a coherent cyan-and-amber sci-fi look using Engine materials,
lighting and post effects. Preserve gameplay readability and compare the result
in the real Play build before reporting completion.

5 · Definition of done

  • The reported active game is the game you intended to change.
  • The launch result shows a matching Runtime and Engine SDK identity.
  • The Play URL loads without a fatal browser or runtime error.
  • Movement, all collectibles, progress and the win state were exercised in the running game.

Your source of truth is the project directory. You can close the AI client, reopen it later, read status and continue the same game.

쇼케이스 보기 →