Warring Nations: Discord

WN Discord integrates Warring Nations with Discord. It provides commands, dashboards, notifications, voting, account linking, role synchronization, Minecraft and Discord chat relay, console access, staff approvals, and support for dedicated Discord spaces for individual nations.

The mod is server-side only. Players do not need to install it on their clients.

17 top-level slash commands and ~130 subcommands, with all commands also available using the ! prefix.

Documentation: See the command reference for every command and subcommand, the configuration reference for available settings, and the API reference for addon development. Server owners can use the setup guide for bot configuration and OAuth2 account linking.

Dashboards

WN Discord provides interactive dashboards for commonly used information and actions.

/dashboard nation displays nation information and available actions in one view. /dashboard war provides live war information such as scores, siege progress, and other conflict details.

Staff have a separate administration dashboard for reviewing pending approvals and other administrative actions.

Discord integration

WN Discord connects several parts of Warring Nations to Discord:

• Staff approvals: review and approve configured actions directly from Discord.
• Live feeds: send nation, war, diplomacy, village, and government events to configurable channels.
• Government: use proposals, voting, and other government features through Discord.
• Per-nation Discord servers: allow individual nations to connect their own Discord servers.
• Two-way relay: synchronize Minecraft and Discord chat with filtering, rate limits, webhook identities, and message protection.
• Audit logs: record administrative activity performed through the Discord integration.
• Message templates: customize Discord messages through configurable templates with safe fallback behavior.

Extensibility API

WN Discord includes a public API for other Warring Nations addons.

Addons can interact with Discord without depending directly on JDA, using the same interfaces provided to the built-in integration. This includes registering channels, sending embeds, and registering slash commands.

See the full API example for an example implementation.

Setup

Place the jar in mods/ and start the server once. This generates config/warring-nations/wn-discord-server.toml.

Configure the Discord bot and restart the server. Bot credentials can also be provided through environment variables instead of being stored in the configuration file.

The setup and OAuth2 linking guide covers Discord application configuration, intents, permissions, bot setup, and account linking.

Companion addons

• WN Siege: adds protection and integration for supported combat and automation mods. Its /siege commands can also be used through WN Discord.
• WN BlueMap: adds live BlueMap integration for nations, territories, villages, and wars, with relevant map links available through Discord.