Overview

ModsVersionRange is a small Hytale mod that upgrades version compatibility checks from exact server build strings to real semantic version ranges.
It is designed to stop “false incompatibility” warnings when a mod is still compatible across multiple builds (e.g. 2026.*).

✅ Requires MixinTale to patch the server’s version check safely and reliably.

Installation

1) Install MixinTale (required)

Download MixinTale (the EarlyPlugin / Bootstrap JAR).
Place it in:
1. Singleplayer: [GameFolder]/UserData/EarlyPlugins
2. Dedicated server: [ServerFolder]/EarlyPlugins
Server only: start the server with:
--accept-early-plugins

2) Install ModsVersionRange

Place the ModsVersionRange JAR in:
1. Singleplayer: [GameFolder]/UserData/Mods
2. Dedicated server: [ServerFolder]/Mods
Start the game/server.

✔️ No configuration required.

What syntax is supported?

ModsVersionRange relies on Hytale’s SemverRange parsing rules and supports:

Wildcards / X-Ranges

* (or blank) → matches any version
2026.* → matches >= 2026.0.0 and < 2027.0.0
2026.02.* → matches >= 2026.2.0 and < 2026.3.0

Note: X-Ranges are intended for major/minor wildcards (patch wildcards are valid only in the *.x/* form). If the pattern is not a valid X-Range, it will be rejected.

Comparator ranges

>=2026.2.0
>2026.2.0
<=2026.3.0
<2026.3.0
(and any comparator format supported by the server’s semver comparator)

AND ranges (space-separated)

>=2026.2.0 <2027.0.0

OR ranges (||)

2026.* || 2027.*

Hyphen ranges (inclusive)

2026.2.0 - 2026.3.5
(interpreted as >=2026.2.0 and <=2026.3.5)

Tilde ranges (~)

~2026.2.0
- if minor > 0: >=2026.2.0 and <2026.3.0
- otherwise: >=2026.0.0 and <2027.0.0

Caret ranges (^)

^2026.2.0 → >=2026.2.0 and <2027.0.0
Special handling for 0.x.y ranges (caret behaves more strictly when major is 0)

Notes

This mod does not change gameplay.
It only affects the mod/server version compatibility check.
Ideal for mods that want to target “a family of builds” without re-releasing for every build hash.

Mods Version Range Fix