League of Legends Chat Parser (LoLCP)

Brief Description:
LoLCP is a parser for League of Legends chat logs.
It uses a custom grammar written in pest to extract structured events such as chat messages, kill events, team achievements, purchases, map-objective interactions, and smart pings.

📌 Current Status

The parser is now capable of handling most common LoL chat log structures and extracting:

timestamps
players and their champions
chat messages (All / Team / Party / Player)
kill events (first blood, shutdown, bonus bounty)
team achievements (e.g., Feat of Warfare)
purchases
targeting events (players and map objectives)
map pings (on the way, missing, retreating, danger, etc.)

However, LoL logs are complex and frequently updated (and not documented 🙁 ), so

I do not guarantee 100% correctness across all client versions or rare system messages.

Nevertheless, the included grammar and logic are designed to be modular and extensible.

📘 Technical Description

The goal of this project is to take a plain-text League of Legends log and transform it into structured JSON, containing:

all players mentioned in the match
which champions they played
game events such as kills, shutdowns, objectives, team achievements
all chat messages (All / Team / Party / Player)
miscellaneous gameplay events (targeting, purchases, map interactions)
all tied to their corresponding timestamps

This allows further analysis such as:

reconstructing kill timeline
identifying communication patterns
aggregating player interactions
tracking objective control
building match summaries

📜 Parsing Process Overview

Each chat line (except the first one by system) in the log typically follows this pattern:

<timestamp><event>

Examples:

Type /help for a list of commands
00:42 uskin432 (Warwick) is on the way
00:52 kozakSyla (Lux) has drawn first blood!
02:24 Enemy team has completed the Feat of Warfare!
13:05 Golf4f (Mel) has shut down BorysBulba (Tahm Kench)! (Bonus Bounty: 149G)
13:08 [Party] piwkobb (Yone): Cho'Gath Heartsteel - 20 charges
13:10 BorysBulba (Tahm Kench) purchased Control Ward
14:46 kozakSyla (Lux) is on rampage!
15:40 piwkobb (Yone) has targeted TheMiozl - (Renekton)
16:53 [All] piwkobb (Yone): hello this is all chat msg
17:34 [Team] kozakSyla (Lux): hi in team chat
18:32 kozakSyla (Lux) has targeted the Power Flower (33%)

The parser breaks these into structured components using pest grammar rules.

🧩 Grammar (overview)

The full grammar is located in:

src/grammar.pest

Below is a shortened overview of the most important rules:

line = { time ~ " " ~ line_body }

time = @{ ASCII_DIGIT ~ ASCII_DIGIT ~ ":" ~ ASCII_DIGIT ~ ASCII_DIGIT }

player_with_champion = {
    player_name ~ " " ~ "(" ~ champion_name ~ ")"
}

chat_message = {
      channel_chat_message
    | bare_chat_message
}

kill_shutdown_event = {
    player_with_champion ~ " has shut down " ~ player_with_champion ~ "!" ~ " " ~ shutdown_bounty
}

target_objective_event = {
    player_with_champion ~ " has targeted " ~ name_phrase ~ " (" ~ percentage ~ "%)"
}

ping_on_the_way_event = {
    player_with_champion ~ " " ~ ping_phrase
}

(This is only a simplified subset for demonstration—see the full grammar file for all details.)

🚀 Usage (CLI)

The project includes a command-line interface with several commands:

Show help

cargo run -- help

Show credits

cargo run -- credits

Parse a log file

cargo run -- parse lol_chat_example.txt

📤 Example Output

{
  "players": [
    {
      "name": "BorysBulba",
      "champions": [
        "Tahm Kench"
      ]
    },
    {
      "name": "Golf4f",
      "champions": [
        "Mel"
      ]
    },
    {
      "name": "TheMiozl",
      "champions": [
        "Renekton"
      ]
    },
    {
      "name": "kozakSyla",
      "champions": [
        "Lux"
      ]
    },
    {
      "name": "piwkobb",
      "champions": [
        "Yone"
      ]
    },
    {
      "name": "uskin432",
      "champions": [
        "Warwick"
      ]
    }
  ],
  "kills": [
    {
      "time": "00:52",
      "killer": "kozakSyla",
      "killer_champion": "Lux",
      "victim": null,
      "victim_champion": null,
      "bounty": null,
      "is_shutdown": false,
      "is_first_blood": true
    },
    {
      "time": "13:05",
      "killer": "Golf4f",
      "killer_champion": "Mel",
      "victim": "BorysBulba",
      "victim_champion": "Tahm Kench",
      "bounty": 149,
      "is_shutdown": true,
      "is_first_blood": false
    }
  ],
  "events": [
    {
      "time": "00:42",
      "team": null,
      "description": "uskin432 (Warwick) is on the way"
    },
    {
      "time": "02:24",
      "team": "Enemy team",
      "description": "Enemy team has completed the Feat of Warfare!"
    },
    {
      "time": "13:10",
      "team": null,
      "description": "BorysBulba (Tahm Kench) purchased Control Ward"
    },
    {
      "time": "14:46",
      "team": null,
      "description": "kozakSyla (Lux) is on rampage!"
    },
    {
      "time": "15:40",
      "team": null,
      "description": "piwkobb (Yone) has targeted TheMiozl - (Renekton)"
    },
    {
      "time": "18:32",
      "team": null,
      "description": "kozakSyla (Lux) has targeted the Power Flower (33%)"
    }
  ],
  "messages": [
    {
      "time": "13:08",
      "channel": "party",
      "player": "piwkobb",
      "champion": "Yone",
      "text": "Cho'Gath Heartsteel - 20 charges"
    },
    {
      "time": "16:53",
      "channel": "all",
      "player": "piwkobb",
      "champion": "Yone",
      "text": "hello this is all chat msg"
    },
    {
      "time": "17:34",
      "channel": "team",
      "player": "kozakSyla",
      "champion": "Lux",
      "text": "hi in team chat"
    }
  ],
  "system": [
    {
      "text": "Type /help for a list of commands"
    }
  ]
}

📁 Project Structure

src/
 ├── grammar.pest      # Full grammar definition
 ├── lib.rs            # Core parsing logic
 ├── main.rs           # CLI interface
tests/
 ├── grammar_rules_spec.rs
 ├── json_integration_spec.rs
README.md
Cargo.toml
Cargo.lock
lol_chat_example.txt   # Example log file
.gitignore

📜 License

MIT License. Project created as part of the National University of Kyiv-Mohyla Academy Rust course.

Created by Bohdan Tarverdiiev

  /\_/\      
 ( o.o )   -- hello there :)
  > ^ <

lol_chat_parser 0.2.0