
Description
Decorate a Yule Tree that leaves up to two gifts every night, open them gacha-style for gold, diamonds or festive gear, and defeat Krampus for the Starlit Sleigh.


- Yule Tree: a 4-block tree you decorate in three steps (Fairy Lights, 6 Baubles, Star Topper). Each step makes it shine brighter on the ground around it, and a finished tree hangs an aurora in the night sky.
- Up to 2 gifts a night: at dusk the finished tree shudders and throws them out in an arc. Gifts cannot be crafted.
- Gacha gifts with five tiers, each with its own opening animation, particles and sound: Common 86%, Rare 8% (gold), Epic 3.5% (diamonds), Treasure 2% (gear), Legendary 0.5% (best gear, announced to the server). Every chance is in the config.
- Krampus: a 420 HP boss with a three-hit birch switch combo, an ice-ring slam, thrown coal and a howl that enrages him below half health. Called with Naughty Coal at night.
- Starlit Sleigh: two seats, flies where the driver looks, leaves a trail of stars. The driver sits with both hands on the reins, which swing with the ride; the passenger sits at rest.
- 3 armor sets with animated capes, plumes and hats, each with a full-set bonus; 4 weapons, including a Star Scepter that fires homing stars.
- Fairy Lights for your walls, Snow Globe that freezes nearby hostiles, festive food.
- Original particles and sounds, all made for this mod. English and Indonesian.
## Requirements
- **Forge 1.21.1:** [GeckoLib](https://www.curseforge.com/minecraft/mc-mods/geckolib) 4.9.3 or newer
- **Fabric 26.2:** [Fabric API](https://www.curseforge.com/minecraft/mc-mods/fabric-api) and [GeckoLib](https://www.curseforge.com/minecraft/mc-mods/geckolib) 5.5.5 or newer, Fabric Loader 0.19.3 or newer
- **Fabric 26.3:** [Fabric API](https://www.curseforge.com/minecraft/mc-mods/fabric-api) and [GeckoLib](https://www.curseforge.com/minecraft/mc-mods/geckolib) 5.5.7 or newer, Fabric Loader 0.19.3 or newer

1. Craft Naughty Coal (coal block, 3 blaze powder, snowball) and use it on the ground at night. Krampus climbs out.
2. Defeat him for Yule Heartwood and Krampus Horns.
3. Craft a Yule Tree from Yule Heartwood, 3 spruce saplings, 2 spruce planks and red wool, and place it near your base.
4. Right-click the tree with Fairy Lights, then 6 Baubles, then a Star Topper.
5. Stay within 24 blocks at dusk and open what it throws out.

- Crafted only from what Krampus drops.
- Three stages: Fairy Lights, then 6 Baubles, then a Star Topper. Every stage lights a little more of the ground around it.
- A finished tree checks at dusk for a player within 24 blocks, then shakes and throws its gifts out in an arc. Once a night, 2 gifts at most.

| Tier | Chance | Contains | When opened |
|---|---|---|---|
| Common | 86% | Vanilla food and everyday items | Hops, lid pops, confetti |
| Rare | 8% | 1-3 Gold Ingots | Gold foil, shakes harder, gold pillar, coins rain |
| Epic | 3.5% | 1-2 Diamonds | Ice foil, floats and spins inside orbiting shards |
| Treasure | 2% | Winter Warden or Nutcracker armor, Peppermint Cleaver, Nutcracker Maul | Red and gold, stomps the ground, shockwaves |
| Legendary | 0.5% | Aurora Regalia, Aurora Blade, Star Scepter | Rises and spins in aurora ribbons, star burst, server announcement |
## Krampus
- 420 HP and 10 armor. Fights with a birch switch: a three-hit combo up close, a slam that sends out a ring of ice, thrown burning coal.
- Below half health he howls and the fight turns colder.
- Always drops 1-2 Krampus Horns, 1-2 Yule Heartwood, a Birch Switch, 2-4 Diamonds and 4-8 Baubles.

- **Winter Warden:** full set gives Resistance I.
- **Nutcracker:** full set gives Strength I.
- **Aurora Regalia:** full set gives Regeneration, Speed and Night Vision.
- **Peppermint Cleaver:** hits give you a burst of Speed.
- **Nutcracker Maul:** knocks hostiles around the target away.
- **Aurora Blade:** slows what it cuts.
- **Star Scepter:** right-click fires a homing star every 0.8 s.
- **Birch Switch:** Krampus's own weapon, dropped when he falls.

- Craft a Sleigh Bell from a Krampus Horn, 2 gold ingots, a bell and red wool.
- Ring it to call your sleigh, ring it again near the sleigh to send it home.
- Right-click to sit. The first rider drives: W to fly, look to steer and climb. Shift to get off; you drift down with Slow Falling.
## Configuration
`config/yulelight.json`: `gifts_per_night` (0-2), `gift_chance_rare`, `gift_chance_epic`, `gift_chance_treasure`, `gift_chance_legendary`, `krampus_health`, `krampus_night_only`, `sleigh_speed`, `fx_density`, `aurora`.
Gift contents are loot tables at `data/yulelight/loot_table/gameplay/gift_<tier>.json`, so a datapack can change them.
## Crafting
- **Bauble**: 1× Gold Nugget + 3× Glass Pane + 1× Red Dye — crafting grid `·N·` / `GRG` / `·G·` (`N` = Gold Nugget, `G` = Glass Pane, `R` = Red Dye)
- **Fairy Lights**: 3× String + 2× Glowstone Dust + 1× Redstone — crafting grid `SSS` / `GRG` (`S` = String, `G` = Glowstone Dust, `R` = Redstone)
- **Naughty Coal**: 3× Blaze Powder + 1× Coal Block + 1× Snowball — crafting grid `·B·` / `BCB` / `·S·` (`B` = Blaze Powder, `C` = Coal Block, `S` = Snowball)
- **Sleigh Bell**: 1× Krampus Horn + 2× Gold Ingot + 1× Bell + 1× Red Wool — crafting grid `·H·` / `GBG` / `·R·` (`H` = Krampus Horn, `G` = Gold Ingot, `B` = Bell, `R` = Red Wool)
- **Snow Globe**: 5× Glass + 1× Snow Block + 3× Gold Nugget — crafting grid `GGG` / `GSG` / `NNN` (`G` = Glass, `S` = Snow Block, `N` = Gold Nugget)
- **Star Topper**: 4× Gold Ingot + 1× Glowstone — crafting grid `·G·` / `GSG` / `·G·` (`G` = Gold Ingot, `S` = Glowstone)
- **Yule Tree**: 3× Spruce Sapling + 1× Yule Heartwood + 2× Spruce Planks + 1× Red Wool — crafting grid `·S·` / `SHS` / `PBP` (`S` = Spruce Sapling, `H` = Yule Heartwood, `P` = Spruce Planks, `B` = Red Wool)
Recipe pictures are in the gallery.

1. Install the loader for your version: Forge 1.21.1, or Fabric Loader for 26.2 / 26.3.
2. Put the jar for your version and its requirements (above) in your `mods` folder.
3. Servers need the same jar and requirements. Players joining a server need the mod too.
## Compatibility
- Minecraft 1.21.1 · Forge
- Minecraft 26.2 · Fabric
- Minecraft 26.3 · Fabric
## How this mod was made
This project contains AI-generated content, page text / translations. The logo, icon and banners were composed by code from renders of the mod's own models, not by an image generator. Gallery images are in-game screenshots.







