VersionTinmoli
版本: 1.0.2
支持平台: Velocity 3.0+ | BungeeCord 1.16+ | Bukkit/Spigot/Paper 1.20.1+
一款轻量级的 Minecraft 代理/服务器插件,用于自定义显示在服务器列表中的版本名称,支持丰富的颜色和格式。
中文文档 | English Documentation
目录
功能特性
- 彩色版本名称 - Velocity 支持 MiniMessage 格式(RGB、渐变、彩虹),BungeeCord/Bukkit 支持传统颜色代码
- 丰富格式 - 支持粗体、斜体、下划线、删除线
- 热重载 - 使用
/vt reload 命令重载配置
- 动态修改 - 使用
/vt md <name> 命令即时修改版本名称
- 简单配置 - YAML 配置文件
- 轻量级 - 无性能影响
- 自动回退 - 兼容旧版客户端
- 多语言 - 支持英文和中文
支持平台
| 平台 |
版本 |
Java 版本 |
状态 |
| Velocity |
3.0+ |
Java 21+ |
完全支持 |
| BungeeCord |
1.16+ |
Java 17+ |
完全支持 |
| Bukkit/Spigot |
1.20.1-1.21.11 |
Java 17+ |
需要较新版本 |
| Paper |
1.20.1-1.21.11 |
Java 17+ |
完全支持 |
快速开始
安装
- 从 Releases 下载对应平台的 JAR 文件
- 将 JAR 文件放入服务器的
plugins/ 目录
- 重启服务器
- 编辑配置文件(自动生成)
- 使用
/vt reload 重载配置
配置文件位置
- Velocity:
plugins/versiontinmoli/config.yml
- BungeeCord:
plugins/VersionTinmoli/config.yml
- Bukkit:
plugins/VersionTinmoli/config.yml
颜色支持
Velocity - MiniMessage 格式
# 命名颜色
version_name: "<gold>Velocity</gold> <gray>1.8-1.21</gray>"
# RGB 颜色 (1.16+)
version_name: "<#FF5555>Red <#55FF55>Green"
# 渐变效果
version_name: "<gradient:red:blue>Rainbow Server</gradient>"
# 彩虹效果
version_name: "<rainbow>Rainbow Server</rainbow>"
# 样式组合
version_name: "<bold><gold>VIP</gold></bold> <gray>| <green>Online</green></gray>"
可用颜色: <red>, <gold>, <yellow>, <green>, <aqua>, <blue>, <light_purple>, <white>, <gray>, <dark_gray>, <black>
可用样式: <bold>, <italic>, <underlined>, <strikethrough>
BungeeCord/Bukkit - 传统颜色代码
# 基本颜色
version_name: "&6BungeeCord &71.8-1.21"
# 带格式
version_name: "&l&6VIP Server&r &7| &a1.8-1.21"
# 多色组合
version_name: "&cRed &6Gold &eYellow &aGreen"
颜色代码: &0-&9, &a-&f (黑, 深蓝, 深绿, 深青, 深红, 紫, 金, 灰, 深灰, 蓝, 绿, 青, 红, 粉, 黄, 白)
格式代码: &l (粗体), &m (删除线), &n (下划线), &o (斜体), &r (重置)
客户端兼容性
| 客户端版本 |
支持的颜色 |
| 1.16+ |
完整 RGB 颜色 |
| 1.7-1.15 |
16 种命名颜色 |
| < 1.7 |
基本颜色 |
命令
| 命令 |
权限 |
描述 |
/vt |
versiontinmoli.admin |
显示插件信息 |
/vt reload |
versiontinmoli.admin |
重载配置文件 |
/vt md <name> |
versiontinmoli.admin |
修改版本名称 |
权限说明: Velocity/BungeeCord 需要 versiontinmoli.admin 权限,Bukkit 默认为 OP
配置
基础配置
# VersionTinmoli 配置文件
# 自定义显示在服务器列表中的版本名称
# 语言设置 (en_US 或 zh_CN)
language: "en_US"
# 版本名称配置
version_name: "Velocity 1.8.x-1.21.11"
语言设置
插件支持多种语言。您可以在配置文件中设置语言:
修改 language 字段后,使用 /vt reload 重载配置即可切换语言。所有命令消息和提示将以相应语言显示。
语言文件自定义
首次运行时,语言文件会自动复制到外部目录:
- Velocity:
plugins/versiontinmoli/lang/
- BungeeCord:
plugins/VersionTinmoli/lang/
- Bukkit:
plugins/VersionTinmoli/lang/
您可以编辑这些文件来自定义消息。插件会优先从外部目录加载,然后回退到内置文件。
配置示例
普通服务器
# Velocity
version_name: "<gold>Minecraft</gold> <gray>1.8-1.21</gray>"
# BungeeCord/Bukkit
version_name: "&6Minecraft &71.8-1.21"
VIP 服务器
# Velocity
version_name: "<bold><gradient:gold:yellow>VIP Server</gradient></bold>"
# BungeeCord/Bukkit
version_name: "&l&6VIP Server"
小游戏服务器
# Velocity
version_name: "<rainbow>MiniGames</rainbow> <white>| <green>Online</green></white>"
# BungeeCord/Bukkit
version_name: "&cM&6i&en&ai&9G&ba&dm&5e&cs &f| &aOnline"
PVP 服务器
# Velocity
version_name: "<bold><red>PVP</red></bold> <gray>| <yellow>Fighting</yellow></gray>"
# BungeeCord/Bukkit
version_name: "&l&cPVP &r&7| &eFighting"
常见问题
从 TOML 迁移到 YAML
如果您是从旧版本(v1.0.2 之前)升级,则需要将配置文件从 TOML 格式迁移到 YAML 格式。
自动迁移(推荐):
- 备份你的
config.toml 文件
- 删除
config.toml 文件
- 重启服务器或运行
/vt reload
- 插件将自动创建一个新的
config.yml 文件
- 编辑
config.yml 并设置自定义版本名称
手动迁移:
TOML 格式(旧版):
version_name = "My Server 1.20"
YAML 格式(新版):
version_name: "My Server 1.20"
主要区别:使用冒号 : 代替等号 =
配置未生效
- 确保配置文件位于正确的位置
- 检查 YAML 语法是否正确
- 使用
/vt reload 重新加载配置
- 如果仍然无效,请重启服务器
颜色未显示或显示为文本
问题:RGB 颜色代码显示为类似 Red</> Green</> 的文本
原因:使用了错误的闭合标签 </>
解决方案:
# 错误写法
version_name: "<#FF5555>Red</> <#55FF55>Green</>"
# 正确写法
version_name: "<#FF5555>Red <#55FF55>Green"
version_name: "<color:#FF5555>Red</color> <color:#55FF55>Green</color>"
其他颜色相关问题:
- Velocity:使用 MiniMessage 格式
<gold>text</gold>
- BungeeCord/Bukkit:使用
& 或 § 颜色代码
- RGB 颜色需要 Minecraft 1.16+ 客户端支持
- 检查服务器日志以查找错误
平台特定要求
- Velocity:需要 Velocity 3.0+ 和 Java 21+
- BungeeCord:需要 BungeeCord 1.16+ 和 Java 17+
- Bukkit:需要 Minecraft 1.20.1+ 和 Java 17+
许可证
本项目基于 MIT 许可证开源。
支持
如有问题或建议,请在 GitHub Issues 上提交。
文档版本:1.0.2
维护者:Tinmoli
VersionTinmoli
Version: 1.0.2
Supported Platforms: Velocity 3.0+ | BungeeCord 1.16+ | Bukkit/Spigot/Paper 1.20.1+
A lightweight Minecraft proxy/server plugin for customizing the version name displayed in the server list, with rich color and formatting support.
中文文档 | English Documentation
Table of Contents
Features
- Colored Version Names - Velocity supports MiniMessage format (RGB, gradients, rainbow), BungeeCord/Bukkit support legacy color codes
- Rich Formatting - Bold, italic, underline, strikethrough support
- Hot Reload - Reload configuration with
/vt reload command
- Dynamic Modification - Instantly modify version name with
/vt md <name> command
- Simple Configuration - YAML configuration file
- Lightweight - No performance impact
- Auto Fallback - Compatible with older client versions
- Multi-language - Supports English and Chinese
Supported Platforms
| Platform |
Version |
Java Version |
Status |
| Velocity |
3.0+ |
Java 21+ |
Fully Supported |
| BungeeCord |
1.16+ |
Java 17+ |
Fully Supported |
| Bukkit/Spigot |
1.20.1-1.21.11 |
Java 17+ |
Requires newer version |
| Paper |
1.20.1-1.21.11 |
Java 17+ |
Fully Supported |
Quick Start
Installation
- Download the JAR file for your platform from Releases
- Place the JAR file in your server's
plugins/ directory
- Restart the server
- Edit the configuration file (auto-generated)
- Use
/vt reload to reload the configuration
Configuration File Location
- Velocity:
plugins/versiontinmoli/config.yml
- BungeeCord:
plugins/VersionTinmoli/config.yml
- Bukkit:
plugins/VersionTinmoli/config.yml
Color Support
Velocity - MiniMessage Format
# Named colors
version_name: "<gold>Velocity</gold> <gray>1.8-1.21</gray>"
# RGB colors (1.16+)
version_name: "<#FF5555>Red <#55FF55>Green"
# Gradient effects
version_name: "<gradient:red:blue>Rainbow Server</gradient>"
# Rainbow effects
version_name: "<rainbow>Rainbow Server</rainbow>"
# Style combinations
version_name: "<bold><gold>VIP</gold></bold> <gray>| <green>Online</green></gray>"
Available Colors: <red>, <gold>, <yellow>, <green>, <aqua>, <blue>, <light_purple>, <white>, <gray>, <dark_gray>, <black>
Available Styles: <bold>, <italic>, <underlined>, <strikethrough>
BungeeCord/Bukkit - Legacy Color Codes
# Basic colors
version_name: "&6BungeeCord &71.8-1.21"
# With formatting
version_name: "&l&6VIP Server&r &7| &a1.8-1.21"
# Multi-color combinations
version_name: "&cRed &6Gold &eYellow &aGreen"
Color Codes: &0-&9, &a-&f (black, dark blue, dark green, dark aqua, dark red, purple, gold, gray, dark gray, blue, green, aqua, red, pink, yellow, white)
Format Codes: &l (bold), &m (strikethrough), &n (underline), &o (italic), &r (reset)
Client Compatibility
| Client Version |
Supported Colors |
| 1.16+ |
Full RGB colors |
| 1.7-1.15 |
16 named colors |
| < 1.7 |
Basic colors |
Commands
| Command |
Permission |
Description |
/vt |
versiontinmoli.admin |
Show plugin information |
/vt reload |
versiontinmoli.admin |
Reload configuration file |
/vt md <name> |
versiontinmoli.admin |
Modify version name |
Permission Notes: Velocity/BungeeCord require versiontinmoli.admin permission, Bukkit defaults to OP
Configuration
Basic Configuration
# VersionTinmoli Configuration File
# Customize the version name displayed in the server list
# Language setting (en_US or zh_CN)
language: "en_US"
# Version name configuration
version_name: "Velocity 1.8.x-1.21.11"
Language Settings
The plugin supports multiple languages. You can set the language in the configuration file:
en_US - English
zh_CN - Simplified Chinese
After modifying the language field, use /vt reload to reload the configuration and switch languages. All command messages and prompts will be displayed in the corresponding language.
Language File Customization
Language files are automatically copied to the external directory on first run:
- Velocity:
plugins/versiontinmoli/lang/
- BungeeCord:
plugins/VersionTinmoli/lang/
- Bukkit:
plugins/VersionTinmoli/lang/
You can edit these files to customize messages. The plugin will load from the external directory first, then fall back to the built-in files.
Configuration Examples
Regular Server
# Velocity
version_name: "<gold>Minecraft</gold> <gray>1.8-1.21</gray>"
# BungeeCord/Bukkit
version_name: "&6Minecraft &71.8-1.21"
VIP Server
# Velocity
version_name: "<bold><gradient:gold:yellow>VIP Server</gradient></bold>"
# BungeeCord/Bukkit
version_name: "&l&6VIP Server"
Minigames Server
# Velocity
version_name: "<rainbow>MiniGames</rainbow> <white>| <green>Online</green></white>"
# BungeeCord/Bukkit
version_name: "&cM&6i&en&ai&9G&ba&dm&5e&cs &f| &aOnline"
PVP Server
# Velocity
version_name: "<bold><red>PVP</red></bold> <gray>| <yellow>Fighting</yellow></gray>"
# BungeeCord/Bukkit
version_name: "&l&cPVP &r&7| &eFighting"
FAQ
Migrating from TOML to YAML
If you're upgrading from an older version (before v1.0.2), you need to migrate your configuration from TOML format to YAML format.
Automatic Migration (Recommended):
- Backup your
config.toml file
- Delete the
config.toml file
- Restart the server or run
/vt reload
- The plugin will automatically create a new
config.yml file
- Edit
config.yml and set your custom version name
Manual Migration:
TOML format (old):
version_name = "My Server 1.20"
YAML format (new):
version_name: "My Server 1.20"
Main difference: Use colon : instead of equals sign =
Configuration Not Working
- Ensure the configuration file is in the correct location
- Check YAML syntax is correct
- Use
/vt reload to reload configuration
- If still not working, restart the server
Colors Not Displaying or Showing as Text
Problem: RGB color codes display as text like Red</> Green</>
Cause: Using incorrect closing tags </>
Solution:
# Wrong
version_name: "<#FF5555>Red</> <#55FF55>Green</>"
# Correct
version_name: "<#FF5555>Red <#55FF55>Green"
version_name: "<color:#FF5555>Red</color> <color:#55FF55>Green</color>"
Other Color Issues:
- Velocity: Use MiniMessage format
<gold>text</gold>
- BungeeCord/Bukkit: Use
& or § color codes
- RGB colors require Minecraft 1.16+ client
- Check server logs for errors
Platform-Specific Requirements
- Velocity: Requires Velocity 3.0+ and Java 21+
- BungeeCord: Requires BungeeCord 1.16+ and Java 17+
- Bukkit: Requires Minecraft 1.20.1+ and Java 17+
License
This project is licensed under the MIT License.
Support
For issues or suggestions, please submit them on GitHub Issues.
Documentation Version: 1.0.2
Maintainer: Tinmoli
评论 0
登录后参与评分
还没有评论,来抢沙发吧