AI + Thrixel로 Roblox 게임 만드는 방법

시작하기 전에 Roblox Studio를 설치하고 Roblox 계정을 준비하세요.

1. VS Code에서 Rojo 설치하기

1. Visual Studio Code(VS Code)를 설치하세요.
2. VS Code용 Rojo - Roblox Studio Sync 확장을 설치하세요.
3. VS Code에서 File > Open Folder를 선택하고 게임에 사용할 빈 폴더를 여세요.
4. Ctrl + Shift + P(Mac에서는 Cmd + Shift + P)를 눌러 명령 팔레트를 여세요. “Rojo”를 입력하고 Rojo: Open Menu를 선택하세요.
5. 메뉴에 Rojo가 설치되지 않았다고 표시되면 Install Rojo now를 클릭하세요.
6. Install Roblox Studio Plugin을 클릭하세요. Studio가 열려 있으면 다시 시작하세요. 그러면 Studio의 Plugins 탭에 Rojo가 표시됩니다.

2. Build World 스킬 추가하기

로그인

스킬을 설치하기 전에 Thrixel에 로그인하세요. 모든 에이전트가 같은 명령을 사용하며 uv가 필요합니다. uv가 설치되지 않았다면 터미널에서 운영체제에 맞는 명령을 실행하세요.

curl -LsSf https://astral.sh/uv/install.sh | sh

irm https://astral.sh/uv/install.ps1 | iex

아래 로그인 명령을 실행하세요. 브라우저 페이지가 열리면 Approve를 클릭하여 Thrixel 계정을 연결하세요.

uvx thrixel-mcp@latest login

Build World 설치하기

아래에서 코딩 에이전트를 선택하세요. Build World에는 작업 지침을 제공하는 스킬과 에셋 생성 도구를 제공하는 Thrixel MCP 서버가 모두 필요합니다.

claude plugin marketplace add thrixel/build-world
claude plugin install thrixel@thrixel

codex plugin marketplace add thrixel/build-world
codex plugin add thrixel@thrixel

{
  "mcpServers": {
    "thrixel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["thrixel-mcp@latest"]
    }
  }
}

git clone https://github.com/thrixel/build-world ~/.thrixel/build-world
mkdir -p ~/.cursor/skills
ln -s ~/.thrixel/build-world/skills/build-world ~/.cursor/skills/build-world

git clone https://github.com/thrixel/build-world "$HOME\.thrixel\build-world"
New-Item -ItemType Directory -Force "$HOME\.cursor\skills" | Out-Null
New-Item -ItemType Junction -Path "$HOME\.cursor\skills\build-world" -Target "$HOME\.thrixel\build-world\skills\build-world"

gemini mcp add -s user --trust thrixel uvx -- thrixel-mcp@latest
gemini skills install https://github.com/thrixel/build-world --path skills/build-world

Build World 설정 가이드에는 수동 설치, 업데이트, 기존 설치 환경에 관한 안내도 있습니다.

3. Roblox Studio 설정하기

Studio의 MCP 서버를 활성화하면 에이전트가 Studio에서 코드를 실행하고 게임 화면을 캡처할 수 있습니다.

1. Roblox Studio를 열고 새 Baseplate를 만드세요. 게임 월드를 담는 Roblox 파일인 place가 생성됩니다.
2. 창 오른쪽 위의 Assistant 아이콘을 클릭하세요.
3. Assistant 패널에서 … > Settings > Manage MCP Servers를 여세요. Enable Studio as MCP server를 켜세요. 녹색 표시등이 켜지면 서버가 실행 중입니다.

4. Roblox API 키 만들기

Rojo는 3D 모델 파일을 동기화하지 않습니다. 에이전트는 Roblox API 키로 모델을 별도로 업로드합니다.

1. Creator Hub 자격 증명 페이지로 이동하여 Create API Key를 클릭하세요.
2. Access Permissions에서 Assets API 시스템을 추가하세요. 소유자로 자신의 계정을 선택하고 Read와 Write를 활성화하세요.
3. Accepted IP Addresses에 0.0.0.0/0을 추가하거나 IP 제한을 끄세요. 이 필드를 비워 두면 업로드를 완료할 수 없습니다.
4. 이 키는 모든 IP 주소의 접근을 허용하므로 만료 기간을 30일처럼 짧게 설정하세요.
5. Save를 클릭하고 키를 복사하세요. 키는 한 번만 표시됩니다.
6. 게임 폴더의 roblox_api_key.txt 파일에 키를 저장하세요. 이 파일은 Git에 추가하지 마세요.

5. 서버 실행하기

VS Code에서 서버 시작하기

1. VS Code에서 Ctrl + Shift + P(Mac에서는 Cmd + Shift + P)를 눌러 명령 팔레트를 여세요. “Rojo”를 입력하고 Rojo: Open Menu를 선택하세요.
2. 폴더에 Rojo 프로젝트가 없으면 Create one now를 클릭하세요. Rojo가 default.project.json과 게임의 초기 폴더를 추가합니다.
3. Projects in this workspace에서 재생 아이콘 옆의 프로젝트 이름을 클릭하세요.

VS Code 오른쪽 아래에 팝업이 나타나 서버가 localhost의 34872 포트에서 연결을 기다리고 있음을 알려 줍니다. 중지하려면 Rojo 메뉴를 열고 프로젝트를 다시 클릭하세요. 서버 실행 중에는 재생 아이콘이 중지 아이콘으로 바뀝니다.

Roblox Studio를 서버에 연결하기

1. Roblox Studio의 Baseplate place로 돌아가세요.
2. Plugins 탭을 열고 Rojo를 클릭하세요.
3. 서버가 다른 포트를 표시하지 않았다면 주소는 localhost, 포트는 34872로 두세요.
4. Connect를 클릭하세요.
5. “Sync changes for project”에서 Rojo가 place에 적용할 변경 사항을 검토하고 Accept를 클릭하세요.

이제 Rojo 창에 프로젝트 이름, 서버 주소, Disconnect 버튼이 표시됩니다. Studio가 연결되어 변경 사항을 받을 준비가 되었습니다.

Studio가 연결되지 않으면 브라우저에서 http://localhost:34872/를 여세요. Rojo 상태 페이지가 나타나면 서버가 실행 중인 것입니다.

6. 게임 만들기

Thrixel Cubes

Thrixel은 3D 에셋 생성에 Cubes를 청구합니다. 총비용은 사용하는 작업과 게임에 필요한 에셋 수에 따라 달라집니다. 고정 비용인 작업도 있고, 실행 후 사용량에 따라 청구되는 작업도 있습니다. 게임 전체를 만들 때는 코딩 에이전트 요금제의 사용 한도도 상당 부분 소모할 수 있습니다. 큰 작업을 시작하기 전에 잔액을 확인하고, 현재 요금은 Thrixel 웹사이트에서 확인하세요.

Build World 실행하기

1. Rojo 프로젝트가 있는 폴더에서 코딩 에이전트를 여세요.
2. 에이전트에 맞는 Build World 명령으로 메시지를 시작하세요.

   에이전트	명령
   Claude Code	/thrixel:build-world
   Codex	$build-world
   Cursor	/build-world
   Gemini CLI	/build-world

3. 명령 뒤에 게임을 설명하세요. 스킬이 올바른 엔진을 사용하도록 “Roblox”를 포함하세요.
4. Rojo가 이미 실행 중이라는 사실과 포트 번호를 알려 주세요. 그러면 에이전트가 두 번째 서버를 시작하지 않습니다.

Codex에서는 $build를 입력하고 스킬 선택기에서 build-world를 선택한 뒤 게임 설명을 추가하세요.

/thrixel:build-world Roblox에서 떠다니는 섬을 배경으로 장애물 코스 게임을 만들어 줘. Rojo와 Studio 플러그인은 이미 설정되어 있고, Rojo가 포트 34872에서 이 폴더를 제공하고 있으니 다른 서버를 시작하지 마.

Roblox Studio에서 변경 사항 승인하기

처음 Rojo에 연결할 때 변경 사항을 승인합니다. 연결된 뒤에는 에이전트가 변경 사항을 디스크에 저장하는 즉시 Rojo가 동기화합니다.

• 연결할 때: Rojo는 파일과 place의 차이를 나열합니다. Accept를 클릭하면 적용되고, Abort를 클릭하면 연결이 취소됩니다. 차이가 없으면 확인을 요청하지 않고 연결됩니다.
• 에이전트가 작업하는 동안: 새 스크립트와 수정된 스크립트가 Studio에 자동으로 나타납니다. Studio를 닫았거나 연결을 끊었다면 에이전트가 요청할 때 Connect를 다시 클릭하세요. 에이전트는 스스로 Rojo에 다시 연결할 수 없습니다.
• 변경 사항 확인: Rojo 창에서 마지막 변경 시간을 클릭하여 View changes를 여세요. 적용된 변경 사항과 실패한 항목이 표시됩니다. Rojo의 변경 사항은 Studio의 실행 취소 기록에도 남습니다.

동기화 전에 변경 사항을 한꺼번에 검토하려면 Rojo 창의 Settings를 열고 Confirmation Behavior를 Always로 설정하세요. Disconnect를 클릭하고 에이전트의 작업이 끝날 때까지 기다린 다음 Connect를 클릭하여 변경 사항을 함께 검토하세요. 검토는 연결할 때 이루어집니다. 연결 중에 저장된 변경 사항은 여전히 자동으로 동기화됩니다.

수동으로 처리해야 할 일이 두 가지 있습니다.

• 가져온 모델을 저장하세요. Rojo는 스크립트와 인스턴스를 동기화합니다. 에이전트는 3D 모델을 별도로 업로드하여 ReplicatedStorage.Assets에 삽입하므로 이 모델들은 프로젝트 파일에 저장되지 않습니다. Studio에서 File > Save를 사용하여 저장하세요.
• 동기화된 스크립트는 프로젝트 파일에서 편집하세요. Rojo의 양방향 동기화는 기본적으로 꺼져 있습니다. Studio에서 해당 스크립트를 편집해도 파일에 반영되지 않으며 덮어써질 수 있습니다.

7. 게임 게시하기

게임을 공유할 준비가 되면 Studio에서 File > Publish to Roblox를 사용하세요.