AcornLib
ModAn API with features to make modding easier, including new Components, Particles, Weapon Skins, and Supporter Perks.
Type
Mod
Modrinth Downloads
5,550
Modrinth ID
latUslMj
Last Updated
May 15, 2026
Description
THANKS FOR 5,200 DOWNLOADS!!!!
Features
Modding Utilities
- Kill effect items (normal and no die [will run the effect, but will keep them alive, as if they used a totem])
- Events
- Can consume event (disallows entities to eat if false)
- Can entity heal event (disallows entities to heal if false)
- Custom riptide event (returns an optional identifier [will not render if empty])
- Render screen overlay event (renders an overlay over the player's screen)
- Custom item settings class (allows easy application of components)
- Advanced burning item (applies fire before damage, meaning entities will drop cooked food when one-shot)
- Base item with skins
- Shield-breaker item (returns the number of seconds to disable the shield, as a float)
- Utility classes
- ItemUtils
- MiscUtils
- ParticleUtils
- PortingUtils
- VelocityUtils
- ModMenu compat helper
- Ability to change mod name color in ModMenu
- Ability to add (up to) two icons for your mod
Extra Item Components
- Two-handed component (Pretty Self-Explanatory)
- "Follows camera" holding component (Makes the item be pointed at the holder's look direction, like a loaded crossbow)
- Show hand component (Shows the hand when holding an item)
- Undroppable component
- Item skin component (string)
- Custom hit particle component (example below)
- Custom hit sound component
- Sweep particle component (example below)
- Secondary model component (displays a custom item with identical components and display context to the parent stack)
- Tertiary model component (same as secondary model, example below)
More Commands
- Velocity command (exact & directional)
- AcornLib command (dev env only, checks if player is a supporter)
Supporter System
- Ability to make mods (AcoYT) supporter only
- Custom perks for supporters and friends in other mods using this library
Oh yeah, and to make this even more like a Ratatouille ripoff, have a (few) custom plushies of me (and my friends), on the house :]
(THIS IS A JOKE, I TRIED TO DIFFERENTIATE FROM RATATOULIE, RAT PLEASE DON'T SUE ME)

Examples
Custom Hit Particle Component Give Command
give @s acornlib:gnarp_plush[acornlib:hit_particle={particle:"acornlib:green_sweep"}]Notice: You have to put a valid identifier in the sweep particle; otherwise, it sends an invalid packet, and kicks you from the game, might even crash your server, haven't checked
Custom Hit Sound Component Give Command
give @s acornlib:gnarp_plush[acornlib:hit_sound={soundEvent:"acornlib:block.gnarp_plush.honk"}]Secondary/Tertiary Model Component
give @s acornlib:gnarp_plush[acornlib:secondary_model="carrot"]Example on how to implement
Put this in your repositories
repositories { // Modrinth exclusiveContent { forRepository { maven { name = "Modrinth" url = "https://api.modrinth.com/maven" } } filter { includeGroup "maven.modrinth" } } // Mod Menu maven { name = "Terraformers" url = "https://maven.terraformersmc.com/" } // MixinSquared maven { url "https://maven.bawnorton.com/releases" } // CCA maven { name = "Ladysnake Mods" url = 'https://maven.ladysnake.org/releases' } }Put this in your dependencies
dependencies { // AcornLib modImplementation "maven.modrinth:acornlib:${project.acornlib_version}" // Config modApi ("com.terraformersmc:modmenu:${project.modmenu_version}") modImplementation ("maven.modrinth:midnightlib:${project.midnightlib_version}") /// ONLY IF 1.21.1 // Trinkets modCompileOnly "dev.emi:trinkets:${project.trinkets_version}" /// ONLY IF 1.21.1 OR 1.21.11+ // MixinSquared include(implementation(annotationProcessor("com.github.bawnorton.mixinsquared:mixinsquared-fabric:${project.mixinsquared_version}"))) // CCA modImplementation include("org.ladysnake.cardinal-components-api:cardinal-components-base:${project.cca_version}") modImplementation include("org.ladysnake.cardinal-components-api:cardinal-components-entity:${project.cca_version}") }Put this inside your gradle.properties
acornlib_version=VERSION modmenu_version=ACCORDING_MODMENU_VERSION midnightlib_version=ACCORDING_MIDNIGHTLIB_VERSION # ONLY IF 1.21.1 trinkets_version=ACCORDING_TRINKETS_VERSION # ONLY IF 1.21.1 OR 1.21.11+ mixinsquared_version=0.3.3 cca_version=ACCORDING_CCA_VERSIONYou can find AcornLib's latest version on its Modrinth Page and the corresponding versions of ModMenu and Midnightlib in the gradle.properties
Credits
The Acorn Texture is made by ShinyEmerald, in a resource pack listed here. Apples2Acorns is listed under the license CC-BY-SA-4.0
Compatibility
Mod Loaders
Game Versions
Screenshots
Similar Mods
Let's Ride Together (Two players on one horse)
Riding together is a simple mod that permits to ride a horse with a friend
VS2/CBC Armor Blocks
Elegant armor blocks designed for use with Create: Big Cannons & Valkyrien Skies.
Astikor Carts TFC Florae
An addon to the TFC Astikor Carts fork of Astikor Carts by Issork and Pau101, that adds carts for each TFC Florae wood t...
Baked Delight
Bakled Delight is an addon for Farmer's Delight based around adding culinary content with an backing dish !
ReplayMod Forge Fixed
This is an unofficial / forked repository of original ReplayMod.
Screenshot Compression
📸 Automatically compress screenshots taken in-game to lower file size with various config options.


