Moonlight — Guide

Which Mods Need It

Install Moonlight whenever a mod you use lists it as a dependency (mod id moonlight). If it is missing, those mods will fail to load and the game will report a missing-dependency error for moonlight.

• Moonlight is the core library behind the Supplementaries family of mods - so those mods need it in your mods folder.
• Any other mod that uses Moonlight's dynamic assets, map markers, soft fluids, or data-driven trades also requires it.

Because it is a shared dependency, the rule of thumb is simple: add Moonlight when a mod tells you to, and leave it out otherwise.

Developer API

Moonlight is consumed by other mods as a dependency (mod id moonlight).

Adding it to a dev environment (Gradle): declare a modImplementation dependency on the Moonlight artifact that matches your Minecraft version and loader, and reference the mod id moonlight in your mod metadata so the game enforces load order.

Key areas the library exposes: - Dynamic resources - generate textures, models, and language entries at runtime instead of shipping every asset (useful for mods with many procedurally-styled variants). - Map Marker API - register custom markers and decorations that render on in-game maps. - Soft Fluid API - a lightweight fluid abstraction for storing and displaying fluids in tanks and containers. - Data-driven villager trades & schedules - define trades and villager daily schedules through data. - Platform / registry / networking helpers - multi-loader abstractions so common code runs across loaders.

Consult the in-code documentation for full API details and current version coordinates.