> For the complete documentation index, see [llms.txt](https://docs.febucci.com/text-animator-unity/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.febucci.com/text-animator-unity/3.x-zh/qi-ta/geng-xin-ri-zhi.md).

# 更新日志

<mark style="color:默认;background-color:red;">**P.S. 请务必始终备份你的项目（**</mark>*<mark style="color:默认;background-color:red;">**或者更好：使用版本控制**</mark>*<mark style="color:默认;background-color:red;">**）在更新任何内容之前，甚至在 Text Animator 之外也一样。谢谢！**</mark>

***

## 最新发布

{% hint style="info" %}
我们遵循标准 **major.minor.patch** 约定，通常在商店发布时会有一个新的“**minor**”版本直接发布。
{% endhint %}

### 3.14.0 - 示例场景和紧凑型检查器 \[2026.07.01]

#### 新增

* 为 Text Animator 的更多使用场景添加了额外的示例场景
* 添加了保护，防止标签变得像 Unity 富文本标签那样
* 添加了检查器折叠项，使界面更紧凑

#### **改进**

* 改进了编辑器样式
* 改进了编辑器检查器警告
* 改进了在标签名中插入空格时自动插入下划线

#### **修复**

* 修复了与 Unity 默认标签名称的标签冲突
* 修复了 UI Toolkit 打字机在显示文本流程中会在一帧内显示所有文本

### 3.11.1 - Naninovel、打字机改进和常规修复 \[2026.04.14]

#### 新增

* 添加了 Naninovel 集成： [Naninovel](/text-animator-unity/3.x-zh/ji-cheng/yi-ji-cheng-de-cha-jian-yu-dui-hua-xi-tong/naninovel.md)
* 添加了在句末跳过标点等待的选项
* 添加了在打字机过程中跳过带标点的缩写的选项（例如 Dr.、Miss. 等）
* 添加了在开始前估算显示或隐藏文本时打字机持续时间的方法
* 添加了使用“waitinput”标签等待特定输入操作的选项，而不是等待所有输入

{% hint style="info" %}
我们也在发布与 Text Animator 兼容的新教程！&#x20;

第一个是关于伤害数字的： <https://blog.febucci.com/2026/04/how-to-create-animated-damage-numbers-in-unity/> 。加入我们的 Discord 来建议新的教程！&#x20;
{% endhint %}

#### 改进

* 改进了当文本被设置在无效、禁用或实例化的画布和组件上时/之后的显示方式&#x20;
* 改进了数据库 UX，以警告重复标签
* 改进了打字计时脚本化 API

#### 修复

* 修复了播放在回退到 `DefaultPlayback` 在通过检查器设置时
* 修复了在 UI Toolkit 中消失效果会引发错误
* 修复了 UI Toolkit 的 time unscale 不起作用
* 修复了效果在 UI Toolkit 和 TMPro 之间朝相反方向动画
* 修复了动画标签未正确填充字符信息
* 修复了默认数据库中缺少钟摆效果
* 修复了在运行时实例化且没有设置时打字机组件会报错
* 修复了打字机的 `在效果结束后触发消失` 未正确触发

***

### 3.5.0 - 稳定性和修复 \[2026.03.03]

{% hint style="warning" %}
插件现在以包的形式导入。请删除之前的资源文件夹（效果除外），然后导入新的。这将有助于更快地获得新更新，而不会覆盖你的数据！&#x20;
{% endhint %}

#### 新增

* 添加了带自定义枢轴旋转的效果
* 添加了钟摆效果
* 在“Append”方法中添加了一个参数，用于跳过上一段文本

#### 改进

* **插件现在以包的形式导入**.
* 允许在播放模式下更改 timing scriptable
* 改进了字符和单词延迟的抽屉
* 通过 API 暴露了字符已经过的时间
* 大幅改进了我们的后端，以便我们将来能更快地发布！

#### 修复

* 修复了新闻面板因博客上没有帖子而抛出错误
* 修复了启用时文本动画器在第一帧不起作用
* 修复了在同一帧调用时设置字符可见性方法不起作用
* 修复了在播放模式下更改 timing scriptable 不会应用
* 修复了启动时显示文本会在一帧内闪现完整文本
* 修复了文本动画器和打字机在某些溢出设置下无法工作
* 修复了消失文本会抛出索引越界异常
* 改进了 append 方法实现
* 改进了打字机从最后一个可见字母而不是第一个字母继续&#x20;
* 修复了在某些情况下，带有 content fitter 或 layout 组件时第一帧的布局偏移
* 修复了空字符串因 TMP 无效数据而报错
* 修复了“textAnimator.allLettersShown”在空字符串时不会返回 true
* 在某些情况下，低帧率时打字机会跳过字符/文本
* 改进了在进入/离开播放模式时某些情况下对 TextAnimator 包的搜索
* 修复了应用效果时未应用 TMPro 渐变
* 修复了抖动效果未应用到第一个字符
* 修复了数据库上下文菜单显示警告，因为它位于泛型类中
* 修复了等待最后一个字符在选项禁用时没有被正确跳过
* 修复了共享设置未应用 timescale

{% hint style="info" %}
由于一些乱七八糟的操作，版本号被跳过了。
{% endhint %}

### 3.3.0 - Unity 对话系统 \[2025.01.19]

#### 新增

* 的集成指南 [Unity 对话系统](/text-animator-unity/3.x-zh/ji-cheng/yi-ji-cheng-de-cha-jian-yu-dui-hua-xi-tong/unity-dui-hua-xi-tong.md)

#### 改进

* 将菜单项路径和优先级移到了一个专用文件中 *（以便在与其他资源冲突时你可以修改它）*

#### 修复

* 修复了等待最后一个字符没有被正确跳过
* 修复了在不同域重新加载设置下数据库不刷新
* 修复了数据库上下文菜单的警告，因为它位于泛型类中 *（Unity 的那些怪事）*&#x20;
* 修复了抖动效果未应用到第一个字符
* 修复了应用效果时未保留 TMPro 渐变

### 3.2.0 - 自定义旋转枢轴和错误修复 \[2025.12.18]

#### 新增

* 添加了带自定义枢轴旋转的效果
* 为出现、持续和消失重新实现了钟摆效果
* \[API] 在 CharacterData 中暴露了字符已经过的时间

#### 错误修复

* 修复了一个烦人的 bug：对某些用户来说，在脚本重新加载后会显示 Text Animator 窗口
* 修复了当 Unity 编辑器出现卡顿时打字机会跳过字符
* 修复了 Unity Package Manager 无法找到包时的错误

***

### 3.1.1 - Yarn Spinner、打字机事件和新闻面板 \[2025.12.03]

#### 新增

* Yarn Spinner 现已正式集成！（从 3.1 版开始）
* 在检查器（打字机组件）中添加了当打字机开始并结束等待某个字符时的事件&#x20;
* 在关于窗口中直接显示新闻面板，以便在不离开编辑器的情况下跟踪新更新

#### 错误修复

* 修复了“waitforinput”操作在内置 Actions 数据库中未正确序列化
* 修复了如果父对象被禁用，打字机没有正确开始

#### 小改动

* 在 package.json 中添加了文档和许可证链接
* 添加了在打字机等待某个字符之前或之后执行某事的虚拟方法
* 为 Text Animator 和 Typewriter 组件添加了自定义图标

***

### 3.0.0 - 支持 UI Toolkit、新的动画引擎以及更多内容！ \[2025.11.18]

#### 新增

* 从 Unity 6.3 开始支持 UI Toolkit
* 借助“Playbacks”，你可以让效果只播放一次，让它循环 x 次、延迟开始以及许多其他组合（可通过编辑器或富文本标签实现）
* 现在同一种效果可在所有情况下作为 Appearance、Persistent（以前为“Behavior”）和 Disappearance 播放，进一步增加了可用效果的数量（例如，将“wave”作为 appearance，并使用与“wave”作为 persistent/behavior 不同的参数）。
* 你可以使用富文本标签修饰符直接设置效果参数、对其进行乘法调整或设置特定关键字
* 你现在可以为效果设置不同的曲线，从而改变不同的过渡及其随时间的移动/影响（例如，让旋转看起来有延迟，逐步增加）。
* 为已有效果添加了更多选项，例如“扩展”和“滑动”方向
* Typewriter Actions 现在可以创建为“组件”（而不仅仅是 Scriptable Objects），让你更容易引用场景对象&#x20;
* Typewriter Actions 现在同时支持协程和无状态的“tick”推进
* 一种名为“PlaySound”的新打字机动作：播放并等待 Audio Source 结束后再继续打字机&#x20;
* *还添加了许多其他小优化、工具提示等等。*

{% hint style="success" %}
*我们大概会发现这里漏写了一些功能，并会在接下来的几周更新此页面——在过去几个月的开发中有 **数百** 次提交！*.
{% endhint %}

#### **改进**

* 重写了整个文档，希望让它更易理解，并涵盖额外的最佳实践、技巧和常见问题
* 改进了该资源的许可证，现在对独立开发者和更大的团队都更易获取。
* 优化了效果，实现了运行期间 0 垃圾回收，以及许多其他优化考虑&#x20;
* 修复了效果之间的竞态条件（在某些极端情况下发生）
* 修复了动作之间的竞态条件，也允许你为特定打字机指定本地动作
* 改进了编辑器以及 API 的用户体验。
* 改进了欢迎界面和设置窗口，现在会进行一些额外检查
* 你现在可以在多个打字机和文本动画器之间共享设置。
* 改进了处理富文本标签参数的 API，现在由 Text Animator 自动处理
* *许多错误修复（例如新的输入系统警告）等等*.&#x20;

#### 破坏性 API 变更

* 大部分 API 都有破坏性变更（因为我们更改了命名空间和一些核心架构，尤其是如果你编写了自定义 C# 效果或动作）。为了实现这个新版本并为我们未来的所有计划做准备，需要改动很多——所以我们一次性全部做了（包括许可证变更），这样 a) 这只是一件你只需考虑一次的事，b) 我们可以在不被束缚的情况下更轻松地开发新更新。请务必阅读 [从 2.X 升级到 3.X](/text-animator-unity/3.x-zh/qi-ta/geng-xin-ri-zhi/cong-2.x-sheng-ji-dao-3.x.md)。谢谢！

***

## 已知问题

**我们正在着手修复，并将尽快更新资产（无论如何）**!