Overview#
LLibrary is a foundational library mod designed to provide a set of modern and advanced tools for other mods to utilize. Created by iLexiconn and sbom_xela, it acts as a backend framework that allows different mods to interact more smoothly, reducing crashes and improving overall performance in large modpacks.
While LLibrary does not add traditional survival content like ores or weapons, it is a mandatory dependency for several massive mods, including:
- Ice and Fire: Dragons
- Fossils and Archeology Revival
- Mowzie's Mobs
- Rats
- JurassiCraft
By centralizing complex code for animations, entity data, and structure handling, LLibrary ensures that these high-quality mods can function together without conflict.
Key Features#
LLibrary introduces several technical breakthroughs for the 1.12.2 and 1.7.10 modding eras, most notably in how entities move and interact with the world.
Advanced Animation API
The mod's primary feature is its sophisticated Animation API. Before LLibrary, Minecraft animations were often stiff and limited. This API allows developers to create fluid, multi-stage animations with smooth transitions. This is the technology that powers the lifelike movements of dragons in Ice and Fire and the complex behaviors of prehistoric creatures in Fossils and Archeology.
Multi-part Entity Support
Standard Minecraft entities have a single rectangular hitbox, which is problematic for large or oddly shaped creatures. LLibrary allows a single mob to have multiple distinct hitboxes assigned to different body parts (e.g., head, tail, wings). This ensures that players must actually strike the creature's model to deal damage, rather than hitting the empty air around it.
Structure Tools
LLibrary includes a robust system for saving and loading structures. This tool is used by other mods to generate complex dungeons, ruins, and nests dynamically within the world. It supports both.nbt and.json formats, making it highly flexible for world generation.
Visual & UI Enhancements#
In addition to backend tools, LLibrary adds several quality-of-life visual features that players will notice immediately in-game.
Mod Name Tooltips
When hovering over any item in an inventory, LLibrary adds the name of the mod that the item belongs to at the bottom of the tooltip. If advanced tooltips are enabled (F3+H), it also displays the internal mod ID and registry name.
Snackbars
LLibrary introduces "Snackbars," which are small, non-intrusive notification bars that appear at the bottom of the screen. These are often used to display mod update alerts or status messages without interrupting gameplay.
Patron Effects
Supporters of the mod's development may have unique visual effects attached to their player models, such as a small white cube or other floating icons. These effects are visible to any player who has LLibrary installed.
Technical Mechanics#
LLibrary provides several internal systems that manage how data is handled between the server and the client.
| Mechanic | Description |
|---|---|
| Entity Data Handlers | A powerful system for syncing custom entity variables (like age, hunger, or taming status) across the network. |
| Command Builder | An expandable framework that allows other mods to easily register new chat commands. |
| ASM Utilities | Lightweight bytecode manipulation tools that allow the mod to patch Minecraft's core code for better compatibility. |
| Web API | A helper system that allows mods to safely parse web content, such as checking for updates or fetching skin data. |
| Weapon Dictionary | A registry that allows different mods to identify what items are considered weapons, enabling cross-mod compatibility for combat mechanics. |
Configuration#
The mod's settings can be adjusted via the llibrary.cfg file located in the /config folder of your Minecraft directory. These options allow players to toggle specific UI features and performance settings.
| Option | Type | Default | Description |
|---|---|---|---|
checkUpdates |
Boolean | true |
Enables or disables the built-in mod update checker. |
versionCheckInterval |
Integer | 1 |
Sets how often (in days) the mod checks for updates. |
patreonEffects |
Boolean | true |
Toggles the visibility of floating patron effects on players. |
modNameTooltip |
Boolean | true |
Toggles the display of the mod's name in item tooltips. |
extraTooltipInfo |
Boolean | true |
Shows mod ID and registry name when advanced tooltips are on. |
Commands#
LLibrary adds a base command that can be used to manage the library and its dependent mods. Note that many sub-commands are added dynamically by other mods using the LLibrary framework.
/llibrary: The base command for the mod. Running this alone will usually display the help menu or version info./llibrary version: Displays the current installed version of LLibrary and checks for any available updates.
For developers, LLibrary also provides hooks to create custom commands with complex argument parsing, which are then accessible under the /llibrary prefix or as standalone commands.
