https://github.com/techchrism/valorant-xmpp-logger

A simple tool to log XMPP traffic between the Riot client and the Riot XMPP server
https://github.com/techchrism/valorant-xmpp-logger

riot valorant xmpp

Last synced: 3 months ago
JSON representation

A simple tool to log XMPP traffic between the Riot client and the Riot XMPP server

• Host: GitHub
• URL: https://github.com/techchrism/valorant-xmpp-logger
• Owner: techchrism
• License: mit
• Created: 2023-01-23T19:45:24.000Z (almost 2 years ago)
• Default Branch: trunk
• Last Pushed: 2024-04-20T16:03:35.000Z (9 months ago)
• Last Synced: 2024-09-26T12:21:47.328Z (4 months ago)
• Topics: riot, valorant, xmpp
• Language: TypeScript
• Homepage:
• Size: 16.6 KB
• Stars: 8
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Valorant XMPP Logger

A simple tool to log XMPP traffic between the Riot client and the Riot XMPP server. Includes information such as presences and chat.

*Heavily* based on [Burak](https://github.com/BurakDev)'s [riot-xmpp-mitm](https://github.com/ValorantDevelopers/riot-xmpp-mitm) project.

## Usage

Note: This project makes use of global fetch in Node 18+

 - Clone the repo and run `npm install`

 - Run `npm run build` to build the project

 - Ensure Valorant is not running and run `node .` to start the logger. This will start Valorant automatically.

## Log Format

The first line of the file must contain a json-encoded object with required properties

`type` being set to `valorant-xmpp-logger` and `version` being a semver representing the format version.

Following lines are either comments (to be ignored by parsers) starting with `#` or log entries.

Log entries are json-encoded objects with the following properties:

 - `type`:

   - `incoming` for incoming data

   - `outgoing` for outgoing data

   - `open-valorant` when Valorant initiates an XMPP socket connection to this application

   - `open-riot` when this application initiates an XMPP socket connection to the Riot XMPP server (in response to `open-valorant`)

   - `close-valorant` when Valorant closes the XMPP socket connection

   - `close-riot` when this the Riot XMPP server closes the XMPP socket connection

 - `time`: timestamp of the log entry

If the type is `incoming` or `outgoing`, the following properties are also present:

 - `data`: the data that was sent or received

If the type is `open-*` or `close-*`, the following properties are also present:

 - `socketID`: A unique ID for the socket connection. Internally implemented as a counter.

If the type is `open-valorant`, the following properties are also present:

 - `host`: the hostname of the Riot XMPP server that the connection is intended for

 - `port`: the port of the Riot XMPP server that the connection is intended for

## Motivation

While [an excellent xmpp mitm project](https://github.com/ValorantDevelopers/riot-xmpp-mitm) had already been created,

I wanted to try my hand at creating a similar project to better understand MITM-ing the Riot client config.

This project also writes logs to disk in an easily parsable format, which is useful for creating tools to analyze the logs.

Finally, this project automatically finds and starts the Riot client which is convenient.