premium banner

Mods Version Range Fix

Enables semver ranges (wildcards, comparators, hyphen ranges, ^/~, and ||) for Hytale mod ServerVersion checks

Description

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.