# 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

### `!C` 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      |    |           |

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

### `!E`: 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) |

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

--------------------
Additional Formats:

### `~C` 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.

### `~E` Fade to Black
`[~E0]`:
- Causes the screen to fade to black permanently. Cannot be reversed.
- Screen remains black after the cutscene.
- All `[~EX]`, where `X` is a number, do the same thing.

### `~F` Replace speaking character's name:
`[~FX]`: where X is replaced by:

| X = ?     | Name               | X = ?     | Name    | X = ?     | Name      |
| :-------- | :----------------- | :-------- | :------ | :-------- | :-------- |
| <= 0      | \<Character name\> | 7         | GemaYue | > (14)    | Luei      |
| 1         | Pixie              | 8         | Saiste  | ? (15)    | Cross     |
| 2         | Lilli              | 9         | AT2.    | @ (16)    | DUMP      |
| 3         | ???                | : (10)    | Sirluma | A (17)    | M4        |
| 4         | Mr. Tako           | ; (11)    | Laluk   | B (18)    | IAN       |
| 5         | WAERO              | < (12)    | Skullo  | >= C (19) | \<Blank\> |
| 6         | Jimbow             | = (13)    | Yarin   |           |           |

### `~G` (seems to control CGs)
`[~GX]`, where X is replaced by a number.

### `~M` Play music during cutscene
`[~MX]`, where X is replaced by:

| X = ?  | Music                     | X = ?  | Music              |
| :----- | :------------------------ | :----- | :----------------- |
| 0  | \<No change\>                 | 5      | Kitty Attack       |
| 1  | Melting Point / Midstream Jam | 6      | Full On Combat     |
| 2  | Get On With It                | 7      | Bounce Bounce      |
| 3  | Sudden Death                  | 8      | Brawl Breaks       |
| 4  | Hi-Tech Duel                  | 9+     | Brawl Breaks Ver.2 |

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

# 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.