Back to mods
Celeris project artwork

CurseForge · Minecraft mod

Celeris

A performance library for NeoForge mods: off-heap memory, lock-free concurrency, SIMD math, compression and graph/network utilities, each with a pure-Java fallback so it runs on any JVM without launch flags.

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

Quick answer

Which Celeris release matches 26.1 NeoForge?

Updated 17 days ago
Best match for your filters 0.2.2 26.1–26.3
Game version 26.1, 26.1.1, 26.1.2
Loader NeoForge

Celeris 0.2.2 26.1–26.3 targets 26.1, 26.1.1, 26.1.2 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Celeris required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Celeris 0.2.2 26.1–26.3 need?

0.2.2 26.1–26.3 on 26.1 NeoForge. Every mod below is checked against that same setup.

No extra mods 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 mods.

Before you install it

Add Celeris without breaking your instance.

Built for Celeris 0.2.2 26.1–26.3 on 26.1 NeoForge. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 0.2.2 26.1–26.3. It targets 26.1, 26.1.1, 26.1.2 with NeoForge; another release may have different loader, side or dependency requirements.

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

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 0.2.2 26.1–26.3. It opens that exact file at the source.

About this project

What does Celeris add?

Celeris

Minecraft 1.21 to 26.3 NeoForge and Fabric, client and server Library

Download on Modrinth Download on GitHub

Celeris is a performance library for NeoForge and Fabric mods. It gives other mods fast building blocks so they can do heavy work without slowing the game down. On its own it adds nothing you can see in game: you install it because a mod you want needs it.

⚡ What it gives those mods

  • 🧵 Work off the main thread. Heavy jobs run on worker threads and their results come back to the game thread through lock-free queues, without stalling a tick or a frame.
  • 🧠 Less garbage-collector pressure. Large buffers live in off-heap memory, so big data does not cause GC pauses.
  • 📐 Vector math. Bulk number crunching uses the CPU's SIMD units when Java allows it, and plain loops when it does not.
  • 🗜️ Compression. Native zstd for mods' own data (no JVM flags needed) and deflate for network packets.
  • 📦 Items in pipes. Networks that carry items from block to block, with no entity per item, that keep the items when pipes are placed, broken or saved.
  • 🔌 Signal networks. Redstone-style graphs that only recompute what a change touches.
  • 🏃 Batch physics. Thousands of entities and dropped items moved in one pass, following vanilla's movement rules.

🛡️ Safe everywhere

  • ✅ Every fast path has a pure-Java fallback. If something can't run the fast way on your machine, Celeris uses the slower one instead of crashing.
  • ✅ Optional on both sides of a connection: players without Celeris can join a server that has it, and you can join any server with it. A Fabric client can also join a NeoForge server with Celeris.
  • ✅ Network payloads are size-capped and their headers are checked before anything uses them.
  • ✅ The native code is checked with AddressSanitizer and UBSan in CI, and its results match the Java version bit for bit.

🏁 How fast

Each building block, measured against what a mod would otherwise use (JMH, Java 21, a 4-core machine; method and full tables in the benchmarks page):

  • 🗜️ 12.8× faster compression than Java's built-in deflate (what Minecraft uses) for nearly the same size, and 3.1× faster decompression. As fast as zstd-jni in a jar a quarter of its size.
  • 🏃 32,768 dropped items moved in 0.88 ms per tick on 3 threads with the native kernel, 5.3× faster than the same rules in Java on one thread and under 2 % of a tick.
  • 🧲 Item piles no longer stall: finding the touching items in a pile of 16,384 takes 0.24 ms instead of up to a second.
  • 🧵 4.9× faster hand-off from one worker thread to the game thread than JCTools, and still ahead with two or three workers.

Compression benchmark Physics benchmark Broadphase benchmark Queue benchmark

📦 Requirements

  • 🟩 Minecraft: 1.21 to 26.3. Download the file made for your version.
  • 🔶 Loader: NeoForge or Fabric (with Fabric API), on the client and on the server.
  • ☕ Java: 21 for 1.21.x, 25 for 26.x.

⚙️ Settings

  • Network compression level (0 to 9, default 1): how hard Celeris compresses the packets it sends. 0 sends them uncompressed, 1 is the fastest, 9 gives the smallest packets. Only the sender's setting matters.
    • NeoForge: Mods → Celeris → Config, or compressionLevel in config/celeris-common.toml.
    • Fabric: with Mod Menu, Mods → Celeris → Config; or compressionLevel in config/celeris.properties (restart after editing it by hand).

Optional JVM flags are on the wiki.

🔧 Native code

Celeris ships two native libraries, built from public source by GitHub Actions on each platform's own runner, from the same tagged commit as every file published here:

  • zstd 1.5.7 (Meta's Zstandard, BSD-3-Clause), compiled from the official release tarball and checked against its SHA-256, plus a few small functions of Celeris's own that let Java 21 call it without extra flags: native/zstd.
  • The physics kernel, Celeris's own C++ code: native/.

GitHub releases also carry a Java-only file with no native code at all. See Native libraries.

📚 Learn more

The Celeris wiki has the settings, JVM flags, the guide for mod authors, performance numbers and how to build the project.

Guide and source on GitHub Report a bug Changelog

License

Content License
Source code AGPL-3.0, see LICENSE-AGPL
Artwork, branding and documentation CC BY-NC-SA 4.0, see LICENSE-CC
Zstandard (zstd) (bundled) BSD-3-Clause, see NOTICE

Source code: you may study, modify and redistribute it under the AGPL; if you run a modified version as a network service, its source must be available to that service's users.

Artwork: credit Bichal, no commercial use without permission, and share derivatives under the same license.

See LICENSE for the full summary.


Code: AGPL-3.0 · Art: CC BY-NC-SA 4.0 · Made by Bichal

Project description from CurseForge.

Pick your setup

Celeris by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

17 available setups

Showing the newest 12 of 17 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Celeris versions and loaders

4 of 16 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.