# 에피소드 상태창 위젯 (/widgets/episode-state-window)





**위젯 지원 환경:** [에피소드 에디터](/episode) (지원), [위키 에디터](/wiki) (미지원), [워크스페이스](/workspace) (미지원)

**이런 경우에 사용해보세요**

* 전투나 사건 뒤에 캐릭터의 체력·장비·감정 변화를 정리해 두고 싶었던 적이 있나요?
* 캐릭터 위키의 기본 속성을 현재 에피소드 상태창으로 빠르게 옮기고 싶었던 적이 있나요?
* 작성한 상태 정보를 일정한 형식으로 본문에 삽입하고 싶었던 적이 있나요?

**이럴 때는 다른 기능이 더 잘 맞아요**

- 한 캐릭터의 여러 회차 상태를 모아서 이전 기록과 비교할 때 → [캐릭터 상태창 위젯](/widgets/character-state-window)

## 활성화와 배치 [#활성화와-배치]

에피소드 상태창 위젯은 기본으로 활성화되어 있지 않습니다. [에피소드](/episode) 에디터의 <TbLayout2 style="{ display: 'inline' }" /> `위젯 설정하기`에서 **에피소드 상태창**을 켜세요. 왼쪽·오른쪽 패널에 배치할 수 있으며 [위키](/wiki)와 [워크스페이스](/workspace)에서는 사용할 수 없습니다.

## 기본 사용 [#기본-사용]

1. `캐릭터 선택...` 메뉴에서 상태를 기록할 캐릭터 위키를 고르세요.
2. 속성 행의 `속성`과 `값`을 입력하고 <TbPlus style="{ display: 'inline' }" /> `속성 추가`로 행을 늘리거나 <TbTrash style="{ display: 'inline' }" /> `속성 삭제`로 지우세요.
3. 필요하면 <TbFileImport style="{ display: 'inline' }" /> `위키 속성 틀 가져오기`로 캐릭터 위키의 속성을 불러오거나 <TbArrowRight style="{ display: 'inline' }" /> `이전 편 속성 가져오기`로 직전 상태창의 값을 이어받으세요.
4. <TbEye style="{ display: 'inline' }" /> `미리보기`에서 결과를 확인한 뒤 <TbFileImport style="{ display: 'inline' }" /> `본문에 삽입`을 누르세요.

`위키 속성 틀 가져오기`는 선택한 캐릭터 위키의 속성명과 값을 현재 상태창으로 가져옵니다. `이전 편 속성 가져오기`는 현재 회차보다 앞에 있는 상태창 중 가장 최근 기록을 그대로 가져옵니다. 두 기능 모두 현재 상태창의 행을 불러온 내용으로 바꾸므로, 이미 입력한 내용이 있다면 덮어쓰기 전에 확인하세요.

### 입력 예시 [#입력-예시]

`3화 균열`에서 캐릭터 **에핀**을 선택하고 다음과 같이 입력했다고 가정해 보겠습니다.

| 속성 | 값     |
| -- | ----- |
| 체력 | 72    |
| 장비 | 은빛 단검 |
| 감정 | 불안    |

기본 템플릿을 사용하면 <TbEye style="{ display: 'inline' }" /> `삽입 미리보기`와 본문에는 다음과 같이 표시됩니다.

```text
========== 에핀 ==========
체력: 72
장비: 은빛 단검
감정: 불안
========================
```

입력한 데이터는 현재 에피소드에 저장됩니다. 이후 다른 회차에서 같은 캐릭터의 상태를 기록하면 [캐릭터 상태창 위젯](/widgets/character-state-window)이 이 기록들을 모아 변화한 부분을 비교합니다.

## 삽입 템플릿 [#삽입-템플릿]

템플릿은 상태 데이터를 본문에 삽입하거나 클립보드에 복사할 때의 출력 형식을 정하는 고급 기능입니다. 상태창의 실제 속성과 값은 바꾸지 않습니다. 위젯 메뉴의 <TbTemplate style="{ display: 'inline' }" /> `템플릿 설정`에서 편집하고, <TbEye style="{ display: 'inline' }" /> `삽입 미리보기`로 결과를 확인하세요. <TbClipboard style="{ display: 'inline' }" /> `상태창 복사`에도 같은 템플릿이 적용됩니다.

### 사용할 수 있는 문법 [#사용할-수-있는-문법]

| 문법                                  | 표시되는 내용             | 예시             |
| ----------------------------------- | ------------------- | -------------- |
| `{{characterName}}`                 | 선택한 캐릭터 위키의 제목      | `에핀`           |
| `{{wikiTitle}}`                     | 선택한 캐릭터 위키의 제목      | `에핀`           |
| `{{episodeTitle}}`                  | 현재 에피소드의 제목         | `3화 균열`        |
| `{{#attributes}}...{{/attributes}}` | 사이의 내용을 표시할 속성마다 반복 | 속성 3개라면 세 번 반복 |
| `{{key}}`                           | 속성에 저장된 원래 키        | `status`       |
| `{{name}}`                          | 화면에 표시되는 속성명        | `상태`           |
| `{{value}}`                         | 해당 속성의 값            | `부상`           |
| `{{attribute.key}}`                 | 반복 중인 속성의 원래 키      | `status`       |
| `{{attribute.name}}`                | 반복 중인 속성의 표시명       | `상태`           |
| `{{attribute.value}}`               | 반복 중인 속성의 값         | `부상`           |
| `\n`                                | 줄바꿈                 | `이름\n상태`       |

`{{key}}`, `{{name}}`, `{{value}}`와 `{{attribute.key}}`, `{{attribute.name}}`, `{{attribute.value}}`는 `{{#attributes}}...{{/attributes}}` 안에서 사용하세요. `name`은 뮤블 화면에 표시되는 이름을 사용하므로, 미리 정의된 속성이라면 현재 앱 언어에 맞게 표시될 수 있습니다.

### 템플릿 작성 예시 [#템플릿-작성-예시]

다음 템플릿은 에피소드 제목과 캐릭터 이름을 첫 줄에 놓고, 그 아래에 모든 속성을 목록으로 만듭니다.

```text
[{{episodeTitle}}] {{characterName}}
{{#attributes}}- {{name}}: {{value}}
{{/attributes}}
```

앞의 입력 예시에 적용하면 다음 결과가 만들어집니다.

```text
[3화 균열] 에핀
- 체력: 72
- 장비: 은빛 단검
- 감정: 불안
```

<TbTemplate style="{ display: 'inline' }" /> `기본 템플릿`을 누르면 처음 제공되는 형식으로 되돌릴 수 있습니다. `빈 값 제외`를 켜면 값이 비어 있는 속성은 반복 목록과 최종 결과에서 빠집니다. 속성명이 비어 있는 행은 설정과 관계없이 출력되지 않습니다.

> 에피소드 상태창 위젯은 상태를 **입력하고 수정하는 곳**이며, [캐릭터 상태창 위젯](/widgets/character-state-window)은 여러 회차의 기록을 **모아 보고 비교하는 곳**입니다.

## 관련 설정 [#관련-설정]

| 설정 및 위치 | 기본값 | 선택지·범위 | 동작 |
| --- | --- | --- | --- |
| 템플릿 — 위치: 에피소드 상태창 위젯 → 위젯 메뉴 → 템플릿 설정 → 템플릿 | 캐릭터 이름과 속성 목록을 구분선 안에 표시 | 직접 입력 | 상태창을 복사하거나 본문에 삽입할 때 사용할 형식을 정합니다. |
| 빈 값 제외 — 위치: 에피소드 상태창 위젯 → 위젯 메뉴 → 템플릿 설정 → 빈 값 제외 | 켜짐 | — | 값이 비어 있는 속성을 결과에서 제외합니다. |

## 관련 기능 [#관련-기능]

- [캐릭터 상태창 위젯](/widgets/character-state-window): 에피소드 상태창 위젯으로 각 회차에 입력한 캐릭터 상태를 캐릭터 위키에서 모아 보고, 이전 기록과 비교하는 위젯입니다.
- [위키](/wiki): 인물, 장소, 아이템과 세계관 설정을 구조화된 문서로 만들고 작품 안에서 서로 연결합니다.

***

- **사용 가능 버전:** v2.10.2 ↑
- **문서 최종 갱신 버전:** v2.11.5