Chat Channels

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper

标签： management social utility

? 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

3. Copy the generated URL
4. Open it in your browser
5. 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!