Version Numbering Converter
by CroaBeast
Version Numbering Converter is a Java 8 library that converts Minecraft version names between the classic and year-based numbering families.
What it does
The library works with Minecraft versions from both numbering families: the classic scheme that runs through the 1.x releases, and the newer year-based scheme. A developer can read a version in one scheme and get its equivalent in the other, which helps when older version names have to be mapped to newer ones or the reverse.
The common API is kept separate from platform code, so a Java project can use it without a Bukkit classpath. Platform-specific runtime helpers live in their own modules and are picked through a bootstrap provider. The bootstrap class detects the runtime, and the library still exposes convenience methods that use the detected provider. Where no provider is supported, a nullable accessor returns nothing. On Velocity, the provider exposes one global backend Minecraft version, and version methods there need a system property set before use. The final consumer jar is generated from the bootstrap module.
Files are published for Fabric, Forge, NeoForge, Quilt and LiteLoader, and for the Paper, Spigot, Bukkit, Purpur, Folia, Sponge, Velocity, BungeeCord and Waterfall server platforms. Builds cover rd-132211 – 26.2 across 172 release versions, and snapshot builds are published as well. The library is used on the client or server side, and neither side is required to run it. It is released under the GNU General Public License v3.0 or later and is open source.
Key features
Two numbering families
Both the classic 1.x scheme and the year-based scheme are handled, including the newest releases.
Java 8 common API
The shared API targets Java 8 and is kept free of Bukkit classes so it can sit on any classpath.
Runtime provider detection
A bootstrap provider detects the platform at runtime and selects the matching helper module.
Compatibility
Latest build for each game version and loader.
26.x4 of 4 versions with builds
1.21.x12 of 12 versions with builds
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
1.16.x6 of 6 versions with builds
1.15.x3 of 3 versions with builds
1.14.x5 of 5 versions with builds
1.13.x1 of 1 version with builds
This mod also publishes snapshot builds. Snapshots are not shown in the matrix.
54 older game versions (1.0 – 1.13.1) not shown. All files on Modrinth
Use cases
Who it’s for: Developers who write Java tools or plugins that handle Minecraft version names across both numbering families, and server owners who run plugins built on the library.
Questions
Which numbering families does the library handle?
Does a Velocity setup need extra configuration?
Does the library need a Bukkit classpath?
In the catalog
Version Numbering Converter is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 13,894 mods support Minecraft 26.2.
Similar mods
What the author says
The project is split so the common API can be used from any Java project without Bukkit on the classpath. Platform-specific runtime helpers live in separate modules and are selected through the bootstrap provider. Platform modules contain package-private provider implementations. Consumers should depend on bootstrap…
Official listing
- Modrinth page
- modrinth.com/mod/vnc
- Owner
- CroaBeast
- Published
- 2025-12-08
- Updated on Modrinth
- 2026-08-04
- Facts verified
- 2026-10-15
