> 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-ko/other/changelog.md).

# 변경 로그

<mark style="color:기본값;background-color:red;">**추신. 프로젝트는 항상 백업해 두세요 (**</mark>*<mark style="color:기본값;background-color:red;">**또는 더 좋게는: 버전 관리를 사용하세요**</mark>*<mark style="color:기본값;background-color:red;">**) 아무것도 업데이트하기 전에, Text Animator 외부라도 꼭 해 두세요. 감사합니다!**</mark>

***

## 최신 릴리스

{% hint style="info" %}
우리는 표준을 따릅니다 **major.minor.patch** 규칙을 따르며, 보통 새로운 "**마이너**" 버전이 나오면 바로 릴리스합니다.
{% 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-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/> . 새 튜토리얼 아이디어를 제안하려면 Discord에 참여하세요!&#x20;
{% endhint %}

#### 개선됨

* 잘못되었거나 비활성화되었거나 인스턴스화된 캔버스 및 컴포넌트에 설정된 텍스트가 표시될 때/이후의 동작을 개선했습니다&#x20;
* 중복 태그에 대해 경고하도록 데이터베이스 UX를 개선했습니다
* 타이핑 타이밍 스크립터블 API를 개선했습니다

#### 수정됨

* 플레이백이 다음으로 대체되던 문제를 수정했습니다 `DefaultPlayback` 인스펙터를 통해 설정했을 때
* UI Toolkit에서 사라짐 효과가 오류를 발생시키던 문제를 수정했습니다
* UI Toolkit에서 시간 비스케일이 작동하지 않던 문제를 수정했습니다
* UI Toolkit과 TMPro 간에 효과 애니메이션이 반대 방향으로 재생되던 문제를 수정했습니다
* 애니메이션 레이블이 문자 정보를 올바르게 채우지 않던 문제를 수정했습니다
* 기본 데이터베이스에서 펜듈럼 효과가 누락된 문제를 수정했습니다
* 설정 없이 런타임에 인스턴스화되면 타이프라이터 컴포넌트가 오류를 발생시키던 문제를 수정했습니다
* 타이프라이터의 `효과 종료 후 사라짐 트리거` 올바르게 발동되지 않던 문제

***

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

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

#### 추가됨

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

#### 개선됨

* **이 플러그인은 이제 패키지로 가져옵니다**.
* 플레이 모드 중 타이밍 스크립터블 변경을 허용했습니다
* 문자 및 단어 지연 드로어를 개선했습니다
* 문자의 경과 시간을 API를 통해 노출했습니다
* 백엔드를 크게 개선해 앞으로 더 빠르게 릴리스할 수 있게 되었습니다!

#### 수정됨

* 블로그에 없는 게시물 때문에 뉴스 패널이 오류를 내던 문제를 수정했습니다
* 활성화 시 첫 프레임에 Text Animator가 작동하지 않던 문제를 수정했습니다
* 같은 프레임에 호출하면 set visibility char 메서드가 작동하지 않던 문제를 수정했습니다
* 플레이 모드 중 타이밍 스크립터블 변경이 적용되지 않던 문제를 수정했습니다
* 시작 시 텍스트 표시가 한 프레임 동안 전체 텍스트를 깜빡이던 문제를 수정했습니다
* 일부 오버플로 설정에서 Text Animator와 타이프라이터가 작동하지 않던 문제를 수정했습니다
* 사라지는 텍스트가 인덱스 범위 초과 예외를 발생시키던 문제를 수정했습니다
* Append 메서드 구현을 개선했습니다
* 타이프라이터가 첫 글자가 아니라 마지막으로 보이는 글자부터 재개되도록 개선했습니다&#x20;
* Content Fitter 또는 레이아웃 컴포넌트가 있는 일부 경우 첫 프레임의 레이아웃 이동 문제를 수정했습니다
* 빈 문자열이 TMP의 잘못된 데이터 때문에 오류를 발생시키던 문제를 수정했습니다
* "textAnimator.allLettersShown"이 빈 문자열에서 true를 반환하지 않던 문제를 수정했습니다
* 일부 경우 낮은 프레임률에서 타이프라이터가 문자/텍스트를 건너뛰는 문제
* 일부 경우 플레이 모드 진입/종료 시 TextAnimator 패키지 검색을 개선했습니다
* 효과를 적용할 때 TMPro 그라데이션이 적용되지 않던 문제를 수정했습니다
* wiggle 효과가 맨 첫 글자에 적용되지 않던 문제를 수정했습니다
* 데이터베이스 컨텍스트 메뉴가 제네릭 클래스 안에 있어서 경고를 표시하던 문제를 수정했습니다
* 옵션이 비활성화되었을 때 마지막 문자를 기다리는 항목이 올바르게 건너뛰어지지 않던 문제를 수정했습니다
* 공유 설정이 타임스케일을 적용하지 않던 문제를 수정했습니다

{% hint style="info" %}
장난 때문에 버전이 건너뛰어졌습니다.
{% endhint %}

### 3.3.0 - Unity용 대화 시스템 \[2025.01.19]

#### 추가됨

* 다음에 대한 통합 가이드: [Dialogue System for Unity](/text-animator-unity/3.x-ko/integrations/integrated-plugins-and-dialogues-systems/dialogue-system-for-unity.md)

#### 개선됨

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

#### 수정됨

* 마지막 문자를 기다리는 것이 올바르게 건너뛰어지지 않던 문제를 수정했습니다
* 다른 도메인 리로드 설정에서 데이터베이스가 새로고침되지 않던 문제를 수정했습니다
* 데이터베이스 컨텍스트 메뉴가 제네릭 클래스 안에 있어서 경고가 표시되던 문제를 수정했습니다 *(Unity의 장난)*&#x20;
* Wiggle 효과가 맨 첫 글자에 적용되지 않던 문제를 수정했습니다
* 효과를 적용할 때 TMPro 그라데이션이 유지되지 않던 문제를 수정했습니다

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

#### 추가됨

* 사용자 지정 피벗 회전을 사용하는 효과를 추가했습니다
* 펜듈럼 효과를 출현, 지속, 사라짐 모두에 대해 다시 구현했습니다
* \[API] CharacterData에서 문자 경과 시간을 노출했습니다

#### 버그 수정

* 일부 사용자에게 스크립트 재로드 후 Text Animator 창이 표시되던 성가신 버그를 수정했습니다
* Unity 에디터에 렉이 심하게 걸리면 타이프라이터가 문자를 건너뛰던 문제를 수정했습니다
* Unity Package Manager가 패키지를 찾지 못할 때 발생하던 오류를 수정했습니다

***

### 3.1.1 - Yarn Spinner, 타이프라이터 이벤트 및 뉴스 패널 \[2025.12.03]

#### 추가됨

* Yarn Spinner가 이제 공식적으로 통합되었습니다! (3.1 버전부터)
* 타이프라이터가 문자를 기다리기 시작하고 끝났을 때 인스펙터(Typewriter Component)에 이벤트를 추가했습니다&#x20;
* 새 업데이트를 추적하기 위해 에디터를 떠나지 않아도 되도록 About 창에 뉴스 패널을 직접 넣었습니다

#### 버그 수정

* 내장 Actions Database에서 "waitforinput" 동작이 올바르게 직렬화되지 않던 문제를 수정했습니다
* 부모 오브젝트가 비활성화되어 있으면 타이프라이터가 올바르게 시작하지 않던 문제를 수정했습니다

#### 사소한 변경 사항

* package.json에 문서 및 라이선스 링크를 추가했습니다
* 타이프라이터가 문자를 기다리기 전후에 무언가를 수행하는 가상 메서드를 추가했습니다
* Text Animator 및 Typewriter 컴포넌트용 사용자 지정 아이콘을 추가했습니다

***

### 3.0.0 - UI Toolkit 지원, 새로운 애니메이션 엔진 등 다양하게 추가! \[2025.11.18]

#### 추가됨

* UI Toolkit은 이제 Unity 6.3부터 지원됩니다
* "Playbacks" 덕분에 효과를 한 번만 재생하거나, x번 반복하거나, 지연 후 시작하는 등 다양한 조합을 사용할 수 있습니다(에디터 또는 리치 텍스트 태그를 통해서도 가능)
* 같은 효과를 이제 출현, 지속(이전의 "Behavior") 및 사라짐으로 모든 경우에 재생할 수 있어 사용 가능한 효과 수가 더욱 늘어났습니다(예: 출현용 "wave"와 지속/behavior용 "wave"에 서로 다른 매개변수 사용).
* 리치 텍스트 태그 수정자를 사용해 효과 매개변수를 직접 설정하거나, 곱하거나, 특정 키워드를 설정할 수 있습니다
* 이제 효과에 서로 다른 커브를 설정하여 다양한 전환과 시간에 따른 움직임/영향을 바꿀 수 있습니다(예: 회전이 점점 따라오는 듯하게 단계적으로 증가).
* 이미 존재하는 효과에 "expanding" 및 "sliding" 방향 같은 더 많은 옵션을 추가했습니다
* Typewriter Actions는 "Components"로 만들 수 있어(ScriptableObject 외에도) 씬 오브젝트를 더 쉽게 참조할 수 있습니다&#x20;
* Typewriter Actions는 이제 코루틴과 무상태 "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). 감사합니다!

***

## 알려진 문제

**우리는 수정 작업을 진행 중이며 어쨌든 가능한 한 빨리 자산을 업데이트할 것입니다**!