MorayCrossServerChat - 跨服聊天插件 / Cross-Server Chat Plugin 🌐

---

📖 插件介绍 / Introduction

MorayCrossServerChat 是一个轻量级、高性能的 Velocity 跨服聊天插件。它让你的服务器网络中的玩家可以无缝交流，无论玩家身处哪个子服务器，都能实时收发全局消息和私聊消息。

MorayCrossServerChat is a lightweight, high-performance Velocity cross-server chat plugin. It allows players in your server network to communicate seamlessly—no matter which subserver they're on, they can send and receive global messages and private messages in real time.

✨ 开箱即用，零配置！/ Out of the box, zero configuration!
下载即用，无需任何繁琐设置。/ Download and use immediately—no tedious setup required.

---

✨ 功能特性 / Features

💬 全局聊天系统 / Global Chat System

• 跨服务器发送全局消息，所有在线玩家实时接收
  Send global messages across servers, instantly received by all online players
• 清晰的消息格式：[全局] 玩家名 @服务器名: 消息内容
  Clear message format: [Global] PlayerName @ServerName: Message
• 控制台可直接发送全局公告
  Console can send global announcements directly
• 玩家可随时开关全局聊天接收
  Players can toggle global chat reception on/off anytime

💌 私聊系统 / Private Messaging System

• 跨服务器私密聊天，不受子服务器限制
  Cross-server private chat, unrestricted by subserver boundaries
• 自动记忆最后私聊对象
  Automatically remembers last conversation partner
• 快捷回复功能，无需重复输入对方ID
  Quick reply function—no need to re-enter recipient's name
• 私聊消息双方可见，第三方不可见
  Private messages visible only to both parties

⚡ 快捷操作 / Quick Commands

• !消息 / !message - 快速发送全局消息 / Quickly send a global message
• @玩家 消息 / @player message - 快速发送私聊消息 / Quickly send a private message

---

🎮 命令列表 / Command List

主命令 / Main Command	别名 / Aliases	描述 / Description	权限 / Permission
/g <消息/message>	/global, /全局	发送全局消息 / Send a global message	无 / None
/togglechat	/toggleglobal, /切换聊天	开关全局聊天 / Toggle global chat on/off	无 / None
/msg <玩家/player> <消息/message>	/tell, /whisper, /w, /私聊	发送私聊 / Send a private message	无 / None
/r <消息/message>	/reply, /回复	回复最后私聊 / Reply to the last private message	无 / None
/list	/online, /players, /玩家列表	查看在线玩家 / View online players	无 / None
/chatinfo	/chathelp, /帮助, /chat	查看命令帮助 / View command help	无 / None

---

⚙️ 安装方法 / Installation

步骤1：下载插件 / Step 1: Download the Plugin

从 Modrinth 下载最新版本的 JAR 文件。
Download the latest JAR file from Modrinth.

步骤2：安装插件 / Step 2: Install the Plugin

将下载的 JAR 文件放入 Velocity 服务器的 plugins 文件夹。
Place the downloaded JAR file into your Velocity server's plugins folder.

步骤3：重启服务器 / Step 3: Restart the Server

重启 Velocity 代理端，插件会自动加载。
Restart your Velocity proxy—the plugin will load automatically.

步骤4：开始使用 / Step 4: Start Using

无需任何配置，玩家即可使用所有命令！
No configuration needed! Players can use all commands immediately.

---

🔧 环境要求 / Requirements

环境 / Environment	版本要求 / Version Requirements
代理端 / Proxy	Velocity 3.3.0+
Java	JDK 17+
后端服务器 / Backend Servers	任意 (Paper, Spigot, Fabric等) / Any (Paper, Spigot, Fabric, etc.)
客户端 / Client	Minecraft 1.7.2 - 1.20.4

⚠️ 注意 / Note：本插件仅支持 Velocity，不支持 BungeeCord/Waterfall。
This plugin supports Velocity only—BungeeCord/Waterfall is not supported.

---

📊 数据存储 / Data Storage

• 当前版本 / Current Version：所有数据存储在内存中，重启服务器后重置 / All data is stored in memory and resets after server restart
• 未来计划 / Future Plans：支持 MySQL/SQLite 持久化存储玩家设置 / MySQL/SQLite support for persistent player settings

---

🛠️ 开发者信息 / Developer Info

• 作者 / Author：Mc_ictuc
• 版本 / Version：2.0.1
• 开源协议 / License：MIT License

---

📅 更新计划 / Roadmap

• 配置文件支持 / Configuration Support - 自定义消息格式、颜色、前缀 / Customize message format, colors, prefixes
• 数据库存储 / Database Storage - 持久化保存玩家聊天设置 / Persistent storage for player chat settings
• 聊天过滤 / Chat Filtering - 敏感词屏蔽、广告过滤 / Profanity filtering, spam protection
• Discord 同步 / Discord Integration - 游戏-Discord 双向消息同步 / Bidirectional chat sync between game and Discord
• 多语言 / Multi-language - 中英文切换 / English/Chinese language switching
• 聊天频道 / Chat Channels - 自定义聊天频道（队伍、公会、世界）/ Custom channels (party, guild, world)

---

❓ 常见问题 / FAQ

Q：命令无法使用，提示“此命令不存在”？ / Commands don't work—I get "This command does not exist"?
A：请检查插件是否已正确加载，在控制台输入 velocity plugins 查看插件列表。
Check if the plugin loaded correctly by typing velocity plugins in the console.

Q：支持 BungeeCord 吗？ / Does this support BungeeCord?
A：不支持。本插件专为 Velocity 设计，使用了 Velocity 特有的 API。
No. This plugin is designed exclusively for Velocity using Velocity-specific APIs.

Q：如何发送公告？ / How do I send announcements?
A：在 Velocity 控制台直接输入 /g 公告内容。
Type /g announcement text directly in the Velocity console.

Q：玩家能屏蔽其他人的全局消息吗？ / Can players block global messages from others?
A：可以。使用 /togglechat 命令开关全局聊天接收。
Yes. Use the /togglechat command to toggle global chat reception on/off.

---

📝 许可证 / License

本项目采用 MIT 许可证。您可以自由使用、修改和分发本插件，但需保留版权声明。
This project is licensed under the MIT License. You are free to use, modify, and distribute this plugin, provided that the copyright notice is retained.