Back to mods
Sable: Optimized Entities project artwork

Modrinth · Minecraft mod

Sable: Optimized Entities

A small optimization patch mod for Sable, for faster entity tracking in Sublevels.

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

Quick answer

Which Sable: Optimized Entities release should I use?

Updated today
Latest stable file 0.1.1
Game version 1.21.1
Loader NeoForge

Sable: Optimized Entities 0.1.1 targets 1.21.1 with NeoForge. Do not install it on the client. It must be installed on the dedicated server. All 1 required mods have matching files.

Where it goes

Is Sable: Optimized Entities required on the client, server, or both?

Do not install it on the client. It must be installed on the dedicated server.

Client Not supported
Dedicated server Required
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

This file is marked server-only.

What else does Sable: Optimized Entities 0.1.1 need?

0.1.1. Change the file and its required mods may change too.

All 1 required mods have matching files

Install Sable first. We found matching files for this game-version and loader setup. 2 come through another mod in the chain.

1 listed on this file 2 pulled in by those mods
Sable Needed by Sable: Optimized Entities 0.1.1
required
Matching file found Matched file: 2.0.6+mc1.21.1
ImGuiMC Needed by Sable
pulled in
No matching file
Create Needed by Sable
pulled in
Matching file found Matched file: 6.0.10+mc1.21.1

2 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Sable: Optimized Entities without breaking your instance.

Built for Sable: Optimized Entities 0.1.1. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 0.1.1. It targets 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Sable first. We found matching files for this game-version and loader setup. 2 come through another mod in the chain.

  3. 03

    Put it on the correct side

    Do not install it on the client. It must be installed on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 0.1.1. It opens that exact file at the source.

About this project

What does Sable: Optimized Entities add?

Sable: Optimized Entities

A small optimization patch mod for Sable, for faster entity tracking in Sublevels. It can be installed in the server, meaning no requirement for players to update their modpacks and add the same mod as well.

NOTE: This mod does not guarantee full stability, even though it is mostly free of bugs in my testing.

How does it work?

Originally, Sable had a mixin code that lets players see entities within a Sublevel properly by sending the converted entity positions inside of specific Sublevels to the players.

But something is wrong, checking and grabbing Sublevels had extra slow calculations. And that mixin code always checks if the entity was inside of a Sublevel and grab said Sublevel if it does, by a BUNCH of times.

For example, assuming there are 20 players and 1000 entities loaded where all of them are near to each other and not inside of the sublevel. If we do the math where 20 Players x 1000 entities, Sable's sublevel checking code runs around 20,000 TIMES at every tick. Inside of a normal world, there are majority of the entities aren't at the sublevel, yet STILL finds their non-existent sublevel, and that is pretty bad for performance.

So I've made this ultra-specific mod that does faster tracking to lessen the chances to check for sublevels in entities while players can still see entities on sublevels properly like before.

Use this mod if you have:

  • Tons of active entities that aren't inside of any sublevel (especially with mobs and items)
  • Many (such as 20 or more) active players.
  • A lot of chunks (around 5000) are loaded
  • ChunkMap.move() specifically eating your TPS according to Spark
  • A low-end server

If none of these are applicable, then this mod will not be effective for you.

Benchmark

Tested from an Aeronautics server (STARSOUL) with ~25 real players, ~5100 chunks, and ~3500 active entities with an AMD EPYC 4564P CPU and 12GB allocated.

Without Mod

Without Mod Image

With Mod

With Mod Image

Meaning this mod does ~3.7x faster entity tracking than Sable does. Ain't that neat?

Project description from Modrinth.

Pick your setup

Sable: Optimized Entities by Minecraft version and loader

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

1 available setups

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

Recent files

Sable: Optimized Entities versions and loaders

2 of 2 releases match

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