ChatTools - Velocity Cross-Server Chat Plugin

ChatTools is a cross-server chat management plugin designed for Minecraft Velocity servers. It supports global message synchronization, custom server display names, and cross-server private messaging, enhancing player communication in multi-server environments.

Note: This plugin is AI-developed to simplify cross-server chat management.

---

Features

• Cross-Server Message Sync:
  • Messages sent by players on any sub-server are broadcast to all online players in real-time.
  • Message format includes server alias and player name.
• Custom Server Names:
  • Define server display names via configuration files (e.g., lobby → Main Lobby).
• Cross-Server Private Messaging:
  • Use /tell or /msg to privately message players across servers.
  • Messages are visible only to the sender, receiver, and console.
  • Supports tab-completion for online player names.
• Dynamic Configuration:
  • Use /chattools reload to reload configurations without restarting the server.
• Compatibility:
  • Supports Velocity 3.4+ and Minecraft 1.16+.

---

Installation

1. Download the Plugin

Download the latest ChatTools.jar from GitHub or other distribution channels.

2. Install the Plugin

Place the downloaded ChatTools.jar into the plugins/ directory of your Velocity server.

3. Start the Server

Start the Velocity server. The plugin will automatically generate the default configuration file at plugins/ChatTools/config.yml.

---

Usage

Commands

Command	Permission	Description
/chattools reload	chattools.reload	Reload the plugin configuration file to apply changes immediately.
/tell <player> <message>	chattools.command.tell	Send a private message to a player across servers.
/msg <player> <message>	chattools.command.tell	Alias for /tell.

Examples

1. Cross-Server Chat

A player in the Lobby server sends:

  [Main Lobby] Steve: Hello everyone!

A player in the Survive server replies:

  [Survival World] Alex: Welcome to Survival!

1. Cross-Server Private Message:

  [Main Lobby] Steve → [Survival World] Alex: How's it going?

---

Configuration

The configuration file is located at plugins/ChatTools/config.yml:

servers:
  lobby:
    name: "Main Lobby"
    color: "AQUA"
  survive:
    name: "Survival World"
    color: "GREEN"
  minigame:
    name: "MiniGame Zone"
    color: "YELLOW"

• Keys (e.g., lobby) are Velocity server IDs.
• Values (e.g., Main Lobby) are display names used in chat.

---

Support and Feedback

If you encounter any issues or have suggestions for improvements, please contact us through the following channels:

• GitHub Issues: Submit an issue

---

License & Disclaimer

• Development Statement: This plugin is AI-developed to provide efficient chat management for the Minecraft Velocity community.

• License: Licensed under GNU General Public License v3.0. You are free to use, modify, and distribute it under the license terms.

• Disclaimer: The developer is not responsible for any issues arising from the use of this plugin.

---

Acknowledgements

Special thanks to the following technologies and tools:

• Velocity API
• SnakeYAML
• Adventure API

---

中文版：Github