# gChat-Towny
\ngChat-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.
\n> \u26a0\ufe0f IMPORTANT:
\n> Starting from **GChat v2.3.0**, Towny support is built-in natively.
\n> 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.
\n>
\nFeatures
\n * Displays town and nation tags in chat (for legacy gChat versions).
\n * Supports HEX colors for tags (e.g., &#FF0000 \u2192 red).
\n * Integration with PlaceholderAPI:
\n * %gchat_towny% \u2014 full tag: [Nation | Town]
\n * %gchat_townytown% \u2014 town tag: [Town]
\n * %gchat_townynation% \u2014 nation tag: [Nation]
\n * Fully compatible with older versions of gChat: tags are automatically applied in chat format.
\n * Checks for Towny and gChat \u2014 disables itself safely if dependencies are missing.
\n * Debug mode for checking tags and configuration.
\n * Configurable via towny-gChat.yml.
\nInstallation
\n * Download gChat-Towny.jar.
\n * Place the file in your server’s plugins folder.
\n * Make sure you have installed:
\n * gChat (Version older than 2.3.0)
\n * Towny
\n * (optional) PlaceholderAPI
\n * Start the server. The plugin will create a configuration file at plugins\/gChat\/towny-gChat.yml.
\nConfiguration
\nExample towny-gChat.yml:
\ntag_formats:
\n town: ‘&f[&a%s&f] ‘
\n nation: ‘&f[&#FF5656%s&f] ‘
\n both: ‘&f[&c%s&f | &a%s&f] ‘
\nuse_hex_colors: true
\ndebug: false<\/p>\n
* tag_formats.town \u2014 format for town tag.
\n * tag_formats.nation \u2014 format for nation tag.
\n * tag_formats.both \u2014 format for both town and nation.
\n * use_hex_colors \u2014 enables HEX colors in tags.
\n * debug \u2014 enables console error output for debugging.
\nPlaceholderAPI Placeholders
\n| Placeholder | Description |
\n|—|—|
\n| %gchat_towny% | Full tag: [Nation \/ Town] |
\n| %gchat_townytown% | Town tag [Town] |
\n| %gchat_townynation% | Nation tag [Nation] |
\nCompatibility
\n * gChat < 2.3.0 (Only for versions older than 2.3.0)\n * Towny 0.101+\n * Minecraft 1.21+\n * PlaceholderAPI (optional)\n\n<\/p>\n","protected":false},"excerpt":{"rendered":"
Townyadvanced support addon for GChat<\/p>\n","protected":false},"featured_media":74965,"template":"","meta":{"_minecraft_slug":"gchat-towny-addon","_minecraft_project_id":"VeteDWWS","_minecraft_author":"Gomania","_minecraft_license":"MIT","_minecraft_downloads":134,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"gchat-towny-addon.zip","_minecraft_size_bytes":11473,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T18:55:16.774713Z","_minecraft_date_created":"2025-09-10T05:03:38.153493Z","_minecraft_date_modified":"2025-09-09T11:16:30.227558Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gchat-towny-addon","_minecraft_icon_attachment_id":74965,"_minecraft_imported_at":"2026-06-04T08:24:27+00:00","_minecraft_import_hash":"114a230673e175affcb85d9286225211","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,867,129],"mod_loader":[132,134],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-74964","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-social","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n