# Cutscene Emots
This is the example `story_emot.rbrb` from the example stage provided by GemaYue.

```
Emotion Control (New Update)
//VS RITA
7
[!T1][!C1Y>6<][!EB11][!EM13][!EE11]
[!C4B<5>][!T4][!EB47][!EM42][!EE46]

19001
[!C3B<6>][!EP30][!T3][!EB36][!EM33][!EE31]
[!T3][!EB36][!EM33][!EE36]
[!T3][!EB36][!EM35][!EE33]
```

One line of emots should be created per line of dialogue in story_text.rbrb

## Format Explanation

### Create a Character
`[!CXY<Z>]`, where X, Y and Z are replaced by:
- X: conversation ID of the created character. (1-6?)
- Y: which character is created. (A-Z, from character list below)
- Z determines distance from opposite of facing side. (0-9, `-` changes text box color without a portrait or character name)
- Wrapping Z in `<>` causes the character to appear on the right facing left, `><` causes them to appear on the left facing right

| ID | Character | ID | Character | ID | Character | ID | Character |
|----|-----------|----|-----------|----|-----------|----|-----------|
| A  | Rumi      | H  | Saya      | O  | Chocolate | V  | Pixie     |
| B  | Rita      | I  | Cicini    | P  | Kotri     | W  | Lilli     |
| C  | Nieve     | J  | Syaro     | Q  | Keke Bunny| X  |OBJ_DRAGON3|
| D  | Nixie     | K  | Cocoa     | R  | Seana     | Y  | Erina     |
| E  | Aruraune  | L  | Ashuri    | S  | Miriam    | Z  | Ribbon    |
| F  | Pandora   | M  | Lilith    | T  | Miru      | ]  |No Character|
| G  | Irisu     | N  | Vanilla   | U  | Noah      |    |           |

### Set character emotion
`[!EXYZ]`, where X, Y and Z are replaced by:
- X: which emotion part to modify. (from list of emotion parts below)
- Y: which character to modify based on their conversation ID.
- Z: emotion value.  Refer to portrait viewer in artbook.

**Note:** Emotion values usually go from 0-9. But emotion values 10 and above can also be used by following the ASCII table. `:` is 10, `;` is 11, `<` is 12 etc.

| ID | Emotion Part |
|----|--------------|
| B | Eyebrow |
| M | Mouth |
| E | Eye |
| R | Blush (0-4) |
| P | Alternate form (Kotri green = 1, kotri blue = 2) |
| I | Item (0 or 1) |
| T | Tears (0 or 1) |

### Select speaking character
`[!TX]`, where X is replaced by:
- X: talking character by their conversation ID.

### Have a character speak without a portrait
`[!EPX:]`, where X is replaced by:
- X: talking character by their conversation ID.

### Set Text Box Color
`[~CRGB]`, where R, G, B are replaced by:
- R,G,B: Red (0-9), Green (0-9) and Blue (0-9) respectively.
- For example: `[~C900]` is red, `[~C099]` is cyan.
- Only works if no talking character `]` is set. The talking character normally overrides the text box color with its own.

----------------------------

# Some Examples

### Example 1
```
[!C1Y<4>][!T1][!EE13][!EB12][!EM14]
```
- `[!C1Y<4>]`: Create a left facing Erina
- `[!T1]`: set her as the speaker of the current line
- `[!EE13]`: set eyes to type 3
- `[!EB12]`: set eyebrows to type 2
- `[!EM14]`: set mouth to type 4
 
### Example 2
```
[!C2K>5<][!T2][!EI21][!EE22][!EB23][!EM21][!ER24]
```
- `[!C2K>5<]`: Create a right facing Cocoa
- `[!T2]`: set her as the speaker of the current line
- `[!EI21]`: set her accessory to on (goggles for cocoa)
- `[!EE22]`: set her eyes to type 2
- `[!EB23]`: set her eyebrows to type 3
- `[!EM21]`: set mouth to type 1
- `[!ER24]`: set blush to max

### Example 3
```
[!C1A>1<][!T1][!EP1:]
```
- Create a right facing Rumi without a portrait

### Example 4 - NPC Emot
```
17
[!T2][!C2]>5<][!EB22][!EM21][!EE21][~C594]
```
- `[!C2]>5<]`: Creates a blank character
- `[~C594]`: Sets text box color to a light green
- The rest of the format can be ignored.