Back to mods
Recoleta project artwork

CurseForge · Minecraft mod

Recoleta

A pure memory reduction mod for Minecraft

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

Quick answer

Which Recoleta release matches Fabric?

Updated 3 months ago
Best match for your filters Recoleta-fabric-1.21.1-0.2.2.jar
Game version 1.21.1
Loader Fabric, Quilt

Recoleta-fabric-1.21.1-0.2.2.jar targets 1.21.1 with Fabric, Quilt. 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 Recoleta 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 Fabric, Quilt
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 Recoleta-fabric-1.21.1-0.2.2.jar need?

Recoleta-fabric-1.21.1-0.2.2.jar on Fabric. 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 Recoleta without breaking your instance.

Built for Recoleta-fabric-1.21.1-0.2.2.jar on Fabric. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use Recoleta-fabric-1.21.1-0.2.2.jar. It targets 1.21.1 with Fabric, Quilt; 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 Recoleta-fabric-1.21.1-0.2.2.jar. It opens that exact file at the source.

About this project

What does Recoleta add?

Recoleta

The mod ports the spirit of two JDK 25 JEPs into the running game without requiring a JDK 25 runtime:

JEP Native scope (JDK 25) Recoleta port Domain
519 - Compact Object Headers Shrinks every object header from 12 B to 8 B Encodes dominant Minecraft value data into compact primitive forms so typical per-instance footprint drops from 24-56 B to 8 B Header/value packing
521 - Generational Shenandoah Adds young/old generations to a low-pause concurrent GC Uses generational reuse pools, bounded per-tick reference draining, and heap-pressure callbacks to mimic low-pause locality inside the game loop Pooling and pressure-aware cleanup

Additional reduction paths

  • Bounded LRU with soft-reference values for cache-like workloads
  • Weak interning for repetitive strings to reduce duplicate heap copies
  • Thread-local reusable position/vector carriers for hot loops
  • Idle-time slack trimming for long-lived expandable buffers
  • Heap-pressure notifications wired to proactive eviction/reclaim callbacks
  • Per-render-style particle cap (below vanilla 16384) to reduce client memory spikes
  • Path collision caching now uses compact packed keys to reduce heavy key churn.
  • Path stepping reuses mutable vector slots to avoid transient vector allocations.
  • Spawn-distance checks use scalar math to avoid temporary geometry objects.
  • Hot spawn-position loops reuse mutable coordinate carriers instead of repeatedly allocating.
  • Small-NBT paths right-size backing maps for common tiny payloads.
  • NBT-load paths repack freshly-decoded compounds so loaded tags carry no slack.
  • Empty list-tag containers start with a small backing array sized for typical few-entry payloads (enchantments, lore, modifier lists).
  • Capability comparison short-circuits per-entry to avoid building two full tag snapshots on every item-stack equality check.
  • Chunk streaming packets start their block-entity list at a small capacity instead of the default 10-slot one.

Each reduction reports its hit count via the /recoleta memory status command so operators can verify a tuning is actually active.

Configuration

All toggles live in config/recoleta-memory.toml (Forge config). Edit at runtime; values are re-read on every access.

tips

Some changes are destructive, and I cannot guarantee that they will work well with all mods.

For the current release, any issues related to sable,Sinytra Connector,lithium and its derivatives will not be accepted, and compatibility with ModernFix and FerriteCore should be maintained.

Project description from CurseForge.

Pick your setup

Recoleta by Minecraft version and loader

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

7 available setups

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

Recent files

Recoleta versions and loaders

2 of 10 releases match
Clear filters

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