Intro

This Discord bot processes Company of Heroes 2 and 3 replay files (.rec) that users have attached to their messages. The bot provides a summary of the replay's details:

• Map name
• Map tactical map image
• Players (names, factions, links to their leaderboard profiles)
• Chat
• Match duration
• Game version
• Chosen commanders

The bot also has a mode for creating compact, less verbose embeds, where the summary details are:

• Map name
• Map tactical map image (as a small thumbnail image)
• Players (names, factions, links to their leaderboard profiles,)
• Match duration

This mode is controlled by the Manage Messages permission or by the message content (set the "add a comment" field to compact). To enable the compact mode, disable Manage Messages permission in the bot role permissions (global) or in the channel bot role permissions (per channel).

Replay parsing is based on Ryan Tailor's excellent libraries: ryantaylor/vault and ryantaylor/flank.

Installation

• Bot authentication link: https://discord.com/oauth2/authorize?client_id=753206700655378523&permissions=2147870720&scope=bot

  Required bot permission	Purpose
  Send Messages	Send replay info embeds.
  Read Message History	Reply to the original messag containing the replay attachment(s).
  Manage Messages	Manage interactions (e.g. buttons) added to replay embeds.
  Embed Links	Embed markdown links (chat expansion link).
  Attach Files	Attach map preview images to embeds.
  Use External Emojis	Use standalone CoH2 and CoH3 faction emojis from the bot's Support Discord server:
  Use Slash Commands	Add interactions to replay embeds, e.g. "Expand chat".

• ❤️ Please consider inviting Janne252#7736 to the server(s) the bot has been added to ❤️

Custom maps

Custom map support is based on a curated list of maps in data-generator/assets/custom-scenarios/coh2.json. To add a new custom map to the list, open a pull request that targets data-generator/assets/custom-scenarios/coh2.json (preferred). Alternatively you can request support fora custom map on the support Discord server or by opening an issue on the GitHub repository.

Game updates

CoH3 is likely to receive updates that add new maps or battlegroups. The author of the repository usually adds support for new content after a patch but you may also contribute these updates via pull requests. Rough instructions for this are available in the data-generator app readme.

Support

Support server (Discord)

License

MIT License