VersionTinmoli

插件

· 作者 Tinmoli

一个轻量级的 Minecraft 代理/服务器插件,用于自定义服务器列表中显示的版本名称,支持丰富的颜色和格式设置。

0 本站下载 0 关注 更新于 8 个月前

最新 1.0.2 · 26.3 · Waterfall

一键开服(送7天)

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+ 完全支持

快速开始

安装

  1. 从 Releases 下载对应平台的 JAR 文件
  2. 将 JAR 文件放入服务器的 plugins/ 目录
  3. 重启服务器
  4. 编辑配置文件(自动生成)
  5. 使用 /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"

语言设置

插件支持多种语言。您可以在配置文件中设置语言:

  • en_US - 英文
  • zh_CN - 简体中文

修改 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 格式。

自动迁移(推荐):

  1. 备份你的 config.toml 文件
  2. 删除 config.toml 文件
  3. 重启服务器或运行 /vt reload
  4. 插件将自动创建一个新的 config.yml 文件
  5. 编辑 config.yml 并设置自定义版本名称

手动迁移:

TOML 格式(旧版):

version_name = "My Server 1.20"

YAML 格式(新版):

version_name: "My Server 1.20"

主要区别:使用冒号 : 代替等号 =

配置未生效

  1. 确保配置文件位于正确的位置
  2. 检查 YAML 语法是否正确
  3. 使用 /vt reload 重新加载配置
  4. 如果仍然无效,请重启服务器

颜色未显示或显示为文本

问题: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>"

其他颜色相关问题:

  1. Velocity:使用 MiniMessage 格式 <gold>text</gold>
  2. BungeeCord/Bukkit:使用 & 或 § 颜色代码
  3. RGB 颜色需要 Minecraft 1.16+ 客户端支持
  4. 检查服务器日志以查找错误

平台特定要求

  1. Velocity:需要 Velocity 3.0+ 和 Java 21+
  2. BungeeCord:需要 BungeeCord 1.16+ 和 Java 17+
  3. Bukkit:需要 Minecraft 1.20.1+ 和 Java 17+

许可证

本项目基于 MIT 许可证开源。

支持

如有问题或建议,请在 GitHub Issues 上提交。


文档版本:1.0.2
维护者:Tinmoli

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源