확장
AnimationPlayer, CSG, GridMap, 내비게이션, 파티클, TileMapLayer, Beehave, Dialogic, Phantom Camera, Terrain3D용 선택적 Godot MCP 확장을 설치하세요.
확장은 Godot MCP에 Godot의 더 많은 부분과 인기 있는 Godot 애드온에 대해 알려주는 선택적 NuGet 패키지입니다. 프로젝트에 필요한 것만 설치하세요. 이 페이지에서는 확장 목록을 나열하고, 작동 방식을 설명하며, 설치하는 세 가지 방법을 보여줍니다. 각 확장에 대한 설명과 예제는 사이트의 Godot extensions 페이지에 있습니다.
확장의 작동 방식
각 확장은 RQL 모듈입니다. 자체적인 MCP 도구는 추가하지 않습니다. 대신 핵심 rql-query, rql-mutate, rql-schema 도구를 새로운 소스, 검증된 속성 및 호출로 확장하고, 에이전트의 godot-rql 스킬에 가이드를 추가합니다. 에이전트의 도구 목록 크기는 그대로 유지되며, 에이전트는 rql-schema를 통해 새로운 영역을 학습합니다:
rql-schema "Particles"패키지에는 C# 소스와 빌드 설정이 포함되어 있으며, 프로젝트 자체의 GodotSharp에 맞춰 컴파일됩니다. 각 확장은 자체 버전과 릴리스 주기를 가집니다.
사용 가능한 확장
| 확장 | 패키지 id | 추가하는 기능 | 요구 사항 |
|---|---|---|---|
| Animation Tools | com.IvanMurzak.Godot.MCP.Animation | AnimationPlayer 라이브러리, 애니메이션, 트랙 및 키 | Godot 4.3+ |
| Beehave Tools | com.IvanMurzak.Godot.MCP.Beehave | 행동 트리와 그 노드 나열 | Beehave 애드온, Godot 4.3+ |
| CSG Tools | com.IvanMurzak.Godot.MCP.CSG | 검증된 CSG 프리미티브 크기와 rootShape | Godot 4.3+ |
| Dialogic Tools | com.IvanMurzak.Godot.MCP.Dialogic | 타임라인과 캐릭터 나열 및 생성, 타임라인 텍스트 추가 | Dialogic 애드온, Godot 4.4+ |
| GridMap Tools | com.IvanMurzak.Godot.MCP.GridMap | GridMap 설정, 셀 행 및 셀 편집 | Godot 4.3+ |
| Navigation Tools | com.IvanMurzak.Godot.MCP.Navigation | 2D 및 3D 내비게이션 에이전트, 리전, 링크 및 리전 베이킹 | Godot 4.3+ |
| Particles Tools | com.IvanMurzak.Godot.MCP.Particles | 2D 및 3D GPU 파티클: 검증된 이미터 설정과 재시작 | Godot 4.3+ |
| PhantomCamera Tools | com.IvanMurzak.Godot.MCP.PhantomCamera | 가상 카메라와 호스트 나열, 팔로우 및 룩앳 대상 설정 | Phantom Camera 애드온, Godot 4.4+ |
| Terrain3D Tools | com.IvanMurzak.Godot.MCP.Terrain3D | 지형 소스, 리전 크기 변경 및 머티리얼 생성 | Terrain3D 애드온, Godot 4.4+ |
| Tilemap Tools | com.IvanMurzak.Godot.MCP.Tilemap | TileMapLayer 사용된 셀 행 및 셀 편집 | Godot 4.3+ |
모든 확장은 RQL 도구가 포함된 핵심 애드온도 필요로 합니다(0.28.0 이후의 모든 릴리스).
godot-cli로 설치
godot-cli install-extension com.IvanMurzak.Godot.MCP.CSG ./MyGodotProject
godot-cli build ./MyGodotProjectinstall-extension은 확장 카탈로그에서 id를 조회합니다. 패키지 id를 먼저 찾고, 그다음 이름을 대소문자 구분 없이 찾습니다(따라서 "CSG Tools"도 작동합니다). 그런 다음 프로젝트의 .csproj에 <PackageReference>를 추가하거나 업데이트합니다:
- 아직 참조되지 않음: 참조가 추가됩니다.
- 이전 버전이 참조됨: 업데이트됩니다.
- 이미 최신 상태: 아무것도 변경되지 않습니다.
--version 없이 실행하면 참조가 NuGet의 최신 안정 릴리스로 유동적으로 지정됩니다(Version="*"). 정확한 버전을 지정하려면 --version <x.y.z>를 사용하세요. 설치 후에는 Godot가 패키지를 복원하고 컴파일할 수 있도록 프로젝트를 빌드하세요. Godot에는 자동 복원 단계가 없습니다.
독에서 설치
AI Game Developer 독의 Extensions 섹션에는 Install 및 Update 버튼과 함께 동일한 카탈로그가 나열됩니다. CLI와 같은 방식으로 .csproj를 편집합니다. 그 후 다시 빌드하세요. 독에 .csproj를 찾을 수 없다고 표시되면 애드온이 Godot C# 프로젝트 안에 있지 않은 것입니다.
AI Game Dev 앱에서 설치
Godot 프로젝트의 경우 AI Game Dev app은 사이드바에 Extensions 버튼을 표시하며, 이 버튼을 누르면 동일한 카탈로그가 열리고 godot-cli와 동일한 코드로 설치됩니다. 슬래시 명령 /install-extension도 앱의 채팅에서 같은 작업을 수행합니다. 인수 없이 실행하면 카탈로그를 나열하고, id와 함께 실행하면 현재 프로젝트에 설치합니다. 엔진 확장은 앱 자체의 패키지와 다릅니다.
확장 카탈로그
확장 목록은 애드온과 함께 제공되는 addons/godot_mcp/extensions.catalog.json에 있습니다. 독, godot-cli, 앱 모두 이 하나의 파일을 읽습니다. 독은 컴파일된 프로젝트에서 이 파일을 읽으므로 .csproj에 이 파일을 포함해야 합니다:
<ItemGroup>
<EmbeddedResource Include="addons/godot_mcp/extensions.catalog.json" LogicalName="Godot-MCP.extensions.catalog.json" />
</ItemGroup>godot-cli install-plugin과 앱이 이 줄을 대신 추가합니다. 직접 설치했는데 Extensions 목록이 비어 있다면 이 줄이 빠진 것입니다. 이 줄을 추가하고 다시 빌드하세요. Installation을 참고하세요.
확장 사용하기
빌드 후에는 그냥 요청하면 됩니다. 예를 들어 CSG Tools가 설치되어 있다면:
- "3x3x3 박스로 CSG 결합기를 만들고 그에서 반지름 1.8인 구를 빼세요."
- "씬에 있는 모든 CSG 도형을 연산과 크기와 함께 나열하세요."
에이전트는 rql-mutate로 노드를 생성하고(호출마다 실행 취소 가능한 한 단계), rql-query로 결과를 확인합니다. 음수 반지름처럼 잘못된 값은 전체 변경을 실패시키고 씬을 그대로 둡니다.
나만의 확장 만들기
Godot-MCP 저장소에는 확장 템플릿(templates/extension/)과 모듈 빌드, 테스트, 릴리스에 관한 모노레포 가이드가 있습니다. 일회성 프로젝트 도구라면 일반 사용자 정의 도구가 더 간단합니다.