Modrinth · Fabric, Forge, NeoForge

EfficientHashing on your Minecraft server

EfficientHashing runs on Minecraft servers with Fabric or Forge or NeoForge. Order your server, set the loader in the panel and install the mod with one click in the mod browser.

better hashing algorithm for Vec3i & BlockPos

Downloads
289.1K
Author
ZZZank
Loader
Fabric, Forge, NeoForge
Minecraft
1.18 – 26.1.2
Updated
–

Setup

Install EfficientHashing on your server

The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 02

    Set the loader

    In the panel, set the server software to Fabric or Forge or NeoForge and choose the matching Minecraft version, for example 26.1.2.

  3. 03

    Install the mod

    Search the mod browser for “EfficientHashing” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.

  4. 04

    Connect

    Every player installs the same EfficientHashing release locally and connects using the server address from the panel.

On the server
Required
On the client
Required
Loader
Fabric, Forge, NeoForge
Minecraft
26.1.2, 1.21.1, 1.21 +10 more
License
GNU Lesser General Public License v3.0 only

The panel

Install mods, find errors.

Real screenshots from the Mado panel. Both come with every Minecraft server.

Mod browser

Modrinth and CurseForge, right in the panel.

The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

AI crash analysis

When a mod crashes, the analyzer reads the log.

Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

EfficientHashing · Modrinth
Original description by the project author

EfficientHashing

EfficientHashing replaced hashing algorithm of Vec3i (and its subclasses like BlockPos) with one that's much much
more collision resistant, providing performance improvement in basically wherever its hashcode is used.

Collision Resistant

We can prove this by doing a simple test. Test is perform by hashing every combination of BlockPos between
new BlockPos(-100, -20, -100) and new BlockPos(100, 50, 100) (inclusive), with the total object count reaching
2,800,000+.

Vanilla algorithm produced 194,571 unique hashcode in total. This means that at least 93% of all BlockPos hashcode are
colliding with each other.

And PhiMix, the algorithm used by EfficientHashing, produced 2868471 unique hashcode in total. This means that every
unique BlockPos object gets its unique hashcode, and NONE of all BlockPos hashcode are colliding.

Unique Hashcode Collision Collision Rate
Vanilla 194,571 2,673,900 93.2%
EfficientHashing 2,868,471 0 0%

If you're curious about the actual test code, see: here

Performant

Benchmark time:

Benchmark                     Mode  Cnt   Score   Error  Units
VecHashingBenchmark.mixin    thrpt    5  47.012 ± 1.029  ops/s
VecHashingBenchmark.vanilla  thrpt    5  49.326 ± 1.507  ops/s

PhiMix is about 95.3% the performance of original hashing algorithm. Yes, it's slower, but this performance gap is
relatively tiny compared to other hashing solution, and can be easily outweighed by the significant improvement in hash
collision resistance.

If you're curious about the actual benchmark code, see: here

Vanilla compatible

In vanilla hashing algorithm, if you hash the "default" instance of BlockPos/Vec3i, aka new BlockPos(0, 0, 0), the
produced hashcode will be 0, which happens to be the "default" instance of integer. This special behavior is also
present in PhiMix, providing the best possible vanilla compatibility.

FAQ

EfficientHashing questions

Question not listed? Ask our team.

EfficientHashing server crashes on startup – what to do?

Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.

Which loader does EfficientHashing run on?

According to Modrinth, EfficientHashing supports Fabric, Forge, NeoForge for Minecraft 26.1.2, 1.21.1, 1.21. Forge and Fabric files are not interchangeable: pick one loader for the server and clients.

How much RAM does a server with EfficientHashing need?

As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.

Ready for your server with EfficientHashing?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server