Logo
MINECRAFTBIBLE
Items
Items

All game items

Blocks
Blocks

Building blocks

Mobs
Mobs

Creatures & monsters

Biomes
Biomes

World biomes

Structures
Structures

Generated structures

Recipes
Recipes

Crafting guides

Advancements
Advancements

Achievements

Loot Tables
Loot Tables

Drop rates

Tags
Tags

Item groupings

All Versions
View all data →
Capes
Cape ArchiveNEW

Browse rare Minecon capes, OptiFine capes, and custom capes from players worldwide

Browse

Player Database
Player DatabasePopular

Search any player

Skin Browser
Skin Browser

Browse & download skins

Cape Gallery
Cape GalleryNEW

Minecon & OptiFine capes

Seed Vault
Seed Vault

Curated seeds

Learn

Guides
GuidesNew

Tutorials & tips

Blog
Blog

News & updates

Community

Community Hub
Community HubHub

Posts, discussions & more

All Versions
View community →
Seed Analyzer
Seed Analyzer

World seed analysis

Loot Explorer
Loot Explorer

Drop rates

Crafting Calculator
Crafting Calculator

Material planning

Enchant Calculator
Enchant Calculator

Probability math

Redstone Lab
Redstone Lab

Signal timing

Trading Profit
Trading Profit

Villager ROI

All Versions
View all tools →
Mods
Mods

Browse all mods

Plugins
Plugins

Server plugins

Resource Packs
Resource Packs

Textures & sounds

Shaders
Shaders

Visual enhancements

Datapacks
Datapacks

World logic

Scanner
Mod Intelligence

Scan & analyze any mod

All Versions
View all mods →
Loading...
IntroductionIntroductionVersion HistoryVersion HistoryGuidesGuidesBlog & NewsBlog & News
ItemsItemsBlocksBlocksMobsMobsRecipesRecipesBiomesBiomesStructuresStructuresAdvancementsAdvancementsLoot TablesLoot TablesTagsTags
ModsModsPluginsPluginsResource PacksResource PacksShadersShadersDatapacksDatapacks

MinecraftBible

The Ultimate Wiki

Logo
MINECRAFTBIBLE

The ultimate Minecraft reference. Every item, block, mob, and recipe documented with precision.

Community

  • Player Database
  • Skin Browser
  • Cape Gallery
  • Community Hub
  • Seed Vault

Database

  • Items
  • Blocks
  • Mobs
  • Recipes
  • Biomes
  • Structures

Tools

  • Seed Analyzer
  • Mod Intelligence
  • Crafting Calculator
  • Enchant Calculator

Mods & Packs

  • Mods
  • Plugins
  • Resource Packs
  • Shaders
  • Datapacks

© 2026 MinecraftBible. Not affiliated with Mojang or Microsoft.

PrivacyTermsContact
AcornLib
ModLicenseRef-AcoYT-License

AcornLib

An API with features to make modding easier, including new Components, Particles, and Weapon Skins, and Supporter Perks.

3.4K
Downloads
9
Followers
2 months ago
Updated
📦
30
Versions
equipmentlibraryutilityfabric
Download Latestv1.21.1-r16View on Modrinth

📖About AcornLib

THANKS FOR 3,300 DOWNLOADS!!!!

fabric-api
modmenu
ko-fi

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)

Baby on ma' Head :3

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}"

    // MixinSquared
    include(implementation(annotationProcessor("com.github.bawnorton.mixinsquared:mixinsquared-fabric:${project.mixinsquared_version}")))

    // Trinkets
    modCompileOnly "dev.emi:trinkets:${project.trinkets_version}"

    // Config
    modApi ("com.terraformersmc:modmenu:${project.modmenu_version}")
    modImplementation ("maven.modrinth:midnightlib:${project.midnightlib_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
mixinsquared_version=0.3.3
trinkets_version=3.10.0
modmenu_version=ACCORDING_MODMENU_VERSION
midnightlib_version=ACCORDING_MIDNIGHTLIB_VERSION
cca_version=ACCORDING_CCA_VERSION

You 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

👥 Team & Contributors

AcoYT
AcoYTOwner
Mythorical
Mythorical
Non-plush bro

⚙️ Compatibility

Environment
✅ Client & Server
Loaders
fabric
Minecraft Versions
1.21.1

🔗 Links

Modrinth Page