Version Numbering Converter

VNC (Version Numbering Converter)

Version Numbering Converter (VNC) — это библиотека для Java 8 для работы с версиями Minecraft из обоих семейств нумерации:

• Классические версии в стиле Java, такие как 1.20.6 и 1.21.11
• Версии-дропы по годам, такие как 24.1, 25.4 и 26.1.1

Проект разделён так, чтобы общий API можно было использовать из любого Java-проекта без Bukkit в classpath. Платформенные runtime-хелперы живут в отдельных модулях и выбираются через bootstrap-провайдер.

Модули

Основной 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");

Runtime API платформ

Используй bootstrap, если хочешь, чтобы VNC сам определил runtime-провайдера:

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` по-прежнему предоставляет удобные методы для обнаруженного провайдера:

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

Когда в среде выполнения может не быть поддерживаемого провайдера, используйте nullable-аксессор:

VNCProvider provider = VNC.getProviderOrNull();
if (provider != null && provider.isAtLeast("1.20.5")) {
    // use modern behavior
}

Платформенные модули содержат package-private реализации провайдеров. Потребителям следует зависеть от bootstrap для определения среды выполнения, а не вызывать классы конкретных загрузчиков напрямую.

Velocity не предоставляет одну глобальную версию бэкенд-Minecraft. Его провайдер всё ещё определяется через Velocity API, но для методов версии требуется системное свойство minecraft.version.

Требования

• Java 8 байткод для каждого модуля
• Gradle 9.4.1 wrapper для локальных сборок
• Опциональные платформенные 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.