ModsJava
TownyDiscordChat
Java mod listed for Minecraft 1.21–26.x. Downloads from the MC Java Mods app on Android.
⬇ Download on Spigot
TownyDiscordChat 3.3.0
Towny Advanced ↔ DiscordSRV bridge for Paper and Purpur
GitHub source · Original inspiration
Towny Advanced ↔ DiscordSRV bridge for Paper and Purpur
GitHub source · Original inspiration
TownyDiscordChat connects Towny Advanced towns and nations to DiscordSRV. It creates private Discord resources, provides secure town and nation chat bridges, synchronizes linked accounts and publishes useful Towny activity in rich embeds.
Highlights
- Town and nation resources: roles, private text channels and voice channels created and synchronized automatically.
- Town-only bridge: Minecraft town chat goes to the matching Discord channel and Discord messages go only to online residents of that town.
- Nation bridge: Minecraft nation chat goes to the matching nation channel and Discord messages are delivered only to online members of that nation.
- Global chat compatibility: DiscordSRV continues to handle global chat normally; TownyDiscordChat intercepts only messages detected as `town` or `nation` chat.
- Security: linked-account validation, wrong-town protection and Discord administrator overrides.
- No staff channel: town notifications are delivered in the normal town channel.
- Bank embeds: deposits, withdrawals, taxes, balances, actors and reasons with configurable fields.
- Town events: resident join/leave, mayor changes, rank changes, jail, outlaw and tax notifications.
- Daily NewDay summary: town status, economy, taxes, residents and spawn information.
- Interactive buttons: private Taxes, Residents and Outposts views from the daily summary.
- Residents and outposts: ranks, last access, PlotGroup names, worlds and coordinates with pagination.
- Town fall reports: global embeds for bankruptcy, ruin or fall with configurable story variants; NPC residents are excluded.
- Dynmap: `/town map` generates an overhead image of a town.
- InteractiveChat: item previews through InteractiveChat DiscordSRV Addon, plus a fallback embed for supported components.
- PlaceholderAPI: external placeholders work in bridge formats, titles, descriptions, footers and fields.
- Five locales: English, Italian, French, Spanish and Polish with English fallback.
Requirements
- Paper or Purpur 1.21+.
- Paper/Purpur 26.* is supported; Paper 26.* requires Java 25.
- Java 21+ for 1.21.x servers.
- Towny Advanced and DiscordSRV are required.
Required dependencies
Optional soft-dependencies
Installation
- Install Towny Advanced and DiscordSRV and configure DiscordSRV's Main Guild.
- Give the bot Manage Roles, Manage Channels, Manage Channel Permissions, View Channels, Send Messages, Embed Links and Read Message History.
- Place the bot role above TownyDiscordChat roles and enable Message Content Intent.
- Put the jar in `/plugins`, start once, edit `config.yml` and run `/tdc sync`.
Language configuration
Code (Text):
language: en
# Available: en, it, fr, es, pl
Example configuration
Code (Text):
bridge:
Enabled: true
TownChatOnly: true
RequireLinkedAccount: true
RequireCurrentTown: true
MinecraftFormat: "**[MC] %player%:** %message%"
DiscordFormat: "&8[&2TDC&8] &c%titolo% &8» &7%usernameds% &8» &f%message%"
NationMinecraftFormat: "**[MC] %player%:** %message%"
NationDiscordFormat: "&8[&2NATION&8] &b%nazione% &8» &7%usernameds% &8» &f%message%"
townychat:
TownChannelNames: ["town"]
NationChannelNames: ["nation", "nc"]
CommandListener:
TownCommands: ["tc", "townchat", "town"]
NationCommands: ["nc", "nationchat", "nation"]
OtherCommands: ["g", "global", "globalchat", "a", "admin", "m", "mod"]
messages:
DailySummaryButtons:
Enabled: true
TaxesLabel: "Taxes"
ResidentsLabel: "Residents"
OutpostsLabel: "Outposts"
TownEvents:
rank-add:
Enabled: true
Format: " **Rank:** %resident% received **%rank%** (by %actor%)."
rank-remove:
Enabled: true
Format: " **Rank:** **%rank%** was removed from %resident% (by %actor%)."
taxes:
Enabled: true
Format: " **Taxes:** town tax set to **%tax%** (by %actor%)."
- `/tdc sync`, `/tdc check role`, `/tdc channels delete <town|all>`, `/tdc channels restore <town|all>`.
- `/t discord <newday|chat|jail> <enable|disable>` for town feature toggles.
- `/town info`, `/town sync`, `/town map [town]`, `/town notice message:<text>`, `/town resync`.
Permissions
Code (Text):
TownyDiscordChat.Admin
TownyDiscordChat.Player
TownyDiscordChat.Sync
TownyDiscordChat.Check.Role
TownyDiscordChat.Check.Role.AllLinked
TownyDiscordChat.Check.Role.CreateAllTownsAndNations
TownyDiscordChat.Check.TextChannel.AllTownsAndNations
TownyDiscordChat.Check.VoiceChannel.AllTownsAndNations
TownyDiscordChat.Player
TownyDiscordChat.Sync
TownyDiscordChat.Check.Role
TownyDiscordChat.Check.Role.AllLinked
TownyDiscordChat.Check.Role.CreateAllTownsAndNations
TownyDiscordChat.Check.TextChannel.AllTownsAndNations
TownyDiscordChat.Check.VoiceChannel.AllTownsAndNations
The plugin uses public Bukkit/Paper APIs only and no NMS. Towny, DiscordSRV and optional integrations must support your server version. Report issues through the GitHub issue tracker.
Inspired by TownyDiscordChat on SpigotMC.
Authors and contributors: thejames10, Hugo5000 and Smokytek.
Support the project
If TownyDiscordChat is useful to your server, please leave a positive review on SpigotMC. Your feedback helps other server owners discover the resource and supports continued development.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1, 26.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
TownyDiscordChat is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 48 times (via Spigot). Download it and open it directly in the game.