
Modrinth · Minecraft mod
Shaolib
Shaolib is a high-performance library mod designed to optimize projectile entity handling in Minecraft
Quick answer
Which Shaolib release should I use?
Shaolib 0.1.0 targets 1.21.1 with NeoForge. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.
Where it goes
Is Shaolib required on the client, server, or both?
Installation on the client is optional. Installation on the dedicated server is optional.
The source marks this as usable on both the client and server.
What else does Shaolib 0.1.0 need?
0.1.0. Change the file and its required mods may change too.
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 Shaolib without breaking your instance.
Built for Shaolib 0.1.0. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 0.1.0. It targets 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.
- 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.
- 03
Put it on the correct side
Installation on the client is optional. Installation on the dedicated server is optional.
- 04
Pick the file you checked
Use the “Get this file” button beside 0.1.0. It opens that exact file at the source.
About this project
What does Shaolib add?
Shaolib Core
Shaolib Core is a NeoForge library mod that provides a high-performance chunk cache, fast world-query utilities, and a lightweight projectile framework for simulation-heavy mods.
High-performance Chunk Cache
Shaolib Core maintains compact, query-friendly snapshots of chunk data so other mods can sample blocks, heights, and cached world state without repeatedly walking live world data. Its cache APIs expose freshness and source information, allowing callers to distinguish live-world reads, memory-cache hits, stale cached results, and unavailable data.
This makes it useful for raycasts, collision checks, terrain-aware simulation, guidance logic, server-side prediction, and other systems that need many world queries per tick.
Projectile Framework
Shaolib Core also includes a flexible projectile runtime for advanced projectile systems. Instead of forcing every projectile to be modeled as a normal Minecraft entity first, it provides lightweight projectile instances with typed state, motion models, synchronized data, server-side contexts, sweep/collision helpers, and chunk-loading policy hooks.
Addon mods can build their own projectile behavior on top of this shared runtime: spawning, ticking, sweeping through the world, syncing state to clients, and resolving block or body hits can all use the same infrastructure while each projectile keeps its own gameplay logic.
For Mod Developers
Shaolib Core is primarily a dependency/library mod. On its own, it focuses on infrastructure rather than large amounts of player-facing content. Other mods can use it to implement high-speed munitions, custom raycasts, physics-body interactions, cache-backed terrain queries, and other performance-sensitive simulation features.
Project description from Modrinth.
Pick your setup
Shaolib by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.20.1
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Shaolib versions and loaders
0.1.0
shaolib-0.1.0.jar
24 Aug 2026
1.4.7
Shao's Projectile Lib Forge-1.20.1-1.4.7-all.jar
13 Jan 2026
Looking for an older file? The official Modrinth project page is in Resources.