설치

기본 의존성

1. Konado 플러그인 설치(필수)
2. Godot .NET 4.7.1 이상
3. 프로젝트를 Godot .NET 에디터로 열어야 합니다. 일반 Godot 에디터는 C# 애드온 스크립트를 컴파일하거나 로드할 수 없습니다.

설치 단계

1. konado_dotnet 플러그인을 Godot 프로젝트의 addons 디렉터리에 압축 해제합니다
2. 기본 addons/konado 플러그인도 프로젝트에 있는지 확인합니다
3. Godot 에디터에서 Project -> Project Settings -> Plugins로 이동해 먼저 Konado를 활성화합니다
4. C# 프로젝트를 빌드하고 MSBuild 오류가 없는지 확인합니다
5. Konado.NET 플러그인을 활성화합니다
6. 프로젝트를 다시 열어 자동 로드 노드와 C# 스크립트 상태를 갱신합니다

처음 활성화할 때의 흔한 오류

C# 프로젝트를 아직 빌드하지 않았다면 다음 오류가 나타날 수 있습니다.

Unable to load addon script from path: 'res://addons/konado_dotnet/editor/KonadoDotNetPlugin.cs'.

Godot .NET 에디터에서 프로젝트를 빌드한 뒤 다시 열고 플러그인을 활성화하세요.

활성화 순서

Konado.NET은 기본 Konado 플러그인에 의존합니다. 다음 순서로 활성화하세요.

1. Konado 활성화
2. C# 프로젝트 빌드
3. Konado.NET 활성화

Konado.NET을 먼저 활성화하면 기본 플러그인의 상태를 확인하며, 기본 플러그인이 비활성화된 동안에는 API 자동 로드 노드를 등록하지 않습니다.

장면 요구 사항

DialogueManagerApi에는 전체 공개 API 계약을 충족하는 KonadoDialogueManager 노드가 필요합니다. 노드가 장면 트리에 들어오면 자동으로 바인딩되며 노드 이름에는 의존하지 않습니다.

대화 관리자가 여러 개라면 수동으로 바인딩하세요.

using Godot;

var manager = GetNode<Node>("UI/KonadoDialogueManager");
Konado.Runtime.Api.KonadoApi.DialogueManagerApi?.BindDialogueManager(manager);