CurseForge · Minecraft mod
Moonlight Lib
Forge and Fabric lightweight library with utilities such as custom Villagers AI, data driven trades, global datapack, custom Map Markers, First and third person item animations, dynamic assets generation, dynamic registration & more
Quick answer
Which Moonlight Lib release should I use?
Moonlight Lib moonlight-1.21.1-3.3.0-fabric targets 1.21.1 with Fabric. The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server. No extra mods listed for this file.
Where it goes
Is Moonlight Lib required on the client, server, or both?
The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server.
The source does not explicitly classify this release as client-only or server-only.
What else does Moonlight Lib moonlight-1.21.1-3.3.0-fabric need?
moonlight-1.21.1-3.3.0-fabric. 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 Moonlight Lib without breaking your instance.
Built for Moonlight Lib moonlight-1.21.1-3.3.0-fabric. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use moonlight-1.21.1-3.3.0-fabric. It targets 1.21.1 with Fabric; 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
The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside moonlight-1.21.1-3.3.0-fabric. It opens that exact file at the source.
About this project
What does Moonlight Lib add?
Moonlight Lib

📖 About 📖
Formerly Selene Library, Moonlight Lib is a set of specialized utilities and shared code that I use for my mods.
These include some highly specialized features such as dynamic asset generation, 2 new data registries, dynamic registration system as well as your usual multi loader helpers and wrappers to develop for both Fabric and Forge

🛠️ Features🛠️
Here are the most important features included. If you are a developer planning to use this library this is the section for you!
The main place for documentations are these:
To import this lbrary, simply go into the file section here and click "copy gradle line". Then paste that in your build.gradle file.
🎨Dynamic Assets
Moonlight allows you to generate any asset dynamically, for both datapacks and resource packs. In particulat the mod contains an extensive API to generate dynamic textures with tools like extracting palette, cropping, reshaping images, automatic recoloring and more.
Dynamic Resources example:

Texture Recoloring example:

Palette manipulation example:

🌍 Multiloader Utilities
These sets of utilities try to be as simple as possible, usually just relying on static helper functions instead of annotations or other OOP practices, and mainly emulate Forge behavior by simply wrapping it with helper functions. For fabric the equivalent behavior is called or implemented if its not available. Some highlight of this are Deferred registration, Common Setup and more.
Mod focus is on simplicity so most important calls are split among just 4 main API classes.
These are: PlatHelper, ClientHelper, RegHelper and ForgeHelper.
For configs and networking the main classes are ConfigBuilder and ChannelHandler
Configs in particular have extra features like being able to use Codecs, be loaded early or be automatically synced to clients
PlatHelper example:

ClientHelper example

RegHelper example:

ConfigBuilder example:

ChannelHandler example:

📒 Dynamic Registration
This includes a new system (BlockSetAPI) which allows to dynamically detect "block sets" right after all blocks have been registered and dynamically register new entries which depend on it. An example is using the builtin WoodTypeRegistry or LeavesTypeRegistry, two block sets that will be populated dynamically with all installed woods and leaves from any mod, allowing you to register your wooden items in all existing wood types.
- BlockSetAPI example : defining a block set

- BlockSetAPI example: registering dynamic blocks

🧙♂️ Misc Utilities
DispenserHelper example

First and Third-person Item animations example:

🍩Custom Baked Models
- Custom Model and Model Loader example:

- Quad Utils example:

🌽Custom Villager Trades
Using the moonlight/villager_trades datapack folder you'll be able to add new custom trades to any villager. Here's an example trade. Check out Supplementaries of Sawmill for more examples

**Block Color API:**A set of utilities which allows to detect any arbitrary modded block DyeColor as well as getting the equivalent block in a different color
This works dynamically for any modded block or itemCustom map markers:
A complete system that allows to easily implement and add map decoration and map markers as well as control every aspect of them like rendering. Also allows storing simple data inside maps data offering a couple of hooks to use it too like on item tooltip.
This system also offers a simple Data Driven implementation meaning you can easily register new markers with datapacks!Global datapack folder & model loader folder
respectively in moonlight-global-datapacks and /assets/models/special_modelsDynamic Villager AIA helper system to easily and dynamically add tasks and modify villager schedules in a compatible way without overriding the whole existing AI. Also allows to properly add memory types
Custom first and third person animations: Allows modders to implement a simple interface in their items to allow it to have custom third and first person animations (like crossbows).
Includes simple and easy to use interfaces that can let you control first person and third person animations as well as a callback for rendering the item itself (similar to spyglass) directly in your item classGlobal datapacks folder
Debug renderers command
Grindstone achievement triggers:
The mod adds a custom trigger that gets called when an item is passed through a grindstone that you can call in your mods advancements jsonsSoft fluid system:
An entirely Data Driven custom virtual fluid system that goes on top of forge one and is designed to fit better in vanilla minecraft and having as main feature the ability to have multiple fluid containers items like bottles, bowls and buckets, as well as providing support for stews and drinks that can be consumed directly from a fluid tank. As opposed to the forge fluid system it has a base unit of 1 minecraft bottle (250 forge mb). The system also automatically generates all the needed fluids for already registered forge fluids and allows the user to override them or add to them easily. Fluids are virtual so they can only exist in modded container specifically for them

❤️Support Me❤️
Modding is taking a lot of my time, so if you like what I do, and you would like to support me, you can do so here. If you do, you'll receive a custom Globe and or Statue just for you! This also applies if you purchase a server from Akliz using "supplementaries" code.
Need a server? Check out Akliz, they have top brand servers just for modded minecraft.
They really have a cozy community with great support and the servers wonderfully
Use code "supplementaries" to get 20% off and also support me in the process!


🦉 Our Mods🦉
Project description from CurseForge.
Pick your setup
Moonlight Lib by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.20.1
3 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Moonlight Lib versions and loaders
moonlight-1.21.1-3.3.0-fabric
moonlight-fabric-1.21.1-3.3.0.jar
26 Jul 2026
moonlight-1.21.1-3.3.0-neoforge
moonlight-neoforge-1.21.1-3.3.0.jar
26 Jul 2026
moonlight-fabric-1.21.1-3.2.1.jar
25 Jul 2026
moonlight-neoforge-1.21.1-3.2.1.jar
25 Jul 2026
moonlight-1.21.1-3.2.0-fabric
moonlight-fabric-1.21.1-3.2.0.jar
25 Jul 2026
moonlight-1.21.1-3.2.0-neoforge
moonlight-neoforge-1.21.1-3.2.0.jar
25 Jul 2026
moonlight-1.21.1-3.1.3-neoforge
moonlight-neoforge-1.21.1-3.1.3.jar
23 Jul 2026
moonlight-1.21.1-3.1.3-fabric
moonlight-fabric-1.21.1-3.1.3.jar
23 Jul 2026
moonlight-1.21.1-3.1.2-neoforge
moonlight-neoforge-1.21.1-3.1.2.jar
18 Jul 2026
moonlight-1.21.1-3.1.2-fabric
moonlight-fabric-1.21.1-3.1.2.jar
18 Jul 2026
moonlight-1.21.1-3.1.1-neoforge
moonlight-neoforge-1.21.1-3.1.1.jar
13 Jul 2026
moonlight-1.21.1-3.1.1-fabric
moonlight-fabric-1.21.1-3.1.1.jar
13 Jul 2026
Looking for an older file? The official CurseForge project page is in Resources.
