Guide to Rabi-Ribi Map Editing
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
rabiribi-map-editing/docs/cutscenes/story_emot.md

145 lines
5.2 KiB

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