
Fairy Lights
Decorative hanging lights that can have any combination of light variants of any dye color, with Sable support and Flywheel optimizations.
Screenshots






About this Mod

Fairy Lights adds decorative hanging lights that can have any combination of light variants of any dye color.
This fork adds new feature such as:
- Hanging Light wire can now be colored by right-clicking with any dye.
- Sable (Create Aeronautics) support.
- Optimization with Flywheel renderer, improving the FPS in almost 3x.
- A lot of fixes and general optimizations.
- Most models are now .bbmodels, which can be either edited with resourcepacks and make the process of adding new lights to the mod even easier.
- Lights can be placed on ground with 16-step yaw rotation.
- You can color lights placed on ground by right-clicking with any dye.
- Fixed hitbox rendering
Features
As long with the fork additions, these are all the features that Fairy Lights brings to your world:
- Customized Hanging Lights with infinite possibilities of combinations.
- Dyeable string/wire with any dye color.
- Right click with empty hand to toggle light on and off.
- Letter and Pennant buntings to bring texts to your buildings.
- Fence support, you can place Fairy Lights on both horizontal and vertical fences!
- Give a redstone signal to a Hanging Light and enjoy familiar Jingles!
- Use a String or a Stick to increase/decrease the wire sizes!
- Swap Lights on Hanging Lights by right clicking the target spot with your desired light.
- Put a Light + Glowstone Dust on the crafting grid to make a Twinkling light!
- Integration with JEI and Sable!
- Optimized so your world can have lots of Fairy Lights!
Crafting
In order to craft hanging lights you first must craft the lights. Lights come in many variants, fairy light, heart light, moon light, star light, paper lantern, orb lantern, flower light, candle lantern, oil lantern, snowflake light, icicle lights, and meteor light. There are also spooky lights, spider light, ghost light, jack o'lantern, skull light, witch light.
Fairy lights are crafted by a horizontal combination of iron ingot, string or stick, iron ingot, along with any combination of lights to specify a pattern (left-right, top-down). If glowstone is included the hanging lights will twinkle. If string is used there will be slack in the connection and if a stick is used the connection will be straight. The hanging lights item will only show the first four light colors, but the most lights that can be crafted is eight by placing a hanging lights in a crafting table with eight lights.
Here are the light recipes where the red dye in the recipes can be any dye.

Example of Hanging Lights Recipe
Here are some examples of combinations you can do with Fairy Lights.

Redistribution
You're allowed to use this mod on your modpack, preferably on CurseForge and Modrinth so the mod is not loaded as an external mod.
Credits
- pau101, for the original Fairy Lights mod - MIT license.
- jaredlll08, for the multi-loader template.
- Flywheel, for the optimized rendering.
Next Plans
- Support for shader/dynamic lights, so instead of using block lights the lights actually come from the hanging light.
- New light models.
- More recent Minecraft versions.
Available Versions
How to Install Fairy Lights on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Fairy Lights". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Fairy Lights server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is Fairy Lights compatible with fabric and neoforge?
Fairy Lights officially supports fabric, neoforge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Fairy Lights – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Fairy Lights consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Fairy Lights with just one click on your server.