royal 0.1.5

A parser for Persona 5 Royal dialogue message format
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# Royal


A Rust library for parsing Persona 5 Royal dialogue message format.

## Features


- Parse structured dialogue messages
- Support for character names, message IDs, and box types
- Handle lipsync flags and wait-for-input markers
- Clean content extraction

## Usage


Add this to your `Cargo.toml`:

```toml
[dependencies]
royal = "0.1.5"
```

Example usage:

```rust
use royal::Message;

fn main() {
    let input = "[msg MSG_BTTL_2 [Morgana]][s][f 4 10 65535 0 0]Hello world![f 1 3 65535][w][e]";
    
    if let Some(message) = Message::parse(input) {
        println!("Character: {}", message.header.character.unwrap_or_default());
        println!("Content: {}", message.content);
    }
}
```

Parse a file:

```rust
use royal::Message;

fn main() {
    let messages = Message::parse_msg("test/test_data.msg");

    for message in messages {
        println!("Message ID: {}", message.header.message_id);
        println!("Content: {}", message.content);
    }
}
```

## Message Format


The parser handles messages in the following format:
- Header: `[msg MESSAGE_TYPE_MESSAGE_ID [CHARACTER]]`
- Content markers:
  - `[s]`: Start of message
  - `[f 4 10 65535 0 0]`: Lipsync marker
  - `[f 5 13 confidant_id points model_id]`: Confidant points parser
  - `[f 1 3 65535]`: Message end marker
  - `[w]`: Wait for input
  - `[e]`: End of message

## License


This project is licensed under the GNU General Public License v3.0 or later - see the [LICENSE](LICENSE) file for details.