?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Chat Channels

Chat Channels

Lightweight chat channels plugin for Paper that lets players switch between channels and sync messages to Discord via webhooks.

19
1
19
1

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

Report issues View source

Tags

Creators

Details

Licensed MIT
Published last month

💬 Chat-Channels

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) 🌐.

Perfect for servers that want clean, organized communication between players, staff, and communities — both in-game and on Discord.

✨ Features

  • 💬 Multiple customizable chat channels
  • 🔁 Switch channels easily with a command
  • 🏷️ Custom prefixes per channel
  • 👑 Staff-only channels (OP restricted)
  • 🌐 Discord webhook integration (Minecraft → Discord)
  • 🤖 Discord bot integration (Discord → Minecraft)
  • 🔗 Sync specific Discord channels with in-game channels
  • 🧑 Player avatars in Discord messages (webhooks)
  • 🎨 Full color support (including HEX colors)
  • 🧩 Optional Vault integration (prefix & suffix support)
  • 🔄 Hot reload with automatic bot restart if token changes
  • ⚡ Lightweight and simple configuration
  • 📡 Global chat support (vanilla + optional Discord sync)

🧩 Vault Support (Optional)

If you install Vault (with plugins like LuckPerms):

  • 👑 Player prefixes & suffixes are automatically applied
  • 🎨 Colors are fully supported
  • 💬 Chat formatting becomes more dynamic and customizable

No configuration required — just install Vault.

If Vault is not installed, the plugin will still work normally.

📜 Commands

  • /channel <name> - 💬 Switch to a channel
  • /channel reload - 🔄 Reload configuration (OP only)

⚙️ Configuration

Each channel can be fully customized in config.yml:

discord:
  token: "" # Optional (enables Discord bot)

channels:
  global:
    prefix: "[Global]"
    webhook: "" # Optional
    discord-channel-id: "" # Optional

  staff:
    prefix: "[Staff]"
    webhook: "YOUR_WEBHOOK_URL" # Optional
    discord-channel-id: "" # Optional
  • 🏷️ prefix → How the channel appears in chat
  • 🌐 webhook → Sends Minecraft messages to Discord (optional)
  • 🤖 discord-channel-id → Sync Discord → Minecraft (optional)
  • 🔑 discord.token → Enables the Discord bot (optional)
  • 🎨 Supports HEX colors (e.g. &#FFAA00)
  • 🌐 Colors are automatically cleaned when sent to Discord

📦 Installation

  1. 📥 Download the latest .jar
  2. 📂 Place it in your server's plugins folder
  3. ▶️ Start or restart your server
  4. 📝 Edit config.yml to customize channels

⚙️ How it works

  • 👤 Players are automatically assigned to the global channel
  • 🔄 Use /channel to switch between available channels
  • 💬 Messages are only visible to players in the same channel
  • 🌐 Messages can be sent to Discord via webhooks (optional)
  • 🤖 Discord messages can appear in Minecraft (optional)

🛡️ Channel System

  • 🌍 Global channel

    • Uses normal Minecraft chat
    • Optional Discord sync

  • 👑 Staff channel

    • Only accessible by OP players
    • Private communication

  • ⚙️ Custom channels

    • Fully configurable
    • Unlimited possibilities

🤖 Discord Bot Setup

1️⃣ Create a Discord Application

  1. Go to: https://discord.com/developers/applications
  2. Click "New Application"
  3. Give it a name and create it

2️⃣ Create the Bot

  1. Go to the "Bot" tab

  2. Click "Add Bot"

  3. Enable the following:

    • ✅ Public Bot
    • ✅ Server Members Intent
    • ✅ Message Content Intent

  4. Copy the TOKEN and put it in your config.yml:

discord:
  token: "YOUR_BOT_TOKEN"

3️⃣ Invite the Bot to your Server

  1. Go to OAuth2 → URL Generator
  2. Select:

Scopes:

  • bot

Bot Permissions:

  • View Channels
  • Send Messages
  • Read Message History
  1. Copy the generated URL
  2. Open it in your browser
  3. Add the bot to your server

🔗 How to get a Channel ID

  1. Go to Discord settings → Advanced
  2. Enable Developer Mode
  3. Right-click a channel → Copy ID
  4. Paste it in your config (optional):
discord-channel-id: "123456789012345678"

🌐 How to create a Webhook

  1. Go to your Discord channel
  2. Click ⚙️ Edit Channel
  3. Go to Integrations → Webhooks
  4. Click New Webhook
  5. Copy the webhook URL

Then paste it in your config (optional):

webhook: "https://discord.com/api/webhooks/..."

📝 Notes

  • 👤 Only players can use commands
  • ⚙️ Works with Paper 1.21+
  • 📄 Uses YAML configuration
  • 🌐 Discord integration is fully optional

🚀 Future ideas

  • 🔐 Permission-based channels (LuckPerms deeper integration)
  • 🎨 More chat formatting options
  • 📊 Channel-specific settings (cooldowns, filters)
  • 🖥️ GUI for channel selection

👤 Author

Developed by Wilkcraft

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

💬 Organize your server chat and connect it with Discord!