Version Numbering Converter

模组

· 作者 CroaBeast

你讨厌那种类似苹果的新版号系统吗?我也是!你喜欢它吗?无所谓!你在乎版本号的编号方式以及如何将旧版本转换为新版本,或者反过来吗?这个项目就是为你准备的!

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

最新 1.2.1 · 26.2 · Bukkit / BungeeCord

一键开服(送7天)
Spoiler

VNC (Version Numbering Converter)

版本编号转换器(VNC)是一个基于 Java 8 的库,用于处理跨越两种编号体系的 Minecraft 版本:

  • 经典 Java 风格版本,例如 1.20.6 和 1.21.11
  • 基于年份的版本号,例如 24.1、25.4 和 26.1.1

该项目进行了模块化拆分,以便在不依赖 Bukkit 类路径的情况下,从任何 Java 项目中使用公共 API。平台特定的运行时辅助工具位于单独的模块中,并通过引导程序提供程序进行选择。

模块

模块 构件 ID 用途
bootstrap me.croabeast.vnc:VNC 包含 VNC、core 以及提供程序实现的最终聚合 JAR 包。
core me.croabeast.vnc:core 通用解析器、提供程序契约、映射表、转换方案、协议查找以及通用运行时快照。
bukkit me.croabeast.vnc:bukkit 内部 Bukkit/Paper 提供程序及基于 ViaVersion 的玩家协议查找。
mod:fabric me.croabeast.vnc:fabric Fabric 加载器运行时版本桥接。
mod:quilt me.croabeast.vnc:quilt Quilt 加载器运行时版本桥接。
mod:forge me.croabeast.vnc:forge Forge 运行时版本桥接。
mod:neoforge me.croabeast.vnc:neoforge NeoForge 运行时版本桥接,编译为 Java 8 字节码。
mod:sponge me.croabeast.vnc:sponge Sponge 运行时版本桥接。
mod:liteloader me.croabeast.vnc:liteloader 旧版 LiteLoader 桥接。
proxy:bungee me.croabeast.vnc:bungee BungeeCord 代理版本桥接。
proxy:velocity me.croabeast.vnc:velocity Velocity 代理桥接,用于指定的后端/支持 Minecraft 版本。

核心 API

MinecraftVersion classic = MinecraftVersion.parse("1.21.11");
MinecraftVersion drop = MinecraftVersion.parse("26.1");

classic.getVersion();         // "1.21.11"
classic.getProtocol();        // 774
classic.supportsHex();        // true

drop.getVersion();            // "26.1"
drop.getProtocol();           // 775
String dropName = VersionScheme.MOJANG.toDrop("1.20.3");       // "23.2"
String classicName = VersionScheme.MOJANG.toClassic("25.2.2"); // "1.21.8"

boolean modernRegistry = Versioning.isAtLeast(MinecraftVersion.parse("1.20.6"), "1.20.5");
int comparison = VNC.compare(MinecraftVersion.parse("26.1"), "1.21.11");

平台运行时 API

当你希望 VNC 自动检测运行时提供程序时,请使用 bootstrap:

VNCProvider provider = VNC.getProvider();

String platform = provider.getPlatform();
String classic = provider.getClassicVersion();
String drop = provider.getDropVersion();
int protocol = provider.getProtocol();
boolean modernRegistry = provider.isAtLeast("1.20.5");

VNC 仍为已检测到的提供程序暴露便捷方法:

MinecraftVersion server = VNC.SERVER_MINECRAFT_VERSION;
double legacy = VNC.SERVER_VERSION;
boolean modernRegistry = VNC.isAtLeast("1.20.5");

当运行时可能没有受支持的提供程序时,使用可空访问器:

VNCProvider provider = VNC.getProviderOrNull();
if (provider != null && provider.isAtLeast("1.20.5")) {
    // 使用现代行为
}

平台模块包含包私有(package-private)的提供程序实现。使用者应依赖 bootstrap 进行运行时检测,而不是直接调用特定加载器的类。

Velocity 不会暴露一个全局的后端 Minecraft 版本。其提供程序仍然从 Velocity API 中检测,但版本方法需要一个 minecraft.version 系统属性。

要求

  • 所有模块均使用 Java 8 字节码
  • Gradle 9.4.1 包装器用于本地构建
  • 可选的平台 API 为 compileOnly;平台模块使用直接 API,并使用 Throwable/链接保护来守卫运行时检测
  • NeoForge 模块针对 NeoForge 21.1.230,采用 Maven 风格编译(source/target 1.8),并且仅在 Java 21+ 且存在 NeoForge 时在运行时解析

构建

./gradlew clean build

最终的消费者 JAR 包由 bootstrap 模块生成:

bootstrap/build/libs/VNC-${version}.jar

Maven 仓库发布仅由 .github/workflows/publish.yml 处理。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源