Moonlight Lib is a versatile library mod designed to significantly enhance modding capabilities within Minecraft, addressing several common challenges faced by developers. It provides a robust framework for creating dynamic resource packs and datapacks, allowing for runtime modifications to game assets and data. This is particularly useful for adding new wood-based blocks or retexturing existing ones without the need for manual asset replacements. Furthermore, the mod introduces a sophisticated system for dynamic block set registration, enabling mods to define and manage block sets like wood types. This solves the complex issue of registering blocks that depend on these sets, which traditionally requires precise timing during the registration process, making it difficult to implement. Moonlight Lib streamlines this by allowing blocks to be registered based on already defined block sets, simplifying the creation of interconnected modded content. The mod operates by providing a suite of interconnected utilities that empower modders to implement advanced features with greater ease and flexibility. Its dynamic resource pack utilities allow for the creation of runtime resource packs and datapacks, enabling on-the-fly changes to textures and assets, which is especially beneficial for adding new wood types or custom block appearances. The dynamic block set registration system ensures that blocks can be correctly registered even when they depend on other registered elements, such as specific wood types, by managing the registration order effectively. The custom map marker system offers a comprehensive solution for adding and controlling map decorations and markers, including their rendering and associated data, with a data-driven implementation for easy expansion via datapacks. Additionally, the dynamic villager AI system allows for the seamless integration of new tasks and schedule modifications for villagers without overwriting existing AI, while custom animations and grindstone achievement triggers provide further avenues for mod customization. Moonlight Lib is designed for broad compatibility across various Minecraft versions and loader configurations. It supports Minecraft versions 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.4, 1.21, and 1.21.1. The mod is compatible with the Fabric, Forge, and NeoForged loaders, ensuring that a wide range of modpacks can utilize its features. Crucially, Moonlight Lib is required on both the client and the server. This means that players installing mods that depend on Moonlight Lib will need to have it present in their client-side mod folder, and server administrators will also need to install it on their server to ensure all functionalities are properly loaded and executed for all connected players, maintaining consistency across the game environment. This dual installation requirement ensures that all dynamic content and advanced functionalities provided by Moonlight Lib are correctly synchronized and accessible to everyone, preventing potential desynchronization issues or crashes that might arise from an incomplete setup. Installing Moonlight Lib is a straightforward process, contingent on the mod loader you are using. For Fabric, the mod file should be placed directly into the `mods` folder within your Minecraft installation directory. Similarly, for Forge and NeoForged, the same procedure applies: the mod `.jar` file needs to be moved into the `mods` folder. Before launching the game, it is essential to verify that you have the correct version of the mod installed that matches your Minecraft version and that it is compatible with your chosen mod loader. Additionally, ensure that all other mods that rely on Moonlight Lib are also correctly installed and compatible, as this library is a foundational component for many other mods and its absence or incompatibility can lead to game crashes or unexpected behavior. Always check the specific requirements of any mod that lists Moonlight Lib as a dependency to guarantee a smooth and error-free gaming experience.
