Mods Version Range Fix

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)

1. Download MixinTale (the EarlyPlugin / Bootstrap JAR).

2. Place it in:

   1. Singleplayer: [GameFolder]/UserData/EarlyPlugins

   2. Dedicated server: [ServerFolder]/EarlyPlugins

3. Server only: start the server with:
   --accept-early-plugins

2) Install ModsVersionRange

1. Place the ModsVersionRange JAR in:

   1. Singleplayer: [GameFolder]/UserData/Mods

   2. Dedicated server: [ServerFolder]/Mods

2. 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.