header effectheader

Moonlight Lib will start downloading in 5 seconds...


Join over 10 million players who use the CurseForge app!

Moonlight Lib


Moonlight Lib

Supplementaries Discord Support me on Patreon Supplementaries Twitter Supplementaries Twitter

đź“– 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!

You can also view all this in the /example package on github



🎨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.

The main classes you want to look at 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:




  • Dynamic block set registration

 Allows mods to specify a block set (which can be for example a wood type). The mod then will scan all registered blocks and fill the block set up only to then allow mods to register blocks that depend on it.

This can't be easily done using traditional methods since the wood set itself depends on the registered blocks so registration must happen at a very specific time. This utility makes that task possible and easy to do. Note that it is still a form of dynamic registration which might have some drawbacks.

In a nutshell you have dynamic wood type support for your blocks. The wood set type already comes built-in.


  • 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 item


  • Custom 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!


  • Dynamic Villager AI

 A 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 class


  • 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 jsons

  • Soft 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


  •  Dispenser utilities:

 Some code that allows to easily register dispenser behaviors without overriding already existing ones. Also comes with builtin spawn egg and block placement behaviors



❤️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🦉

Haunted HarvestSnowy SpiritStorage LabelsGoatedMysyical Oak TreeCarpeted StairsMmmMmmMmmMmmMoyaiJeedBetter Lily PadsAdvancement FramesRandomium