CurseForge · Hytale mod

Mods Version Range Fix

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Mods Version Range Fix release should I use?

Updated 5 months ago

Latest stable file ModsVersionRange-1.0.0.jar

Game version Not listed

Mod system Built-in Hytale mod system

Mods Version Range Fix ModsVersionRange-1.0.0.jar targets Hytale. Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer. No required dependencies listed for this file.

Where it goes

Where should Mods Version Range Fix be installed in Hytale?

Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer.

Separate client mod Not supported

World host / dedicated server Required

Mod system for this release Built-in Hytale mod system

Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

Put Hytale mods on the world host or dedicated server. Singleplayer runs a local server too; Hytale does not use separate client mods.

Read the Hytale installation guide

What else does Mods Version Range Fix ModsVersionRange-1.0.0.jar need?

ModsVersionRange-1.0.0.jar. Change the file and its required mods may change too.

No required dependencies listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional project dependencies. Check the creator notes before changing an existing world.

Before you install it

Add Mods Version Range Fix without breaking your instance.

Built for Mods Version Range Fix ModsVersionRange-1.0.0.jar. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use ModsVersionRange-1.0.0.jar. It targets Hytale; another release may target a different game build or dependency set.
02
Bring the mods it needs

This file does not list any required mods. Do not add a library just because a different file uses it.
03
Enable it on the world host

Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer.
04
Pick the file you checked

Use the “Get this file” button beside ModsVersionRange-1.0.0.jar. It opens that exact file at the source.

About this project

What does Mods Version Range Fix add?

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.

Project description from CurseForge.

Recent files