GChat Towny addon

gChat-Towny

gChat-Towny is an addon for the gChat plugin that integrates support for Towny. It allows you to display player town and nation tags directly in chat using placeholders or formatted tags.

IMPORTANT:
Starting from GChat v2.3.0, Towny support is built-in natively.
If you are using gChat version 2.3.0 or higher, you do NOT need to install this addon. Please remove this jar to avoid conflicts.

Features

• Displays town and nation tags in chat (for legacy gChat versions).

• Supports HEX colors for tags (e.g., &#FF0000 → red).

• Integration with PlaceholderAPI:

  • %gchat_towny% — full tag: [Nation | Town]
  • %gchat_townytown% — town tag: [Town]
  • %gchat_townynation% — nation tag: [Nation]

• Fully compatible with older versions of gChat: tags are automatically applied in chat format.

• Checks for Towny and gChat — disables itself safely if dependencies are missing.

• Debug mode for checking tags and configuration.

• Configurable via towny-gChat.yml.
  Installation

• Download gChat-Towny.jar.

• Place the file in your server's plugins folder.

• Make sure you have installed:

  • gChat (Version older than 2.3.0)
  • Towny
  • (optional) PlaceholderAPI

• Start the server. The plugin will create a configuration file at plugins/gChat/towny-gChat.yml.
  Configuration
  Example towny-gChat.yml:
  tag_formats:
  town: '&f[&a%s&f] '
  nation: '&f[&#FF5656%s&f] '
  both: '&f[&c%s&f | &a%s&f] '
  use_hex_colors: true
  debug: false

• tag_formats.town — format for town tag.

• tag_formats.nation — format for nation tag.

• tag_formats.both — format for both town and nation.

• use_hex_colors — enables HEX colors in tags.

• debug — enables console error output for debugging.
  PlaceholderAPI Placeholders
  | Placeholder | Description |
  |---|---|
  | %gchat_towny% | Full tag: [Nation / Town] |
  | %gchat_townytown% | Town tag [Town] |
  | %gchat_townynation% | Nation tag [Nation] |
  Compatibility

• gChat < 2.3.0 (Only for versions older than 2.3.0)

• Towny 0.101+

• Minecraft 1.21+

• PlaceholderAPI (optional)