Discord Matching Relay

A TERA Proxy Server mod that relays instance matching (dungeon and battleground) queue activity to a Discord channel via a webhook. It keeps a single Discord message updated in real time as players join or leave the matching queue.

Features

• Real-time updates — Automatically posts to Discord when a player adds or removes themselves from the matching queue.
• Dungeon & Battleground support — Displays separate sections for instance and battleground queues, including player counts and role composition (Tank / DPS / Healer).
• Player name visibility — Optionally shows or hides player names in the Discord embed (controlled via config).
• Single-message editing — Uses Discord's edit endpoint to keep a single message up to date, avoiding spam.

Required Data Files

The mod reads server-side XML data dumps placed under the data/ directory. These files are included with the mod and map numeric IDs to human-readable names and role configurations:

File / Directory	Description
data/DungeonMatching.xml	Dungeon matching configuration containing class position definitions (role assignments per class).
data/MatchingRoleTemplate.xml	Role templates defining the required number of Tanks, DPS, and Healers per matching group (e.g., 5-player dungeons, battlegrounds, etc.).
data/BattleFieldData.xml	Battleground data including matching rules, and team sizes.
data/StrSheet_Dungeon/	String table XML files mapping dungeon IDs to their display names (e.g., StrSheet_Dungeon-00000.xml).
data/StrSheet_BattleField/	String table XML files mapping battleground string IDs to their display names (e.g., StrSheet_BattleField-00000.xml).

Note: These XML files are extracted from the game client's data sheets (StrSheet_Dungeon and StrSheet_BattleField) and server's data sheets (DungeonMatching.xml, BattleFieldData.xml and MatchingRoleTemplate.xml) and must be kept up to date with the server version for correct role and name resolution.

Configuration

All configuration is in module.config.json:

{
  "enabled": true,
  "webhook": "https://discord.com/api/webhooks/...",
  "showPlayerNames": false
}

Option	Type	Default	Description
enabled	boolean	true	Set to false to disable the mod without removing it.
webhook	string	""	Discord webhook URL. The mod will create and continuously edit a single message in the channel this webhook belongs to.
showPlayerNames	boolean	false	When true, player names and their selected roles are displayed in the Discord message.

Requirements

• TERA Proxy or compatible proxy
• A Discord webhook URL

License

MIT License