# Naninovel

Naninovel을 사용하면 작가 친화적인 스토리텔링 도구가 모두 포함된 올인원 제품군으로 비주얼 노벨, 분기형 대화, 인터랙티브 컷신을 제작할 수 있습니다.

<a href="https://prf.hn/click/camref:1100lf9cL/pubref:docspage/destination:https://assetstore.unity.com/packages/tools/game-toolkits/naninovel-visual-novel-dialogue-cutscene-storytelling-engine-for-135453" class="button primary">Naninovel 받기</a> *(제휴 링크)*

Text Animator가 Naninovel과 함께 작동하는 예시:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FApMl3WFLxSr6qI9DE0at%2FNaninovel%20Text%20Animator%203%20integration.mp4?alt=media>" %}

***

### 요구 사항

{% hint style="info" %}
Naninovel 버전과 함께 Text Animator 3.X를 테스트했습니다 **1-21-stable**

Naninovel의 모든 버전에서 작동해야 합니다 **1.X**, 하지만 일부 호환성 깨짐 변경이 도입된 것을 발견하시면 알려 주세요!
{% endhint %}

{% hint style="warning" %}
Naninovel의 타자기(서서히 표시) 기능을 사용하려면, **Text Animator의 타자기 기능을 비활성화해야 합니다** - 그렇지 않으면 서로 충돌하여 두 기능을 모두 문제없이 사용할 수 없습니다. 죄송합니다! 플러그인 구조나 안정성을 변경하지 않기 위해 필요한 절충안이지만, 필요에 따라 언제든지 두 애셋을 수동으로 확장할 수 있습니다.
{% endhint %}

### 통합 단계

애니메이션을 적용하고 싶은 모든 텍스트(예: 텍스트 프린터)에 대해:

{% stepper %}
{% step %}

#### "Text Animator" 컴포넌트 추가

같은 GameObject에 Text Animator 컴포넌트를 추가해야 하며, 여기에 **TMPro 텍스트**.

<figure><img src="/files/cb3e2ce6b45330890f06c7a06402baecf2bae086" alt=""><figcaption></figcaption></figure>

텍스트에 사용자 지정의 이미 적용된 효과(예: 나타날 때 회전과 흔들림)를 적용하고 싶다면, 인스펙터에서 기본 태그를 설정해야 합니다. 자세한 내용은 여기에서 읽어보세요: [효과 추가 방법](/text-animator-unity/3.x-ko/effects/how-to-add-effects.md)
{% endstep %}

{% step %}

#### "Reveal Fader" 제거(있는 경우)

"Revealable" 텍스트가 있다면, 반드시 **제거** 하여 "Reveal Fader" 컴포넌트를 완전히 제거해야 합니다. 인스펙터는 다음과 같아야 합니다:

<figure><img src="/files/934577d866441a168b257e4900fc5f55cf1a5b41" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

이제 끝입니다!!

가장 일반적인 설정은 다음을 갖는 것입니다 **텍스트 프린터** 안에 애니메이션 텍스트 콘텐츠가 있는 경우입니다. 그렇게 하려면, 다음을 할 수 있습니다&#x20;

{% stepper %}
{% step %}

#### 텍스트 프린터 설정

1. 애니메이션 텍스트가 있는 텍스트 프린터를 만들려면, 이미 존재하는 것을 수정하거나(예: Naninovel 플러그인 폴더 안의 "Fullscreen") 완전히 새로 만들 수 있습니다(예: "Fullscreen" 프리팹을 복제하여 "FullscreenTAnim"으로 이름 지정)
2. 애니메이션을 적용하려는 모든 텍스트를 찾아 위의 단계를 적용하세요(TAnim 컴포넌트 추가 + Revealable Fader 제거)
   {% endstep %}

{% step %}

#### 대상 텍스트 프린터 추가 또는 수정

기존 텍스트 프린터를 수정했거나 새로 만들었다면, Project Settings / Naninovel의 "Text Printers" 카테고리에서 해당 항목이 존재하고 올바르게 설정/할당되었는지 확인하세요.&#x20;

<figure><img src="/files/14af4e960a5a103c4aa648e45a2a27b06e2ba04e" alt=""><figcaption></figcaption></figure>

사용자 지정 프린터 추가에 관한 Naninovel 문서:

{% embed url="<https://naninovel.com/guide/text-printers#adding-custom-printers>" %}
{% endstep %}

{% step %}

#### 백로그 캔버스 / 메시지 수정

대화에 리치 텍스트 태그가 있고, 특히 **텍스트 프린터**에 표시되는 경우, 해당 태그를 표시할 모든 텍스트(예: 백로그)에 "Text Animator" 컴포넌트를 추가하고 싶을 것입니다. 그렇지 않으면 Text Animator 태그를 인식하지 못하는 프리팹/컴포넌트가 하나 생겨 텍스트에 태그가 그대로 표시될 위험이 있습니다.

수정해야 하며 Text Animator 컴포넌트가 있는지 확인해야 하는 가장 일반적인 오브젝트는 **백로그**.

항상 그렇듯 -> 수정하려는 프리팹을 찾아 Text Animator 컴포넌트를 추가하세요. ("Reveal fader"가 있다면 제거하세요.)

<figure><img src="/files/5e5a8ddab2567e0d4f8fb7777e0f8737a22408bc" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.febucci.com/text-animator-unity/3.x-ko/integrations/integrated-plugins-and-dialogues-systems/naninovel.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.