VelShout

# Shout - Velocity Plugin A lightweight Velocity proxy plugin that provides global shout and server invitation features with cooldown system. (#中文版本) ## Features - 📢 **Global Shout** - Send messages to all players across the proxy - 🎯 **Server Invitation** - Invite all players to join your current server with a clickable join button - ⏱️ **Cooldown System** - Separate cooldown timers for each command to prevent spam - 🎨 **Color Code Support** - Use `&` color codes in your messages - 📝 **Console Support** - Console can also use the shout command ## Commands | Command | Aliases | Description | Cooldown | |---------|---------|-------------|----------| | `/shout <message>` | `/s` | Send a global shout message to all players | 180 seconds | | `/yq <message>` | - | Invite all players to join your current server | 20 seconds | ### Color Codes You can use `&` followed by a color code in your messages. Example: - `&a` - Green - `&c` - Red - `&6` - Gold - `&l` - Bold - `&o` - Italic Example: `/shout &6&lImportant &aServer maintenance in 10 minutes!` ## Installation 1. Download the latest `Shout.jar` file 2. Place it in your Velocity server's `plugins` folder 3. Restart or reload your Velocity server 4. The plugin will automatically enable ## Configuration This plugin does not require any configuration file. All settings are hardcoded: - `/shout` cooldown: 180 seconds (3 minutes) - `/yq` cooldown: 20 seconds ## Permissions **No permissions required!** All commands are available to everyone by default. ## Requirements - Velocity 3.0.0 or higher - Java 21 or higher ## Commands Usage Examples ### Shout Command /shout Hello everyone! /s &cImportant &aServer restart in 5 minutes! ### YQ Command (Server Invitation) /yq Come join me for some PvP! /yq # Send invitation without custom message ## Troubleshooting ### Common Issues **Q: The plugin doesn't load** - Check the Velocity server logs for errors - Ensure you're using Velocity 3.0.0 or higher **Q: Color codes don't work** - Make sure you're using `&` not `§` in your messages - Example: `/shout &aThis is green text` **Q: Players can't see the invitation** - Ensure players have the `/server` command available on your proxy - The clickable join button requires client support ## Support For issues, suggestions, or questions, please contact the plugin author. ## License This plugin is proprietary software. All rights reserved. Unauthorized copying, distribution, or modification is prohibited. --- # 中文版本 # Shout - Velocity 插件 一个轻量级的 Velocity 代理端插件，提供全服喊话和服务器邀请功能，并带有冷却系统。 ## 功能特点 - 📢 **全服喊话** - 向代理端所有玩家发送消息 - 🎯 **服务器邀请** - 邀请所有玩家加入你当前所在的服务器，带有点击加入按钮 - ⏱️ **冷却系统** - 每个命令独立冷却时间，防止刷屏 - 🎨 **颜色代码支持** - 在消息中使用 `&` 颜色代码 - 📝 **控制台支持** - 控制台也可以使用喊话命令 ## 命令 | 命令 | 别名 | 描述 | 冷却时间 | |------|------|------|----------| | `/shout <消息>` | `/s` | 向所有玩家发送全服喊话 | 180 秒 | | `/yq <消息>` | - | 邀请所有玩家加入你当前所在的服务器 | 20 秒 | ### 颜色代码 你可以在消息中使用 `&` 加颜色代码。示例： - `&a` - 绿色 - `&c` - 红色 - `&6` - 金色 - `&l` - 粗体 - `&o` - 斜体 示例：`/shout &6&l重要通知 &a服务器将在10分钟后重启！` ## 安装方法 1. 下载最新的 `Shout.jar` 文件 2. 将其放入 Velocity 服务器的 `plugins` 文件夹 3. 重启或重载 Velocity 服务器 4. 插件将自动启用 ## 配置 本插件不需要任何配置文件。所有设置都是硬编码的： - `/shout` 冷却时间：180 秒（3 分钟） - `/yq` 冷却时间：20 秒 ## 权限 **无需任何权限！** 默认情况下所有玩家都可以使用所有命令。 ## 系统要求 - Velocity 3.0.0 或更高版本 - Java 21 或更高版本 ## 命令使用示例 ### 喊话命令 /shout 大家好！ /s &c重要 &a服务器将在5分钟后重启！ ### YQ 命令（服务器邀请） /yq 来和我一起PvP吧！ /yq # 不发送自定义消息直接邀请 ## 故障排除 ### 常见问题 **问：插件无法加载** - 检查 Velocity 服务器日志中的错误信息 - 确保你使用的是 Velocity 3.0.0 或更高版本 **问：颜色代码不生效** - 确保在消息中使用的是 `&` 而不是 `§` - 示例：`/shout &a这是绿色文字` **问：玩家看不到邀请** - 确保代理端有 `/server` 命令可用 - 点击加入按钮需要客户端支持 ## 支持 如有问题、建议或疑问，请联系插件作者。 ## 许可证 本插件为专有软件。保留所有权利。 未经授权禁止复制、分发或修改。