# 변경 사항

<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.11.1 - Naninovel, 타자기 개선 및 일반 수정 \[2026.04.14]

#### 추가됨

* Naninovel 연동 추가: [Naninovel](/text-animator-unity/3.x-ko/integrations/integrated-plugins-and-dialogues-systems/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/> . 새로운 튜토리얼을 제안하려면 디스코드에 참여하세요!&#x20;
{% endhint %}

#### 개선됨

* 잘못된 상태, 비활성화된 캔버스, 또는 인스턴스화된 캔버스와 컴포넌트에 설정된 후/중에 텍스트가 표시되는 방식을 개선했습니다&#x20;
* 중복 태그를 경고하도록 데이터베이스 UX 개선
* 타이밍 스크립터블 API 타이핑 개선

#### 수정됨

* 재생이 다음으로 되돌아가던 문제 수정 `DefaultPlayback` 인스펙터를 통해 설정했을 때
* UI Toolkit에서 사라짐 효과가 오류를 발생시키던 문제 수정
* UI Toolkit에서 시간 언스케일이 작동하지 않던 문제 수정
* UI Toolkit와 TMPro 사이에서 효과가 반대 방향으로 애니메이션되던 문제 수정
* 애니메이션 레이블이 문자 정보를 올바르게 채우지 못하던 문제 수정
* 기본 데이터베이스에서 빠진 펜듈럼 효과 수정
* 설정 없이 런타임에 인스턴스화될 경우 타자기 컴포넌트가 오류를 발생시키던 문제 수정
* 타자기의 `Trigger Disappeared After Effects End` 가 제대로 동작하지 않던 문제 수정

***

### 3.5.0 - 안정성 및 수정 사항 \[2026.03.03]

{% hint style="warning" %}
이제 플러그인이 패키지로 가져와집니다. 이전 에셋 폴더(효과는 제외)를 삭제한 뒤 새 것을 가져와 주세요. 이렇게 하면 데이터를 덮어쓰지 않고도 더 빠르게 새 업데이트를 받을 수 있습니다!&#x20;
{% endhint %}

#### 추가됨

* 사용자 지정 피벗 회전을 사용하는 효과 추가
* 펜듈럼 효과 추가
* 이전 텍스트를 건너뛰는 "Append" 메서드의 매개변수 추가

#### 개선됨

* **이제 플러그인이 패키지로 가져와집니다**.
* 플레이 모드 중 타이밍 스크립터블 변경 허용
* 문자 및 단어 지연 드로어 개선
* API를 통해 문자 경과 시간 노출
* 향후 더 빠르게 배포할 수 있도록 백엔드를 크게 개선했습니다!

#### 수정됨

* 블로그에 게시물이 없어 뉴스 패널에서 오류가 발생하던 문제 수정
* 활성화 시 첫 프레임에 텍스트 애니메이터가 작동하지 않던 문제 수정
* 같은 프레임에서 호출될 경우 문자 보이기 설정 메서드가 작동하지 않던 문제 수정
* 플레이 모드 중 타이밍 스크립터블 변경이 적용되지 않던 문제 수정
* 시작 시 텍스트 표시가 한 프레임 동안 전체 텍스트를 깜박이던 문제 수정
* 일부 오버플로 설정에서 텍스트 애니메이터와 타자기가 작동하지 않던 문제 수정
* 사라지는 텍스트가 인덱스 범위 초과 예외를 발생시키던 문제 수정
* 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-ko/integrations/integrated-plugins-and-dialogues-systems/unity.md)

#### 개선됨

* 메뉴 항목 경로와 우선순위를 전용 파일로 이동 *(다른 에셋과 충돌하면 수정할 수 있도록)*

#### 수정됨

* 마지막 글자 대기가 올바르게 건너뛰어지지 않던 문제 수정
* 다른 도메인 리로드 설정에서 데이터베이스가 새로고침되지 않던 문제 수정
* 제네릭 클래스 내부에 있어 데이터베이스 컨텍스트 메뉴 경고가 표시되던 문제 수정 *(Unity의 난리법석)*&#x20;
* Wiggle 효과가 아주 첫 번째 글자에 적용되지 않던 문제 수정
* 효과 적용 시 TMPro 그라디언트가 유지되지 않던 문제 수정

### 3.2.0 - 사용자 지정 회전 피벗 및 버그 수정 \[2025.12.18]

#### 추가됨

* 사용자 지정 피벗 회전을 사용하는 효과 추가
* 펜듈럼 효과를 appearance, persistent, disappearance 모두에 대해 재구현
* \[API] CharacterData에서 문자 경과 시간 노출

#### 버그 수정

* 스크립트 리로드 후 일부 사용자에게 Text Animator 창이 표시되던 성가신 버그 수정
* Unity 에디터에 지연이 크게 발생하면 타자기가 문자를 건너뛰던 문제 수정
* Unity 패키지 매니저가 패키지를 찾지 못할 때 오류가 발생하던 문제 수정

***

### 3.1.1 - Yarn Spinner, 타자기 이벤트 및 뉴스 패널 \[2025.12.03]

#### 추가됨

* 이제 Yarn Spinner가 공식적으로 통합되었습니다! (버전 3.1부터)
* 타자기가 문자 대기를 시작하고 끝낼 때 인스펙터의 이벤트 추가 (타자기 컴포넌트)&#x20;
* 업데이트 내용을 확인하기 위해 에디터를 벗어나지 않아도 되는, About 창 내의 뉴스 패널

#### 버그 수정

* "waitforinput" 액션이 내장 액션 데이터베이스에 올바르게 직렬화되지 않던 문제 수정
* 부모 오브젝트가 비활성화되어 있으면 타자기가 올바르게 시작되지 않던 문제 수정

#### 사소한 변경 사항

* 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로, persistent/behavior의 "wave"와는 다른 매개변수로 사용 가능).
* 리치 텍스트 태그 수정자를 사용해 효과 매개변수를 직접 설정하거나, 곱하거나, 특정 키워드를 설정할 수 있습니다
* 이제 효과에 서로 다른 커브를 설정하여, 서로 다른 전환과 시간에 따른 이동/영향을 변경할 수 있습니다 (예: 회전이 지연되는 것처럼 보이게 하여 단계적으로 증가).
* 기존 효과에 "expanding" 및 "sliding" 방향 같은 더 많은 옵션 추가
* 타자기 액션을 Scriptable Object 외에도 "컴포넌트"로 만들 수 있어, 씬 오브젝트를 더 쉽게 참조할 수 있습니다&#x20;
* 이제 타자기 액션은 코루틴과 상태 없는 "tick" 진행 모두를 지원합니다
* "PlaySound"라는 새 타자기 액션: 타자기를 진행하기 전에 오디오 소스 재생을 기다립니다&#x20;
* *그 밖에도 여러 가지 작은 개선 사항, 툴팁 등을 추가했습니다.*

{% hint style="success" %}
*아마도 여기 적지 못한 기능들이 더 있다는 것을 발견하게 될 것이며, 앞으로 몇 주 안에 이 페이지를 업데이트할 예정입니다 - **수백** 개의 커밋이 지난 몇 달간의 개발 기간 동안 있었습니다!*.
{% endhint %}

#### **개선됨**

* 문서 전체를 다시 작성하여 더 이해하기 쉽게 만들고, 추가적인 모범 사례, 팁, 자주 묻는 질문까지 다루도록 했습니다
* 에셋 라이선스를 개선하여 이제 인디와 더 큰 팀 모두에게 더욱 접근하기 쉬워졌습니다.
* 효과를 최적화하여 중간에 가비지 컬렉션이 0이 되도록 했고, 그 밖에도 많은 최적화 사항을 고려했습니다&#x20;
* 효과 간 레이스 컨디션 수정(일부 극단적인 경우에 발생)
* 액션 간 레이스 컨디션 수정, 특정 타자기에 대한 로컬 액션 지정도 가능
* 에디터와 API의 UX 개선.
* 환영 화면과 설정 창 개선, 이제 추가 검사를 수행합니다
* 이제 여러 타자기와 텍스트 애니메이터 간에 설정을 공유할 수 있습니다.
* 리치 텍스트 태그 매개변수를 처리하는 API 개선, 이제 Text Animator가 자동으로 처리합니다
* *여러 버그 수정(새 입력 시스템 경고 포함) 등*.&#x20;

#### 파괴적 API 변경

* 대부분의 API가 변경되었습니다(Namespaces와 일부 핵심 아키텍처가 바뀌었기 때문이며, 특히 사용자 지정 C# 효과나 액션을 작성했다면 더 그렇습니다). 이 새 버전과 우리가 염두에 둔 미래 계획들을 준비하기 위해 많은 부분을 바꿔야 했습니다. 그래서 한 번에 모두 처리했습니다(라이선스 변경 포함). 그러면 a) 한 번만 생각하면 되고, b) 막히지 않고 새 업데이트를 더 쉽게 작업할 수 있기 때문입니다. 꼭 읽어 주세요 [2.X에서 3.X로 업그레이드](/text-animator-unity/3.x-ko/other/changelog/2.x-3.x.md). 감사합니다!

***

## 알려진 문제


---

# 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/other/changelog.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.