# \ud83d\udcac Chat-Channels<\/p>\n
Chat-Channels is a lightweight and flexible Paper plugin that allows players to **switch between multiple chat channels**, each with its own formatting and **full Discord integration (webhooks + bot sync)** \ud83c\udf10.<\/p>\n
Perfect for servers that want **clean, organized communication** between players, staff, and communities \u2014 both in-game and on Discord.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
* \ud83d\udcac Multiple customizable chat channels
\n* \ud83d\udd01 Switch channels easily with a command
\n* \ud83c\udff7\ufe0f Custom prefixes per channel
\n* \ud83d\udc51 Staff-only channels (OP restricted)
\n* \ud83c\udf10 Discord webhook integration (Minecraft \u2192 Discord)
\n* \ud83e\udd16 Discord bot integration (Discord \u2192 Minecraft)
\n* \ud83d\udd17 Sync specific Discord channels with in-game channels
\n* \ud83e\uddd1 Player avatars in Discord messages (webhooks)
\n* \ud83c\udfa8 Full color support (including HEX colors)
\n* \ud83e\udde9 Optional Vault integration (prefix & suffix support)
\n* \ud83d\udd04 Hot reload with automatic bot restart if token changes
\n* \u26a1 Lightweight and simple configuration
\n* \ud83d\udce1 Global chat support (vanilla + optional Discord sync)<\/p>\n
—<\/p>\n
## \ud83e\udde9 Vault Support (Optional)<\/p>\n
If you install Vault (with plugins like LuckPerms):<\/p>\n
* \ud83d\udc51 Player prefixes & suffixes are automatically applied
\n* \ud83c\udfa8 Colors are fully supported
\n* \ud83d\udcac Chat formatting becomes more dynamic and customizable<\/p>\n
No configuration required \u2014 just install Vault.<\/p>\n
If Vault is not installed, the plugin will still work normally.<\/p>\n
—<\/p>\n
## \ud83d\udcdc Commands<\/p>\n
* `\/channel —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n Each channel can be fully customized in `config.yml`:<\/p>\n “`yml channels: staff: * \ud83c\udff7\ufe0f `prefix` \u2192 How the channel appears in chat —<\/p>\n ## \ud83d\udce6 Installation<\/p>\n 1. \ud83d\udce5 Download the latest `.jar` —<\/p>\n ## \u2699\ufe0f How it works<\/p>\n * \ud83d\udc64 Players are automatically assigned to the **global channel** —<\/p>\n ## \ud83d\udee1\ufe0f Channel System<\/p>\n * \ud83c\udf0d **Global channel**<\/p>\n * Uses normal Minecraft chat * \ud83d\udc51 **Staff channel**<\/p>\n * Only accessible by OP players * \u2699\ufe0f **Custom channels**<\/p>\n * Fully configurable —<\/p>\n ## \ud83e\udd16 Discord Bot Setup<\/p>\n ### 1\ufe0f\u20e3 Create a Discord Application<\/p>\n 1. Go to: https:\/\/discord.com\/developers\/applications —<\/p>\n ### 2\ufe0f\u20e3 Create the Bot<\/p>\n 1. Go to the **”Bot”** tab<\/p>\n 2. Click **”Add Bot”**<\/p>\n 3. Enable the following:<\/p>\n * \u2705 **Public Bot** 4. Copy the **TOKEN** and put it in your `config.yml`:<\/p>\n “`yml —<\/p>\n ### 3\ufe0f\u20e3 Invite the Bot to your Server<\/p>\n 1. Go to **OAuth2 \u2192 URL Generator** **Scopes:**<\/p>\n * `bot`<\/p>\n **Bot Permissions:**<\/p>\n * View Channels 3. Copy the generated URL —<\/p>\n ## \ud83d\udd17 How to get a Channel ID<\/p>\n 1. Go to Discord settings \u2192 Advanced “`yml —<\/p>\n ## \ud83c\udf10 How to create a Webhook<\/p>\n 1. Go to your Discord channel Then paste it in your config (optional):<\/p>\n “`yml —<\/p>\n ## \ud83d\udcdd Notes<\/p>\n * \ud83d\udc64 Only players can use commands —<\/p>\n ## \ud83d\ude80 Future ideas<\/p>\n * \ud83d\udd10 Permission-based channels (LuckPerms deeper integration) —<\/p>\n ## \ud83d\udc64 Author<\/p>\n Developed by **Wilkcraft**<\/p>\n ## \ud83d\udcc4 License<\/p>\n This project is licensed under the **MIT License** – see the LICENSE file for details.<\/p>\n —<\/p>\n \ud83d\udcac Organize your server chat and connect it with Discord!<\/p>\n","protected":false},"excerpt":{"rendered":" Lightweight chat channels plugin for Paper that lets players switch between channels and sync messages to Discord via webhooks.<\/p>\n","protected":false},"featured_media":38694,"template":"","meta":{"_minecraft_slug":"chat-channels-wilkcraft","_minecraft_project_id":"oozwl11y","_minecraft_author":"Wilkcraft","_minecraft_license":"MIT","_minecraft_downloads":19,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"chat-channels-wilkcraft.zip","_minecraft_size_bytes":39869359,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T22:34:08.914374Z","_minecraft_date_created":"2026-04-15T23:37:49.506345Z","_minecraft_date_modified":"2026-04-21T18:01:53.922134Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/chat-channels-wilkcraft","_minecraft_icon_attachment_id":38694,"_minecraft_imported_at":"2026-06-01T20:06:02+00:00","_minecraft_import_hash":"4c5f9abb8761163dc75994a0f9b3133b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,867,123,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-38693","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-social","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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","minecraft_version-1-21-9"],"yoast_head":"\n
\n* `\/channel reload` – \ud83d\udd04 Reload configuration (OP only)<\/p>\n
\ndiscord:
\n token: “” # Optional (enables Discord bot)<\/p>\n
\n global:
\n prefix: “[Global]”
\n webhook: “” # Optional
\n discord-channel-id: “” # Optional<\/p>\n
\n prefix: “[Staff]”
\n webhook: “YOUR_WEBHOOK_URL” # Optional
\n discord-channel-id: “” # Optional
\n“`<\/p>\n
\n* \ud83c\udf10 `webhook` \u2192 Sends Minecraft messages to Discord (optional)
\n* \ud83e\udd16 `discord-channel-id` \u2192 Sync Discord \u2192 Minecraft (optional)
\n* \ud83d\udd11 `discord.token` \u2192 Enables the Discord bot (optional)
\n* \ud83c\udfa8 Supports HEX colors (e.g. `&#FFAA00`)
\n* \ud83c\udf10 Colors are automatically cleaned when sent to Discord<\/p>\n
\n2. \ud83d\udcc2 Place it in your server’s `plugins` folder
\n3. \u25b6\ufe0f Start or restart your server
\n4. \ud83d\udcdd Edit `config.yml` to customize channels<\/p>\n
\n* \ud83d\udd04 Use `\/channel` to switch between available channels
\n* \ud83d\udcac Messages are only visible to players in the same channel
\n* \ud83c\udf10 Messages can be sent to Discord via webhooks (optional)
\n* \ud83e\udd16 Discord messages can appear in Minecraft (optional)<\/p>\n
\n * Optional Discord sync<\/p>\n
\n * Private communication<\/p>\n
\n * Unlimited possibilities<\/p>\n
\n2. Click **”New Application”**
\n3. Give it a name and create it<\/p>\n
\n * \u2705 **Server Members Intent**
\n * \u2705 **Message Content Intent**<\/p>\n
\ndiscord:
\n token: “YOUR_BOT_TOKEN”
\n“`<\/p>\n
\n2. Select:<\/p>\n
\n* Send Messages
\n* Read Message History<\/p>\n
\n4. Open it in your browser
\n5. Add the bot to your server<\/p>\n
\n2. Enable **Developer Mode**
\n3. Right-click a channel \u2192 **Copy ID**
\n4. Paste it in your config (optional):<\/p>\n
\ndiscord-channel-id: “123456789012345678”
\n“`<\/p>\n
\n2. Click \u2699\ufe0f **Edit Channel**
\n3. Go to **Integrations \u2192 Webhooks**
\n4. Click **New Webhook**
\n5. Copy the webhook URL<\/p>\n
\nwebhook: “https:\/\/discord.com\/api\/webhooks\/…”
\n“`<\/p>\n
\n* \u2699\ufe0f Works with Paper 1.21+
\n* \ud83d\udcc4 Uses YAML configuration
\n* \ud83c\udf10 Discord integration is fully optional<\/p>\n
\n* \ud83c\udfa8 More chat formatting options
\n* \ud83d\udcca Channel-specific settings (cooldowns, filters)
\n* \ud83d\udda5\ufe0f GUI for channel selection<\/p>\n