Caused by: java.lang.IllegalArgumentException: 26.1.1.build.29-alpha is not in valid version format. e.g. 1.8.8-R0.1

[mathuin]

Type of bug

Compatibility issue

/ess dump all output

I haven't been able to try the command

Error log (if applicable)

No response

Bug description

When setting up a new Paper server using the new Minecraft versioning scheme -- 26.1.1 instead of 1.21.11 -- the EssentialsX plugin crashed on boot. Here are the logs:

[04:46:12 INFO]: Done preparing level "world" (11.098s)
[04:46:12 INFO]: [Essentials] Enabling Essentials v2.21.2
[04:46:12 WARN]: [Essentials] Beginning Adventure locale file conversion.
[04:46:12 ERROR]: [Essentials] java.lang.ExceptionInInitializerError
java.lang.ExceptionInInitializerError
	at EssentialsX-2.21.2.jar//com.earth2me.essentials.Essentials.onEnable(Essentials.java:223) ~[?:?]
	at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:279) ~[paper-api-26.1.1.build.29-alpha.jar:?]
	at io.papermc.paper.plugin.manager.PaperPluginInstanceManager.enablePlugin(PaperPluginInstanceManager.java:207) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at io.papermc.paper.plugin.manager.PaperPluginManagerImpl.enablePlugin(PaperPluginManagerImpl.java:109) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:520) ~[paper-api-26.1.1.build.29-alpha.jar:?]
	at org.bukkit.craftbukkit.CraftServer.enablePlugin(CraftServer.java:637) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at org.bukkit.craftbukkit.CraftServer.enablePlugins(CraftServer.java:594) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at net.minecraft.server.MinecraftServer.initPostWorld(MinecraftServer.java:680) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at net.minecraft.server.dedicated.DedicatedServer.initServer(DedicatedServer.java:386) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1290) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at net.minecraft.server.MinecraftServer.lambda$spin$0(MinecraftServer.java:304) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at java.base/java.lang.Thread.run(Unknown Source) ~[?:?]
Caused by: java.lang.IllegalArgumentException: 26.1.1.build.29-alpha is not in valid version format. e.g. 1.8.8-R0.1
	at EssentialsX-2.21.2.jar//com.earth2me.essentials.utils.VersionUtil$BukkitVersion.fromString(VersionUtil.java:196) ~[?:?]
	at EssentialsX-2.21.2.jar//com.earth2me.essentials.utils.VersionUtil.getServerBukkitVersion(VersionUtil.java:105) ~[?:?]
	at EssentialsX-2.21.2.jar//com.earth2me.essentials.utils.VersionUtil.<clinit>(VersionUtil.java:49) ~[?:?]
	... 12 more
[04:46:12 ERROR]: Error occurred while enabling Essentials v2.21.2 (Is it up to date?)
java.lang.NullPointerException: Cannot invoke "net.ess3.provider.ServerStateProvider.isStopping()" because the return value of "com.earth2me.essentials.Essentials.provider(java.lang.Class)" is null
	at EssentialsX-2.21.2.jar//com.earth2me.essentials.Essentials.onDisable(Essentials.java:524) ~[?:?]
	at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:285) ~[paper-api-26.1.1.build.29-alpha.jar:?]
	at EssentialsX-2.21.2.jar//com.earth2me.essentials.Essentials.handleCrash(Essentials.java:1071) ~[?:?]
	at EssentialsX-2.21.2.jar//com.earth2me.essentials.Essentials.onEnable(Essentials.java:447) ~[?:?]
	at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:279) ~[paper-api-26.1.1.build.29-alpha.jar:?]
	at io.papermc.paper.plugin.manager.PaperPluginInstanceManager.enablePlugin(PaperPluginInstanceManager.java:207) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at io.papermc.paper.plugin.manager.PaperPluginManagerImpl.enablePlugin(PaperPluginManagerImpl.java:109) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:520) ~[paper-api-26.1.1.build.29-alpha.jar:?]
	at org.bukkit.craftbukkit.CraftServer.enablePlugin(CraftServer.java:637) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at org.bukkit.craftbukkit.CraftServer.enablePlugins(CraftServer.java:594) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at net.minecraft.server.MinecraftServer.initPostWorld(MinecraftServer.java:680) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at net.minecraft.server.dedicated.DedicatedServer.initServer(DedicatedServer.java:386) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1290) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at net.minecraft.server.MinecraftServer.lambda$spin$0(MinecraftServer.java:304) ~[paper-26.1.1.jar:26.1.1-29-77c0866]
	at java.base/java.lang.Thread.run(Unknown Source) ~[?:?]
[04:46:12 INFO]: [EssentialsSpawn] Enabling EssentialsSpawn v2.21.2

Steps to reproduce

Set up a new Paper server including the most recent EssentialsX plugin (2.12.2, released Aug 2025) in the configuration.

Expected behaviour

I expected the plugin (and EssentialsX Spawn) to load in the new world.

Actual behaviour

What actually happened was EssentialsX not handling the new versioning scheme very well.

Additional Information

No response

[JasonHorkles]

You should be using 2.22.0 dev builds. It's already been fixed