Statward Guide

Everything you need to know about setting up Statward, running Destiny 2 stats commands, and configuring server autoroles.

Guide Contents

1. Quickstart & Account Linking
2. Complete Commands Reference
3. How Statward Handles Bungie Data
4. Server Admin & Autorole Setup
5. Bungie Privacy Settings
6. Common Questions & Troubleshooting

1. Quickstart & Account Linking

Statward works instantly without any account linking when you pass a Bungie Name. However, linking your Bungie account once means you can run every command with zero arguments.

/statward link <bungie_name#1234> One-Time Setup

Links your Discord account to your Destiny 2 profile. Enter your full Bungie Global Display Name including the hashtag and numbers (for example: Guardian#1234).

Once linked:

Typing /d2 stats immediately pulls your personal lifetime career report.
Typing /d2 trials immediately inspects your current Trials passage card.
You can check your linked identity at any time with /statward accounts.
You can unlink whenever you wish with /statward unlink.

Cross-Save Friendly: If you play Destiny 2 across multiple platforms (PC, PlayStation, Xbox), Statward automatically queries your primary Cross-Save profile so your data reflects your active characters.

2. Complete Commands Reference

Commands in Statward are separated by game namespace to keep commands predictable and organized:

Cross-Game & Management (/statward)

/statward pingDiagnostic

Check that Statward is online, verify HTTP webhook latency to Cloudflare, and ensure the bot is answering.

/statward linkAccount

Link your Bungie account using your full Bungie name (e.g. Guardian#0001).

/statward accountsAccount

View the game profiles currently linked to your Discord account.

/statward unlinkAccount

Removes your stored Bungie link from Statward's database.

Destiny 2 Reports (/d2)

/d2 stats [player]Core

Lifetime overview for a Guardian: PvE combat rating, clears, active hours, Crucible K/D, win rates, and primary class distribution.

/d2 trials [player]PvP Weekend

Inspects the active Trials of Osiris weekend: current map, passage type, round wins, round losses, and flawless card status. (Reports cleanly when Trials is inactive between Tuesday and Friday reset).

/d2 crucible [player]PvP Detail

Comprehensive Crucible breakdown: lifetime K/D, efficiency (KDA), total matches played, combat rating, and precision kill ratios across playlists.

/d2 clan [clan_name]Roster

Displays your clan's roster, total active members, and who has logged on to Destiny 2 recently.

/d2 raids [player]Endgame PvE

Complete raid history: clear counts broken down per raid (Salvation's Edge, Root of Nightmares, Crota's End, King's Fall, Vow of the Disciple, Vault of Glass, Deep Stone Crypt, Last Wish).

/d2 dungeons [player]PvE

Dungeon completions across all releases: Vesper's Host, Warlord's Ruin, Ghosts of the Deep, Spire of the Watcher, Duality, Grasp of Avarice, Pit of Heresy, Shattered Throne.

/d2 exotics [player]PvE

Completion reports for exotic missions such as Dual Destiny, Encore, Avalon, Operation: Seraph's Shield, and Presage.

/d2 ib [player]PvP Event

Iron Banner lifetime stats: matches played, win rate, objective points captured, and career efficiency.

/d2 gambit [player]PvEvP

Gambit lifetime performance: motes deposited, primeval damage, invasion kills, and match win rates.

3. How Statward Handles Bungie Data

Destiny 2 has been live since 2017. Over nine years, Bungie API aggregates have developed known historical idiosyncrasies that lead older bots to miscalculate player stats:

Deleted Characters: If a player recreated their Hunter or Titan, Bungie's default profile endpoints exclude deleted characters from account sums. Statward calculates from the complete character history so your veteran legacy remains intact.
True Trials Tracking: Statward avoids known bugs in Bungie's summary bucket by parsing actual activity histories and milestone definitions.
No Bogus Times: Bungie measures speed runs from when a player joins an instance, meaning checkpoint runs can artificially report as 2-minute completions. Statward filters checkpoint anomalies.

4. Server Admin & Autorole Setup (Coming Soon)

Statward's roadmap includes Bungie-verified earned autoroles for Discord servers on the upcoming Server tier. Unlike vanity self-assign pickers, earned roles will be granted only when Statward directly verifies the player's achievements through Bungie:

Verified Clan Membership: Automatically assign a @Clan Member role to players confirmed in your Bungie clan.
Flawless & Conqueror: Assign seals and prestige roles based on verified in-game triumphs.
Raid Clear Thresholds: e.g., @Raid Veteran for players with 25+ combined raid clears.

Discord Role Hierarchy: In your Discord Server Settings > Roles, ensure the Statward bot role is placed above any role you want Statward to manage. Discord prevents bots from granting roles higher than their own.

5. Bungie Privacy Settings

If running a command returns a privacy notice, your Bungie.net profile may be set to private. To allow Statward to display your stats:

Sign in to Bungie.net with your platform credentials.
Go to Settings > Privacy Settings.
Ensure "Show my Destiny Game History" is checked.
Save changes. Statward will be able to query your profile immediately.

6. Common Questions & Troubleshooting

Q: Why does `/d2 trials` say Trials is not active?
Trials of Osiris is a weekend event that runs from Friday daily reset (17:00 UTC) through Tuesday weekly reset (17:00 UTC). When Trials is not active, the milestone is not present in the game, and Statward reports this clearly.

Q: Does Statward read my chat messages?
No. Statward runs solely on Discord's HTTP interactions webhook standard. It has no gateway connection and cannot see or log normal channel conversation.

Q: How do I remove the bot from my server?
Server administrators can kick or ban the bot at any time through standard Discord server settings.

Add Statward to Discord