# 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="https://1326131491-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2Fkx7V4oiiqtiOFP9y0np8%2FScreenshot%202026-04-01%20alle%2017.00.06.png?alt=media&#x26;token=8ec74528-c1e9-4482-8cb2-4ef3c5a8b6d5" alt=""><figcaption></figcaption></figure>

如果你希望文本带有自定义、已应用的效果（例如出现时旋转和抖动），请确保在检查器中设置默认标签。更多内容请看这里： [ru-he-tian-jia-xiao-guo](https://docs.febucci.com/text-animator-unity/3.x-zh/xiao-guo/ru-he-tian-jia-xiao-guo "mention")
{% endstep %}

{% step %}

#### 移除“Reveal Fader”（如果有）

如果你有一个“Revealable”文本，请确保你 **移除** 整个“Reveal Fader”组件。检查器应如下所示：

<figure><img src="https://1326131491-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FEKNr7dxwesHOc8ViCK8y%2FScreenshot%202026-04-01%20alle%2017.00.52.png?alt=media&#x26;token=56ca3460-cd20-400c-9bf5-5c9d01b46cb8" 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="https://1326131491-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FA7am5WK2dcizswyyMVrQ%2Fimage.png?alt=media&#x26;token=95b651ac-32f0-4a43-b1e1-899afad03a20" 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="https://1326131491-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FX00Xudbu3RAE3hYaSM7j%2Fimage.png?alt=media&#x26;token=c2fc7031-29b5-4bb8-8490-e70aa5d615c3" 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-zh/ji-cheng/ji-cheng-de-cha-jian-yu-dui-hua-xi-tong/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.