Page title: Quark Zeta Fixin: Stop Zeta Event Crashes Fast

Meta description: Quark Zeta Fixin patches Zeta's event bus concurrency crash for Minecraft, stopping ArrayIndexOutOfBoundsException errors with heavy add-on loadouts.

Download quarkzetafixin for Minecraft 1.20.1

Original name: quarkzetafixin

Minecraft: 1.20.1

Loaders: Forge

FileVersionLoaderSize
quarkzetafixin-1.0.jar1.20.1Forge104 КБDownload

Quark Zeta Fixin

If you run Quark alongside a pile of add-ons, you have probably met the crash that ends a perfectly good session with a wall of red text. Quark Zeta Fixin is a tiny utility mod that targets one specific concurrency bug in Zeta, the shared library that powers Quark's event system. When several add-ons subscribe to Zeta's event bus at the same time, the underlying map can rehash while another thread is still writing to it, and the game falls over. This mod swaps the unsafe map for a thread-safe implementation so the crash simply stops happening.

What the Crash Actually Looks Like

Before you download Quark Zeta Fixin, confirm the error matches. The telltale line is an exception message reading java.lang.ArrayIndexOutOfBoundsException, usually with something like "Index 512 out of bounds for length 257" attached. Below it, the stack trace points at it.unimi.dsi.fastutil.objects.Object2ObjectOpenHashMap during a rehash, and further down you will see org.violetmoon.zetaimplforge.event.ForgeZetaEventBus.subscribeMethod.

Both parts matter. If your log shows the ArrayIndexOutOfBoundsException but not the ForgeZetaEventBus line, this fix will not help you, and you should look elsewhere. If it shows the event bus line without the array exception, same story. The mod is deliberately narrow, and that is a feature rather than a flaw.

Why More Add-Ons Means More Crashes

The failure is a race condition. Each add-on that hooks into Zeta's event system registers a listener, and those registrations can land on different threads. The non-thread-safe map used for storage does not expect concurrent writes, so when it resizes at the wrong moment, indices go out of range and the JVM throws. A light modpack might never trigger it. A heavy one with dozens of Quark add-ons will hit it eventually, often at startup when everything subscribes at once.

How Quark Zeta Fixin Solves It

The approach is refreshingly simple. Quark Zeta Fixin replaces the problematic map with a thread-safe version, so concurrent subscriptions no longer corrupt the structure. Crucially, the patch is written defensively: even if Zeta later changes how it stores listeners, or even ships its own fix, the game will not crash because of this mod. It is a safety net, not a fragile bytecode hack that breaks on the next library update.

That said, the author is upfront about one thing. Once Zeta officially resolves the concurrency issue upstream, you should remove Quark Zeta Fixin. Keeping it around does no harm, but there is no reason to carry a workaround for a bug that no longer exists. Check the Zeta changelog after major Quark updates and prune accordingly.

Supported Versions and Loaders

The mod is so small that a single jar covers both major targets. You can run Quark Zeta Fixin for Minecraft 1.20.1 on Forge, and the exact same file works on Minecraft 1.21.1 with NeoForge. There is no separate build to hunt down, no loader-specific download page, and no confusion about which file goes where. Drop it in your mods folder next to Quark and Zeta and you are done.

If you manage modpacks through the foxygame.net launcher, the add-on catalog lists Quark Zeta Fixin by name, so you can add it to a 1.20.1 Forge or 1.21.1 NeoForge instance without manually matching jar files to loaders.

How to Install

Installation follows the standard Forge or NeoForge routine. Here is the short version:

  • Confirm your crash log contains both the ArrayIndexOutOfBoundsException and the ForgeZetaEventBus.subscribeMethod line.
  • Download Quark Zeta Fixin for the correct Minecraft version from a trusted mod repository.
  • Place the jar in your instance's mods folder alongside Quark and Zeta.
  • Launch the game and reproduce whatever scenario used to crash, usually a large modpack startup.
  • Keep an eye on Zeta's release notes and remove the fix once the upstream bug is patched.

There are no config files to edit and no dependencies beyond Quark and Zeta already being present. If the game still crashes with the same stack trace after installing, double-check that the jar actually loaded and that you grabbed a build matching your Minecraft version.

Final Thoughts

Quark Zeta Fixin is the kind of mod you install, forget about, and only remember when you realize your heavily modded world has stopped throwing random event bus exceptions. It does one job, does it safely, and stays out of the way. If your logs match the signature described above, this is the cleanest path back to stable gameplay on 1.20.1 Forge or 1.21.1 NeoForge.