GitHub 오픈소스 탐험

게임 개발자라면 언리얼 엔진(Unreal Engine)이 얼마나 강력한 도구인지 잘 알고 계실 것입니다. 하지만 복잡한 툴과 워크플로우 때문에 개발 과정에서 많은 시간을 소모하기도 합니다. 이번에 소개할 오픈소스 프로젝트인 EpicGames/unreal-engine-skills-for-claude-code-plugin는 이러한 문제를 해결하기 위해 등장했습니다. 이 플러그인을 통해 클로드 코드(Claude Code)에서 직접 언리얼 에디터를 제어할 수 있으며, 수백 개의 도구를 손쉽게 사용할 수 있게 됩니다.

주요 기능과 특징

이 플러그인은 언리얼 엔진의 ToolsetRegistry를 활용하여 30개 이상의 툴셋을 통해 사용할 수 있는 여러 기능을 제공합니다. 예를 들어, 액터, 블루프린트, 재료, 나이아가라, 컨트롤 릭(Control Rigs), 시퀀서, 상태 트리(State Trees), 위젯, 게임플레이 능력 시스템, 자동화 테스트 등 다양한 도구를 지원합니다.

핵심 구성 요소

unreal-mcp: 언리얼 에디터를 제어하기 위한 워크플로우와 지침을 포함합니다.
SessionStart: 프로젝트가 언리얼 엔진 프로젝트임을 식별하는 짧은 노트를 주입하여 클로드가 UE 컨벤션을 따르도록 합니다. 이 스크립트는 startup, resume, clear 시점에 실행됩니다.

설치 가이드

이 플러그인은 Claude Code의 공식 플러그인 마켓플레이스에 게시되어 있습니다. 다음은 설치 방법입니다.

단일 개발자 설치

클로드 코드 환경에서 다음 명령어를 실행합니다:

   /plugin install unreal-engine-skills-for-claude-code@claude-plugins-official

만약 공식 마켓플레이스가 없다면, 먼저 추가한 후 위의 명령어를 실행합니다:

   /plugin marketplace add anthropics/claude-plugins-official

팀 단위 설치

프로젝트의 .claude/settings.json 파일에 다음을 추가하면 해당 프로젝트를 사용하는 모든 팀원이 자동으로 설치할 수 있습니다:

{
  "enabledPlugins": {
    "unreal-engine-skills-for-claude-code@claude-plugins-official": true
  }
}

기본 사용 방법

서버 시작

언리얼 에디터를 실행한 후, 콘솔에서 다음 명령어로 MCP 서버를 시작합니다:

   ModelContextProtocol.StartServer

출력 로그에서 MCP 서버가 시작되었는지 확인합니다.

플러그인 확인

클로드 코드에서 /plugin 명령어를 실행하여 Installed 탭에서 unreal-engine-skills-for-claude-code가 활성화되어 있는지 확인합니다.
/mcp를 실행하여 unreal-mcp 또는 unreal-mcp-proxy가 연결되어 있는지 확인합니다.
다음 명령어를 입력해 보세요:

   List all actors in the current level

이 명령어는 현재 레벨의 모든 액터 목록을 반환합니다.

실무에서의 활용 시나리오

이 플러그인은 복잡한 게임 개발 과정에서 많은 시간을 절약할 수 있습니다. 예를 들어, 대규모 게임 프로젝트에서 많은 액터를 관리하고 있다면, 클로드 코드를 통해 빠르게 액터를 검색하고 수정할 수 있습니다. 또한, 자동화 테스트를 통해 게임의 품질을 높이는 데도 유용하게 사용될 수 있습니다.

비슷한 도구와의 비교

비슷한 기능을 제공하는 도구로는 Visual Studio와 Rider가 있지만, 이들 도구는 언리얼 엔진에 최적화된 특정 기능을 제공하는 데 한계가 있습니다. 반면, 클로드 코드 플러그인은 언리얼 엔진의 다양한 툴셋을 직접적으로 제어하고, 실시간으로 변경 사항을 반영할 수 있는 장점이 있습니다.

클로드 코드로 언리얼 에디터를 제어하는 법