프로젝트 소개
UnrealAgentPlayer는 AI 코딩 에이전트(Claude Code, Cursor 또는 Claude Desktop 등)가 Unreal Editor와 자율적으로 상호작용할 수 있도록 설계된 툴셋입니다. 이 시스템은 C++ 에디터 플러그인과 Python MCP(Model Context Protocol) 서버로 구성되어 있으며, 에이전트가 사람의 개입 없이 편집, 컴파일, 실행 및 변경 사항 검증의 전체 사이클을 수행할 수 있게 합니다.
주요 기능은 다음과 같습니다:
- PIE 제어: Play-In-Editor 세션의 시작, 중지, 일시 중지 및 재개.
- 입력 주입: 윈도우 포커스와 관계없이 키보드, 마우스, 게임패드 및 VR 컨트롤러 입력을 게임 뷰포트에 직접 주입.
- 관찰: 필터링을 통한 로그 캡처, 화면상의 UMG UI 텍스트 읽기 및 뷰포트 스크린샷 촬영.
-로 내부 조사: 액터 찾기, 속성 가져오기/설정 및 임의의 Python 에디터 스크립트 또는 콘솔 명령 실행.
- 성능 추적: 실시간 드로우/GPU 타이밍을 읽고 성능 베이스라인을 저장 및 비교하여 성능 저하 감지.
- 테스트 프레임워크: 프로젝트 전용 Blueprint/C++ 테스트 헬퍼를 자동으로 검색하고 상세한 HTML 실행 보고서 생성.
- 에디터 자동화: Windows UIAutomation을 통해 네이티브 에디터 메뉴 제어.
이 시스템은 Windows 환경의 Unreal Engine 5.6, 5.7 및 5.8(Meta 5.7 포크 포함)을 지원합니다. MCP 서버와 에디터 간의 통신을 위해 Remote Control HTTP 및 Python Remote Execution을 활용합니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.