대화 인터페이스 사용자 지정

소개

대화 인터페이스를 사용자 지정하려면 사용할 템플릿 씬을 res://ui/dialogue/ 같은 프로젝트 전용 디렉터리로 먼저 복사한 뒤, 그 사본이나 Godot 사용자 지정 테마를 편집하세요.

res://addons/konado/ 아래 파일을 직접 수정하지 마세요. 플러그인 업그레이드는 플러그인 디렉터리를 교체합니다. 프로젝트 소유 사본은 Konado를 업그레이드해도 유지됩니다.

템플릿 파일 편집

res://addons/konado/templates/에는 기본 대화 템플릿이 있습니다. 필요한 .tscn을 프로젝트로 복사하고 대화 씬에서 그 사본을 인스턴스화한 다음, 포함된 KonadoDialogueBox 노드를 KonadoDialogueManager의 dialogue_box 속성에 할당하세요.

일반적으로 노드의 스크립트는 수정하지 말고, 노드의 속성을 수정해 사용자 지정 효과를 구현하세요.

표시 API

KonadoDialogueBox는 일시적으로 숨기는 동작과 내용을 폐기하는 동작을 별도 API로 제공합니다.

dialogue_box.hide_dialogue_box()
dialogue_box.hide_dialogue_box_with_duration(0.5)

dialogue_box.dismiss_dialogue_box()
dialogue_box.dismiss_dialogue_box_with_duration(0.5)

hide_dialogue_box*()는 나중에 다시 표시할 수 있도록 현재 화자 이름과 대화문을 유지합니다. dismiss_dialogue_box*()는 숨기기 애니메이션이 끝난 뒤 해당 내용을 지우며, 현재 대화 내용을 종료할 때 사용합니다. KonadoScript의 hidetextbox 명령은 후자의 동작을 사용합니다.

UI 레이어 규칙

씬 트리 순서에 따라 전체 화면 UI가 서로 가려지지 않도록 기본 UI는 다음 CanvasLayer.layer 값을 사용합니다.

레이어	용도
1	무대, 배경 및 연출 콘텐츠
10	대화 상자, 선택지 및 대화 도구 모음
50	저장 화면
100	설정과 업적 같은 모달 패널
110	업적 해금 같은 일시적인 알림
120	모든 기본 UI보다 위에 표시되어야 하는 런타임 오류

사용자 지정 UI는 용도에 맞는 범위에 배치하세요. 시스템 오류 메시지를 덮어야 하는 경우가 아니라면 120 이상을 사용하지 마세요. 업적 패널과 알림 레이어는 KonadoAchievements.panel_layer 및 popup_layer로 조정할 수도 있습니다.

음성 진행 표시 사용자 지정

일반 대사에 음성 태그가 있고 오디오가 재생 중이면 대화 상자에 재생 진행 상태가 표시됩니다. 음성이 없거나 리소스를 확인할 수 없거나 재생이 끝나면 자동으로 숨겨집니다. 필요하지 않다면 KonadoDialogueBox 노드의 show_voice_progress를 끄세요.

기본 컴포넌트 원본은 res://addons/konado/templates/default/voice_progress_display.tscn입니다. 색상, 둥근 모서리, 크기 또는 노드 구조를 수정하기 전에 프로젝트로 복사하고 사용자 지정 대화 상자에서 그 사본을 참조하세요. 완전히 교체할 때는 다음 인터페이스를 유지해야 합니다.

func set_progress(current: float, total: float) -> void
func hide_progress() -> void