uebox

언리얼 박스(UE Box)는 언리얼 에디터를 직접 조작하는 AI Agent로 포지셔닝된 오픈소스 데스크톱 애플리케이션이다. 사용자가 모델 서비스 제공자를 설정하면 UnrealAgentLink 플러그인을 통해 실행 중인 언리얼 에디터에 연결되고, 100여 개의 엔진 도구와 25개의 내장 스킬로 작업을 수행한다: Actor 배치, 블루프린트 수정, 머티리얼 연결, C++ 컴파일 등. 일반 작업은 바로 실행되고, 위험 작업은 일시 중지되어 사용자 확인을 기다린다. 작업 완료 후 Agent는 읽기 전용 도구로 엔진에 돌아가 변경 사항을 검증하고 발견된 문제에 하나씩 대응한다. 커버 범위는 레벨, 블루프린트, 머티리얼, 에셋, C++ 외에도 애니메이션 리타게팅, UMG, Sequencer 카메라, PIE 실행 검증, 지오메트리 편집, 프로젝트 진단을 포함한다. 제품의 주체는 Agent이며, 프로젝트 라이브러리, 에셋 라이브러리, 블루프린트 라이브러리와 머티리얼 라이브러리, 노트와 지식 베이스는 독립적인 인터페이스를 가지며 단독으로도 사용할 수 있지만 제품 구조상 Agent를 위해 봉사한다: 대상 등록, 소재 제공, 산출물 수용. 이 저장소는 커뮤니티 핵심 버전이다: 계정이 필요 없고 공식 서버에 의존하지 않으며 완전히 직접 빌드할 수 있다. 시작 절차: GitHub Releases 또는 공식 웹사이트에서 다운로드하여 설치하고(Windows), 설정에서 모델 서비스 제공자를 추가하고 자신의 API Key를 입력한 뒤 기본 대화 모델을 그것으로 지정한다. 모델은 도구 호출을 지원해야 한다. 로컬 추론(Ollama, LM Studio, llama.cpp)과 자체 게이트웨이(LiteLLM, One API)를 지원한다. 그런 다음 프로젝트 라이브러리에서 .uproject를 가져오면 연결 플러그인이 프로젝트의 Plugins/UnrealAgentLink/ 디렉터리에 자동 설치되며 비활성화하거나 제거할 수 있다. 프로젝트를 열면 플러그인이 자동 연결되며, 사이드바 AI 세션에서 읽기 전용 질문(예: 레벨 광원 수)으로 연결을 확인할 수 있다. Codex, Claude Code 또는 Cursor를 이미 사용하는 사용자는 MCP 스위치를 켜서 언리얼 박스를 도구 서비스로 연결하여 100여 개의 UE 도구를 얻을 수 있다. MCP는 로컬에서만 연결 가능하며 토큰이 필요하고 기본적으로 쓰기 가능하다. 네트워크와 데이터 측면: 계정을 사용하지 않으며 키는 본机에 암호화 저장되고 요청은 사용자가 설정한 서비스 제공자에게 직접 전달되어 프로젝트 측 서버를 거치지 않는다. 기본적으로 업데이트만 확인하고 다운로드하지 않는다. 직접 패키징하고 업데이트 소스를 입력하지 않은 빌드는 네트워크 요청을 보내지 않는다. AI, 웹 검색, 이미지 생성, 클라우드 드라이브 등의 기능은 필요에 따라 연결되며, 로컬 모델 사용 시 AI 데이터는 기기를 떠나지 않는다. 플랫폼 지원: Windows는 설치 패키지를 제공하고 엔진 발견과 사전 빌드된 UnrealAgentLink 플러그인을 지원하며 주력 플랫폼이다. macOS는 소스 빌드가 필요하고 일반 공유 설치 디렉터리의 엔진을 스캔할 수 있으며 엔진 디렉터리나 에디터 .app을 수동으로 추가할 수도 있고 실행 중인 UE4/UE5 에디터와 그 프로젝트 경로를 감지할 수 있지만, 사전 빌드 플러그인의 빌드와 릴리스 검수는 아직 완료되지 않았다. Linux는 소스 빌드가 필요하고 엔진 발견은 아직 적응되지 않았다. 기술 스택은 Electron + Vue 3 + TypeScript이며 Unreal Engine 5.0부터 5.8까지 지원한다. 소스에서 실행하려면 pnpm install과 pnpm dev를 사용한다. 제출 전 pnpm verify를 실행하면 하나의 명령으로 키 스캔, lint, 변경 라인 lint, 타입 검사와 단위 테스트를 수행하며 애플리케이션 실행 중에도 실행할 수 있다. 저장소는 AI 코딩 어시스턴트를 위한 AGENTS.md 규범과 검수 게이트를 제공하며, 사용자는 자연어로 요구 사항을 설명하여 AI 어시스턴트가 아키텍처를 읽고 코드를 수정하고 테스트를 보완하고 검증을 통과하도록 할 수 있다. 라이선스: 애플리케이션은 Apache License 2.0을 채택하고, UnrealAgentLink 플러그인 소스 코드는 plugin/UnrealAgentLink에 위치하며 독립적인 MIT 라이선스를 채택한다. Unreal Engine은 Epic Games, Inc.의 상표이며 이 제품은 Epic Games와 제휴 관계가 없다.