> For the complete documentation index, see [llms.txt](https://rplaylive.gitbook.io/creatorguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rplaylive.gitbook.io/creatorguide/storychat/storychat/faq.md).

# 제작 FAQ

만들면서 자주 부딪히는 문제와 해결 방법입니다.

## 여러 캐릭터가 등장하는 채팅을 만들고 싶은데, 어떻게 하면 캐릭터들이 자연스럽게 등장할 수 있을까요?

이야기 전개에 따라 캐릭터가 자연스럽게 등장하게끔 하려면 스토리 노드의 중요 정보에 해당 캐릭터가 등장할 수 있는 최소한의 정보가 필요합니다. 목록이나 표 형식으로 캐릭터의 이름, 역할, 첫 등장에서 사용해야 할 최소한의 정보(대략적인 성격이나 외모 등)을 정리해 주세요.

이후 그 캐릭터가 등장했을 때 반드시 지켜야 할 캐릭터성은 인물 노드 중요 정보에, 세부적인 설정은 상세 설정에 적어주시면 됩니다. 스토리 노드 중요 정보에 적는 내용이 많을 수록 정보 활용도가 높아지니, 인물의 비중에 따라 적절히 배치를 배분해 주세요.

## 프로필 이미지가 제대로 표시되지 않습니다

**인물의 이름과 대사 출력 형식을 확인해 보세요.**

스토리챗에서 캐릭터의 대사는 이 형식으로 출력됩니다.

```
[이름]: "캐릭터의 대사." (이미지 구성을 위한 태그)
```

인식된 이름에 맞춰 그 인물에 연결된 프로필·감정 이미지를 찾습니다. **인물 노드의 이름과 `[이름]:` 형식을 통일**하면 확인하기 쉽습니다. 이름을 알아보지 못하거나 맞는 이미지가 없으면 표시되지 않을 수 있습니다.

### 해결 방법

* **인물 노드의 이름과 `중요 정보`·`전체 스토리`에서 쓰는 이름을 통일**하세요
* 풀네임과 호칭이 여럿이면 **가장 일반적으로 쓸 이름(통칭)** 을 인물 노드 이름으로 두고, 나머지는 `중요 정보`에 목록으로 정리하세요

{% hint style="success" %}
**`중요 정보` 작성 예시**

```
## 핵심 등장인물
User: 주인공
리터: 리터 헥마토르. 기사.
나루: 나루세가와 나루미. 마법사.
```

인물 노드의 이름은 `리터`·`나루`처럼 통칭으로 통일합니다.
{% endhint %}

* **`시작 메시지`에 출력 형식에 맞춘 대사를 미리 적어 두세요.** 이후 답변에서도 같은 형식을 쓰도록 유도하는 데 도움이 됩니다

{% hint style="success" %}
**`시작 메시지` 예시**

```
눈 앞에는 오늘부터 새롭게 동료가 된 두 사람이 서 있다.

[리터]: "리터 헥마토르. 왕국의 기사다. 잘 부탁한다."

[나루]: "마법사, 나루세가와 나루미라고 합니다."
```

대사의 위아래에는 **빈 줄을 하나씩** 두고, 그 빈 줄에 **공백이 들어 있지 않은지** 확인하세요.
{% endhint %}

## 상황에 맞지 않는 이미지가 표시됩니다

**원하는 이미지가 실제로 등록되어 있는지, 인물 연결과 태그 분류가 맞는지 확인하세요.**

태그 이름과 카테고리 설명은 이미지 선택을 돕습니다.

자세한 원리와 요령은 [이미지와 태그](/creatorguide/storychat/storychat/images.md)에서 다룹니다.

{% hint style="danger" %}
**출력 지시만으로 원하는 이미지가 반드시 선택되는 것은 아닙니다.** 등록되지 않은 이미지를 새로 만들어 표시하지도 않습니다.

원하는 상황에 쓸 이미지와 태그를 준비하고, **어떤 상황에 어떤 태그를 쓸지**를 안내한 뒤 실제 대화에서 확인하세요. 구체적인 설계 예시는 [이미지 출력 제어](/creatorguide/storychat/storychat/prompting/prompting-images.md)를 참고하세요.
{% endhint %}

## `중요 정보`와 `전체 스토리`는 어떻게 다릅니까

**`중요 정보`는 매 턴 반드시 필요한 지침과 정보를 두는 자리입니다.**

|            | 어떻게 쓰이나                           | 무엇을 적나                       |
| ---------- | --------------------------------- | ---------------------------- |
| **중요 정보**  | 매 대화마다 AI에게 **그대로 전달**됩니다         | 항상 따라야 할 지침, 잊으면 안 되는 정보     |
| **전체 스토리** | 필요한 정보를 **추출해 만든 배경 설정집**으로 활용됩니다 | 도입부, 인물 소개, 이야기 흐름 등 전체적인 정보 |

인물 노드의 `상세 설명`도 `전체 스토리`와 같은 방식으로 쓰입니다.

{% hint style="success" %}
**쉽게 나누는 방법**

1. 먼저 **`전체 스토리`** 에 들어갈 내용을 다 적습니다
2. 그 글을 AI에게 주고 "이야기 전개에 필수적인 지침과 정보만 간략하고 구조적으로 정리해 달라"고 요청합니다. `중요 정보`는 칸의 토큰 카운터 한도 안에 들어와야 합니다
3. 그 결과를 **`중요 정보`** 에 넣습니다
   {% endhint %}

## 원하는 대로 스토리 단계를 제어하기 힘듭니다

**수치 요소를 도입해 보세요.**

**"충분한 대화를 나눈 뒤"**, **"친밀한 상태일 때만"** 같은 조건은 해석이 달라질 수 있습니다. "최소 10차례의 대화 후"라고 적는 것만으로 횟수가 정확하게 유지된다고 보장할 수도 없습니다.

진행 횟수나 호감도를 변수로 두고 업데이트 규칙과 트리거로 조건을 구체화하세요. 아래처럼 답변에 수치를 표시하는 방식은 간단히 시도할 수 있지만, AI가 이어 쓰는 값이 정확한지도 확인해야 합니다.

{% hint style="success" %}
**`중요 정보` 작성 예시 — 일정 횟수·호감도 이상일 때만 허용하기**

```
## 출력 추가 지침
- 매 답변 마지막에 다음 양식에 따라 현재 턴 수와 User에 대한 은하의 호감도를
  출력하고 최신화하세요:
  [현재 <Turn>턴 | 은하❤️ <Value>]

## 은하의 행동 지침
- User의 신체 접촉 허용 조건: 10턴 이상, ❤️80 이상
- 조건 미충족 상태에서 신체 접촉 시도: User와의 모든 대화를 즉시 종료합니다.
```

{% endhint %}

이 방식을 응용하면 현재 시간·소지금처럼 다양한 값을 계속 표시하고 증감을 따라가는 **상태창을 글만으로** 만들 수 있습니다.

{% hint style="info" %}
더 정확한 제어가 필요하다면 **변수와 트리거**를 쓰세요. 조건을 만족했을 때 다른 스토리 노드로 넘길 수 있습니다. [노드 레퍼런스](/creatorguide/storychat/storychat/nodes.md)와 [AVA 뜯어보기](/creatorguide/storychat/storychat/samples/sample-ava.md)를 보세요.

글로 만든 상태창은 **AI가 이어 쓰는 것**이라 값이 튈 수 있습니다. 변수는 시스템이 보관합니다.
{% endhint %}

## 답변이 비어서 나옵니다

일시적인 생성 오류나 모델의 응답 제한 등 여러 원인이 있을 수 있습니다. 빈 답변이라는 이유만으로 원인을 확정할 수는 없습니다.

종량모드 방에서는 **오류로 대화에 남지 않은 응답(빈 응답, 시간 초과 등)에는 크레딧이 차감되지 않습니다.** 빈 응답은 자동으로 몇 번 다시 시도하며, 재시도 때문에 추가로 차감되지는 않습니다. 다만 검열 등으로 중간에서 끝났더라도 대화에 남은 답변과 리롤 후보는 일반 답변처럼 차감되므로, 답변이 계속 비어 나오거나 끊긴다면 아래 대응 방법부터 확인하세요.

### 대응 방법

* 검열을 유발할 만한 표현이 프롬프트에 있는지 확인하세요. 특히 성인 작품이라면 **과거 이야기 등에 미성년 연령 표기처럼 오해를 부를 내용**이 없는지 검토해 주세요
* 재생성 요청 뒤의 오류 안내를 확인하세요. 확정 답변을 삭제하면 바로 앞 내 메시지부터 이후 대화가 함께 지워지므로, 필요한 기록을 복제한 뒤 판단하세요
* 다른 모델로 답변을 받은 뒤 원래 모델로 되돌리는 방법도 있습니다

## 채팅 내용이 사라졌습니다

**대화가 보이지 않는 이유는 화면만으로 확정할 수 없습니다.** 불러오기가 끝났는지 확인하고 다시 접속해 보세요.

계속 대화가 표시되지 않으면 방을 삭제하거나 내용을 덮어쓰기 전에 고객센터에 **채팅방 링크와 발생 시점**을 전달해 확인을 요청하세요. 공개 커뮤니티에는 비공개 대화 내용이나 개인 정보를 올리지 마세요. 복구 가능 여부는 확인이 필요합니다.

## 댓글을 고정할 수 있나요?

댓글 관리 권한이 있으면 최상위 댓글의 메뉴에서 **`전체 고정`** 또는 **`언어별 고정`** 을 고를 수 있습니다. 숨긴 댓글은 고정할 수 없습니다.

| 메뉴       | 동작                                              |
| -------- | ----------------------------------------------- |
| `전체 고정`  | 모든 언어 이용자에게 그 댓글을 고정합니다                         |
| `언어별 고정` | 고른 언어(한국어·日本語·English·中文·繁體中文·Español)에서만 고정합니다 |

고정된 댓글에는 `고정됨 · 범위` 배지가 붙습니다. 같은 범위에 이미 고정된 댓글이 있으면 새로 고정한 댓글로 **교체**되고, 한 댓글의 고정 범위를 바꾸면 이전 범위의 고정은 풀립니다.

## 신작을 업로드했는데 메인에 표시되지 않습니다

**크리에이터 등록이 되었는지 확인해 주세요.**

무분별한 콘텐츠 범람을 막고 체계적으로 관리하기 위해 **크리에이터 등록을 마친 분의 콘텐츠만 메인에 노출**하고 있습니다. 이 가이드의 [크리에이터 등록 및 기본 설정](/creatorguide/howto/begin.md)에서 신청 폼을 작성해 주세요.

또한 신작은 업로드 즉시 표시되는 것이 아니라 **사이트 캐시 갱신과 함께 노출**되므로, 업로드 시점에 따라 최대 1시간 전후가 걸릴 수 있습니다.

## 제작 목록에 느낌표가 표시됩니다

작품을 열고 각 언어 캔버스의 컴파일 상태를 확인하세요. 저장만 하고 컴파일하지 않았거나 컴파일에 실패한 캔버스가 있는지 살펴본 뒤, 오류를 해결하고 다시 컴파일합니다. 자세한 확인 순서는 [컴파일](/creatorguide/storychat/storychat/compile.md)을 참고하세요.

## 종량모드가 내 작품 수익에 영향을 주나요?

종량모드에서는 이용자에게 **답변마다 실제로 쓰인 토큰만큼** 크레딧이 차감됩니다. 작품 수익의 정산 기준과 비율은 정책 문서가 기준이며, 이 가이드에는 수치를 따로 적지 않습니다. [비용 정산](/creatorguide/termsandpolicies/fee.md)에서 확인하세요.

## 제작 정보가 길면 이용자 비용이 오르나요?

**네, 종량모드에서는 더 직접적으로 오릅니다.** 매 턴 AI에게 전달되는 칸의 분량이 그대로 이용자의 입력 토큰이 되기 때문입니다.

| 칸                    | 비용에 미치는 영향                    |
| -------------------- | ----------------------------- |
| 스토리 노드·인물 노드 `중요 정보` | 매 턴 전달되므로 **길수록 매 답변이 비싸집니다** |
| 선택된 매크로 프롬프트·프리셋 노트  | 실린 만큼 입력 토큰이 늘어납니다            |
| `프롬프트 입력 확장`으로 늘린 분량 | 별도 요금은 없고, 늘어난 입력 토큰으로 계산됩니다  |
| `전체 스토리`·인물 `상세 설명`  | 필요한 부분만 불려 오므로 부담이 적습니다       |

꼭 필요한 규칙과 장면의 핵심만 `중요 정보`에 두면 이용자 비용을 줄이는 데 도움이 됩니다. 칸별 분량은 [분량 한도](/creatorguide/storychat/storychat/limits.md)를, 쓰는 요령은 [프롬프트 구성](/creatorguide/storychat/storychat/prompting/prompting-writing.md)을 보세요.

## 작품이 차단되었다는 알림을 받았습니다

차단된 작품에 대한 알림은 **`콘텐츠 차단 안내`** 팝업 하나로 모여 나옵니다. 팝업에서 **차단 기간과 사유 목록**을 확인할 수 있습니다. 사유를 확인한 뒤 [스토리챗 제작 가이드라인](/creatorguide/termsandpolicies/rplayguideline-1.md)에 맞게 작품을 점검하세요.

## 작품 정산은 어떻게 받나요?

[비용 정산](/creatorguide/termsandpolicies/fee.md)에서 정산 일정·신청 요건과 신청 경로를 확인하세요.

## 작품 업로드 시 주의해야 할 점이 있나요?

[스토리챗 제작 가이드라인](/creatorguide/termsandpolicies/rplayguideline-1.md)을 먼저 확인하세요.

## 만든 대로 동작하지 않습니다

가장 흔한 원인들은 [자주 하는 실수](/creatorguide/storychat/storychat/samples/mistakes.md)에 모아 두었습니다. 특히 이 둘을 먼저 확인하세요.

* **컴파일했는가**
* **스토리 노드까지 선이 이어져 있는가**

### 직접 들여다보기

**자기가 만든 작품의 채팅방에서는 제작자에게만 보이는 확인 창이 열립니다.**

* **스토리 상태** — 지금 어느 스토리 노드에 있는지, 변수 값이 얼마인지 실제 값을 그대로 보여 줍니다
* **이미지 태그** — 답변에 포함된 이미지 태그를 확인합니다. 이미지가 선택되지 않은 이유 전체를 설명하는 화면은 아닙니다

{% hint style="success" %}
**변수·업데이트 규칙·트리거가 의심될 때 가장 빠른 길입니다.**

값이 안 오르는지, 오르는데 조건이 안 맞는지, 아니면 애초에 변수가 만들어지지 않았는지를 추측하지 말고 여기서 직접 보세요. 이용자 화면에는 나오지 않습니다.
{% endhint %}

***