커스텀 컴포넌트

제작자가 정의한 게임적 UI 요소가 채팅에 삽입되는 커스텀 컴포넌트 기능을 안내합니다.

커스텀 컴포넌트란?

커스텀 컴포넌트는 대화 중 퀘스트, 선택지, 레벨업 등의 게임적 요소를 시각적으로 표현하는 기능입니다. 제작자가 캐릭터에 컴포넌트를 설정하면, 대화 중 상황에 맞는 컴포넌트가 자동으로 표시됩니다.

프리셋 컴포넌트 (10종)

제작자가 바로 사용할 수 있는 10종의 프리셋 컴포넌트를 제공합니다.

제작자는 프리셋을 기반으로 커스터마이징하거나, 완전히 새로운 컴포넌트를 만들 수 있습니다.

빌트인 모듈

프리셋 컴포넌트 외에, 별도 설정 없이 사용할 수 있는 빌트인 모듈이 제공됩니다.

스테이터스(상태) 모듈

캐릭터의 현재 상태를 시각적으로 표시합니다. 체력, 기분, 에너지 등 다양한 상태 값을 게이지 바나 아이콘으로 보여줍니다.

호감도 모듈

캐릭터와의 관계도/호감도를 시각적으로 표시합니다. 대화가 진행됨에 따라 호감도가 변화하는 것을 확인할 수 있습니다.

캘린더 모듈

스토리 내 시간 흐름을 달력 형태로 표시합니다. 약속, 이벤트 등 시간 기반 요소가 있는 시나리오에서 유용합니다.

이미지 모듈

대화 중 특정 장면이나 아이템의 이미지를 인라인으로 표시합니다. 제작자가 설정한 에셋 이미지가 대화 맥락에 맞게 표시됩니다.

컴포넌트 위자드

제작자가 코드 작성 없이 GUI로 커스텀 컴포넌트를 만들 수 있는 도구입니다.

• 프리셋을 선택하고 속성(색상, 텍스트, 동작 등)을 조정합니다.
• 미리보기로 실제 채팅에서 어떻게 표시되는지 확인할 수 있습니다.
• 완성된 컴포넌트를 캐릭터에 바로 연결합니다.

컴포넌트 위자드에 대한 상세 안내는 컴포넌트 빌더 가이드를 참고하세요.

상호작용

일부 컴포넌트는 유저의 상호작용을 지원합니다.

선택지 자동 전송

• ChoiceButtons: 선택지 버튼을 클릭하면 해당 선택이 메시지로 자동 전송됩니다. 별도로 입력할 필요가 없습니다.
• DialogueChoice: 대사형 선택지를 클릭하면 해당 대사가 자동 전송됩니다.

테마 연동

• 캐릭터에 설정된 테마에 따라 컴포넌트의 시각적 스타일이 변경됩니다.
• 색상, 폰트, 아이콘 스타일 등이 테마에 맞춰 자동 조정됩니다.

트러블슈팅

컴포넌트가 표시되지 않는 경우

• 해당 캐릭터의 제작자가 컴포넌트를 설정하지 않았을 수 있습니다.
• 모든 캐릭터에 컴포넌트가 포함되어 있는 것은 아닙니다.
• 컴포넌트는 대화 맥락에 따라 AI가 판단하여 표시합니다. 특정 상황에서만 나타나도록 설정되어 있을 수 있습니다.

컴포넌트가 깨져 보이는 경우

• 브라우저를 새로고침해 보세요.
• 다크 모드/라이트 모드를 전환해 보세요.
• 문제가 지속되면 해당 캐릭터의 제작자에게 알려주세요.

선택지를 클릭해도 반응이 없는 경우

• 이미 선택이 완료된 컴포넌트일 수 있습니다. 한 번 선택하면 재선택이 불가능한 경우가 있습니다.
• 네트워크 연결 상태를 확인해 보세요.