Documentation

Guides & FAQ

Everything you need to set up your guild, log matches, and get the most out of Wargame Stats.

Guild Setup Player Profiles Party Tracker Logging Matches Dashboard Enemy Intel Commands FAQ
01 Guild Setup
1
Sign in with Discord
Visit the home page and click Set Up a Guild. You'll sign in with Discord to create your guild leader account.
2
Name your guild
Enter your guild's name. This will appear across the dashboard, match logs, and player profiles.
3
Add the bot to your Discord server
The setup wizard provides a one-click link to invite the bot. You'll need Manage Server permission in the Discord server you're adding it to.
4
Set officer & admin roles
Choose which Discord roles have Officer and Admin access. Officers can log matches and manage the roster; Admins have full access including guild settings.
!tlconfig set-officer @role  ·  !tlconfig set-admin @role
5
Import your roster (optional)
Upload a CSV of your guild members to dramatically improve OCR name matching from day one. Most guild management tools like Guild Manager or TLGM let you export a member list as CSV. Upload it from Guild Settings → Members → Roster Import on the dashboard, or via Discord with !wgimportroster. You can also skip this — the system learns names as you log matches.
02 Player Profiles
1
Create your profile
From the home page, click Create a Profile and sign in with Discord. Your profile links your Discord identity to your in-game name.
2
Set your weapons & class
Choose your primary and secondary weapons on your profile page. Your class is determined automatically from your weapon combination.
3
Public or private
Toggle your profile between public (shareable URL anyone can view) or private (only visible to you and your guildmates). Defaults to private.
4
View your stats
Your profile displays career stats — games tracked, total defeats, assists, average damage, average healing, win rate, and full match history with per-game breakdowns.
03 New Party Tracker
1
Build a party preset
On your guild dashboard, open the Parties tab and click Edit Layout. Add as many parties as you need (up to 20 per preset), each holding up to 6 members. Drag members from the Unassigned sidebar into party slots, then save — the preset becomes your default lineup for future matches.
2
Customise each party
Click the cog on any party to set an icon and colour. There are 40+ glyph icons to choose from and a full colour wheel — useful for visually distinguishing roles (Tank squad blue, Healers green, DPS purple). The icon and colour show up wherever the party appears across the dashboard.
3
Assign the preset to a match
On any published match's Parties tab, an officer picks the preset and the system auto-slots every preset member who actually played in that match. Members who didn't appear can be added manually as substitutes from the Match Roster sidebar.
4
Read the party detail page
Click any party card to drill in. The detail view shows the roster with per-member averages, a Distribution chart (pick a stat — KP, Kills, Assists, Healing, Tanked — and see who contributed what), a trend sparkline of that stat over the last 15 matches, a Recent Subs panel listing players who've stepped in as fill-ins, and the full match history for the party.
5
Drill into a specific match
In the Distribution panel, pick a match from the dropdown (or click any row in the Match History table below). The chart re-scopes to that single game, and the trend strip swaps to a vs party-average bullet bar showing whether the party over- or under-performed compared to its all-time average.
6
Simulate a lineup
Click the × on any roster row or sub to exclude that member from the chart. Useful for "what would our damage share look like without our top DPS?" or "how does the lineup look with this sub in?" Header stats stay all-time for reference; the Distribution chart recomputes live.
7
Match-level breakdown
On any match page, the Parties tab shows every party that fielded members in that match, with per-member stats and a damage contribution bar showing each party's share of the team's total damage. Quick way to see "who pulled their weight" without leaving the match view.
04 Logging Matches
A
Option A — Web upload (recommended)
Officers and Admins can log matches directly from the guild dashboard. Open the Add Match tab, fill in the match details (enemy, map, result), and upload your scoreboard screenshots. The same OCR pipeline processes them.
B
Option B — Discord upload
Post the match result in a channel with the images attached. The bot reads player stats from the image automatically.
!wgadd Lunarch | lost | Ahzreil | 18/05
Typical example: you fought Lunarch, lost on the Ahzreil map on the 18th of May. Fields are pipe-separated. Date is optional — use dd/mm (e.g. 18/05), today, or yesterday. Don't type angle or square brackets.
2
Screenshot tips
Make sure the full scoreboard is visible — all player names, damage dealt, defeats, assists, and healed amounts. It's usually around 10 screenshots for a 48v48 wargame. The bot merges them automatically.
3
Confirmation & review
After a few minutes your match will be in the "Pending Review" tab for you to check it over. Once you're happy, press Publish and it updates immediately on the dashboard and player profiles.
05 Using the Dashboard
Overview
Your guild's win/loss record across all time, last 30 days, and last 7 days. Shows your current streak and highlights top performers by average damage, kills, assists, and healing.
Calendar
A monthly view of all your matches. Click any match event to open the full scoreboard in a modal. Use the arrows to navigate between months.
Players
Full roster leaderboard — searchable and sortable by defeats, assists, damage, healed, and games played. Click any player row to open their profile with per-game averages and complete match history.
Mercs
Allied players from outside your guild who appeared in your matches. Shows per-game averages and is clickable for individual profiles — useful for tracking regular allies.
Enemy Insights
Every enemy player you've faced, with per-game averages, weapon loadouts, and full match history. Filter by enemy guild to scout specific opponents. See the Enemy Intel section for more.
Maps
Interactive map canvases for war planning, plus performance stats broken down by map. See the Interactive Maps section for more.
06 Enemy Intel
Enemy player profiles
Click any enemy name to see their full stat card — average damage, defeats, assists, healing, weapon loadouts, and every match they've appeared in against your guild.
Notes & tags
Leave notes on enemy players visible to your whole guild — callouts, positioning tendencies, or threat assessments. Tag enemies with labels like shotcaller, healer, or focus target for quick identification. Guildmates can upvote useful notes to surface the best intel.
Feud tracking
The Enemies tab shows your head-to-head record against each enemy guild — games played, wins, and losses — so you can see which guilds you dominate and which ones give you trouble.
07 Interactive Maps
Map canvases
Upload a map image and use it as an interactive canvas. Create multiple maps for different territories or scenarios. One map can be set as the default that loads first.
Pins & labels
Drop pins on the map to mark positions, objectives, or rally points. Add text labels for zone names or tactical notes. Everything is draggable and editable by officers.
Map stats
Each map shows your guild's win/loss record, which enemy guilds you've faced on it, and links to the individual match results — so you can review past performances on specific battlegrounds.
08 Officer & Admin Tools
Add Match (Officers)
Upload scoreboard screenshots directly from the web dashboard instead of Discord. Fill in the enemy guild, map name, and result, then drag and drop your screenshots. The same OCR pipeline processes them.
Name Review (Officers)
When OCR reads a name that doesn't match any known player, it appears in the Name Review queue. Officers can confirm, merge, or correct player names to keep the roster clean.
Members & Roster Import (Admins)
View and manage your full member roster — in-game names, weapons, Discord names, roles, and join dates. Import a CSV roster from Guild Manager or TLGM to seed the roster and boost OCR accuracy.
Invite Links & Applications (Admins)
Generate invite links with optional expiry and usage limits. Pre-assign an in-game name to an invite so the member is linked on arrival. Pending applications appear for admin review.
Match History (Admins)
Browse, search, and manage all logged matches. Hide or delete matches, and update match dates if needed.
Tactical Brief (Officers)
Download a Markdown summary of your guild's recent performance, roster, and enemy intel — designed as context for AI tools like Claude. Useful for pre-war preparation or quick scouting briefings.
09 Data Accuracy & Review
Auto-matched Names
When the bot reads a scoreboard, it tries to match each player name to someone it already knows. If a name is close but not exact — for example, OCR might read "Agregors" instead of "Agregore" — the system auto-matches it to the closest known player. These auto-matches appear with an amber indicator on the pending review scoreboard so officers can verify them. If the match is wrong, a single click on Revert undoes it: the raw OCR text becomes its own entry and won't be auto-matched again.
Pending Match Review
Every match logged via OCR lands in a Pending Review queue rather than going live immediately. Officers see a notification when new matches are waiting. From the review screen you can check player names, scores, the match date, and the enemy guild before publishing. If something looks wrong you can edit individual fields, correct player names, or discard the match entirely. Nothing reaches your stats until an officer publishes it.
Player Name Corrections
The system keeps the original OCR text separate from the display name. When you correct a name — either through auto-matching, manual merge, or the Name Review queue — the correction is remembered and applied automatically to future matches. Importing your roster via CSV seeds the system with known names, which dramatically reduces OCR errors from the start. Over time the system builds a complete dictionary of name variants for your guild.
Member Applications & Profile Claims
New members who join via an invite link appear as Pending Applications for admin approval. This prevents unauthorised access to your guild's data. Similarly, when a player creates a profile and claims an in-game name that already exists in your roster, the claim goes through a Profile Claim Review — an officer verifies the player is who they say they are before their Discord account is linked to that player's match history.
Match Visibility & Privacy
By default, your match data is only visible to approved guild members. Admins can toggle public match sharing to make match results viewable via shareable links. Individual matches can also be hidden from the dashboard without deleting them. When two guilds both log the same war, each guild sees the match on their own dashboard regardless of the other guild's privacy settings — both guilds participated, so both have access to their own record of it.
10 Discord Commands
Most stats and management features have moved to the web dashboard. The Discord bot handles match logging, roster import, and initial guild configuration.
!wgadd Log a match. Attach scoreboard screenshots and pipe-separate the fields: !wgadd Lunarch | lost | Ahzreil | 18/05. Date is optional and accepts dd/mm, today, or yesterday.
!wgimportroster Import your guild's player roster from a CSV file. Also available from the web dashboard under Guild Settings → Members. Admin only.
!tlconfig show View current server configuration — guild name, officer/admin roles, and linked spreadsheet.
!tlconfig set-officer @role Set the Discord role that grants Officer access. Admin only.
!tlconfig set-admin @role Set the Discord role that grants Admin access. Admin only.
!tlconfig set-guild <name> Set or change your guild name. Also accepts a #TOKEN to link with a WargameFinder guild. Admin only.
11 FAQ
Yes — as long as the screenshot clearly shows the end-of-match scoreboard with player names and stats visible. You can attach multiple screenshots if the scoreboard spans more than one screen, and the bot will merge them together.
The bot uses fuzzy name matching to correct common OCR misreads. If a name is close enough to a known player in your roster, it matches automatically. For unresolved names, Officers can fix them in the Name Review tab on the dashboard.
Yes. If both guilds use the bot, each guild logs the match from their own perspective. Each guild's dashboard shows their own records independently.
Only approved members of your guild. The dashboard requires Discord login and active guild membership. Anyone without access will see a login screen. Admins control who has access via Guild Settings.
Players can create a profile independently. Once their in-game name matches a name in a guild's roster, their stats are linked. Profiles can be set to public (shareable URL) or private (guild-only visibility).
There is no match limit. All historical data is stored and accessible on the dashboard indefinitely.
Yes. Officers and Admins can use the Add Match tab on the guild dashboard to upload scoreboard screenshots and log matches without touching Discord. Both methods use the same OCR pipeline.
Officers can log matches (Discord and web), review names, and manage the roster. Admins have full access including guild settings, invite link management, and role configuration. Both are set via Discord roles using !tlconfig.
Yes. If you already have a guild on WargameFinder, generate a link token from your WargameFinder guild page and use !tlconfig set-guild #TOKEN in Discord. Your guild name and roster data will carry over.
The dashboard is responsive and works on mobile browsers, though it's optimised for desktop where you can see all stat columns comfortably.