Minecraft plugin TownyChat

🔌 About TownyChat

TownyChat — is a Minecraft plugin that provides chat channels and formatting designed to integrate with the Towny ecosystem on Bukkit/Spigot/Paper servers.

🎯 Purpose

TownyChat provides configurable chat channels (town, nation, global and custom channels) and formatting hooks so Towny-aware chats can display town/nation context, tags and separate channel behaviour. It addresses the need for server owners to have Towny-aware chat separation and consistent formatting across Towny-controlled communities.

⚙ Main features

• Configurable chat channels via channels.yml (channel names, tags, permissions and formatting). ()
• Integration with Towny to expose town/nation context in chat messages. ()
• Placeholder support (placeholders for channel, town, nation and related data) for use with PlaceholderAPI and other placeholder systems. ()
• Extensible channel model used by Towny add-ons (for example culture channels provided by Towny add-ons). ()

🧩 Who it is for

• Server owners running Towny who need channel-based chat separation.
• Admins who want town/nation tags in chat and Towny-aware formatting.
• Servers on Bukkit/Spigot/Paper seeking a lightweight Towny chat manager. ()

🏗 Examples of use

• Separate town chat from global chat and show town tags automatically when players talk.
• Create custom channels (e.g., staff, trade, events) with their own formatting and permissions managed in channels.yml. ()
• Use placeholders to include %towny_town% or channel tags in chat formats for integrations such as scoreboard displays or Holographic displays. ()

⌨️ Commands

Note: Official, current command lists were not available in the scanned official sources; check the plugin repository or release notes for exact command syntax.

🔐 Permissions

⚙ Installation

📥 Installation

• Download TownyChat .jar from the plugin's official distribution (GitHub releases / repository). ()
• Place the .jar into the server's plugins/ folder.
• Restart the server (full restart, not /reload).
• After first start, check for generated configuration files (channels.yml and plugin folder).

📦 Dependencies

• Towny (required) — TownyChat is designed to integrate with Towny and expects Towny to be present. ()
• PlaceholderAPI (optional) — TownyChat exposes placeholders that can be used by PlaceholderAPI and similar systems. ()

🧾 Configuration

• TownyChat generates/uses channels.yml to define channels, tags, formatting and permissions. Server owners configure channel behaviour primarily through this file. ()
• MySQL/SQLite: Information about builtin database support for TownyChat was not found in the official sources; TownyChat is primarily a chat channel manager and typically stores configuration as YAML files.

🧠 Additional information

⚠ Known conflicts

• Chat formatting or double-prefix issues can appear when multiple chat formatting plugins (e.g., EssentialsX Chat, other chat managers) are present — administrators commonly encounter conflicts between TownyChat and other chat plugins and should verify precedence and formatting order. ()

Integrations & support

• Discord integration is commonly achieved via DiscordSRV and similar bridge plugins; DiscordSRV lists support for TownyChat in its integrations. ()

FAQ

Q1: Does TownyChat require Towny? A1: Yes — TownyChat is built to integrate with Towny and is intended for use on servers running Towny. ()

Q2: Where do I configure channels and permissions? A2: Channels and most permissions/formatting are configured in channels.yml created by the plugin; channel-specific permission nodes are typically declared there. ()

Q3: Does TownyChat provide placeholders? A3: Yes — TownyChat exposes placeholders that can be used via PlaceholderAPI or similar systems. ()

Q4: Is TownyChat compatible with DiscordSRV? A4: Yes — DiscordSRV documents compatibility/integration options with TownyChat. ()

Telemetry / bStats

Information about telemetry (bStats) or anonymous metrics collection was not reliably documented in the official sources scanned.

Support channels

For code, releases and issue tracking, consult the TownyAdvanced GitHub repositories and the Towny project portal. ()