Minecraft 26.3 · Paper · commercial
Hearthfall
Keep your fire lit.
A winter survival server for Minecraft 26.3. The cold is the enemy, the hearth is home: warmth is a resource, a hearthstone claims a piece of the world, and the winter calendar turns the server into an event. I built all of it, the plugin, the world, the resource pack and the control center. It is a commercial product, not open source.
Ask for a guided tourLicensing and buying
It runs privately, whitelisted, for friends. A guided tour is available on request.
- 29
- modules, every one editable in a web form
- 4,500+
- unit tests, plus 286 bot checks on a real server
- 738
- security checks, none failing
- 1.2 MB
- resource pack, 370 files, drawn from scratch
What it plays like.
Real captures from a headless Minecraft 26.3 client with the shipped resource pack. Select an image to enlarge it.
Emberhold at dusk: the spawn chute runs down to the market square
The market square with every stall and lantern lit
A blizzard rolls in. The ember brazier is the only warm colour for a block in every direction
The frozen lake with its ring of lanterns, seen from the shore
The pier in daylight: the lanterns form a snowflake on the ice
Emberhold from above: lake, market, houses and the spawn chute
The village around the lake, built by hand on generated terrain
An aurora night: green and violet ribbons over the world
Fireworks over Emberhold on New Year’s Eve
A sled with a rider on the market square
The ember brazier’s fuel menu, drawn with the pack’s own GUI skin and title font
The advent calendar: opened doors are green, missed days can be claimed late
The snowball fight: round, score and hits left in the sidebar
The snowball arena at night with a power-up message
A snow golem companion with the aurora hat
Between the market stalls at dusk
The cold, as a formula.
Every second, warmth moves a few percent towards a target. The target is the sum of what is around you. Change the inputs and watch it: the numbers are the shipped defaults, and everything runs in your browser.
Target warmth
0/ 100
Course from 70 warmth
target = biome + height + time of day + weather + zone + water + shelter + clothing + heat source + drink, clamped to 0 to 100. Every second: warmth += (target − warmth) × rate, with 0.08 when warming and 0.03 when cooling. A heat source counts at full strength at the source and falls off linearly to its radius; only the strongest counts.
Never touch a YAML file.
The control center asks what you want, not which number: how cold, how often a blizzard, how much money. It shows what that means for players, and every exact value stays one click away. Versioned, validated twice, applied without a restart.
Overview: is the server up, who is online, the address to join, and anything that needs you
Decisions instead of numbers: pick how cold it gets and see what that means for players, computed from the warmth model
Advent calendar: click a door, pick the reward by name and icon
First-run setup: five questions, about two minutes, ends with your join address
Rewards with their real odds; the exact editor and a simulator with 10,000 rolls are one click deeper
Under Advanced: the fireworks timeline with a canvas preview
History with a comparison of any two versions; every version is one click away
Change a reward, apply, see it in game
- Pick what you want: Cozy, Normal or Harsh. The page says what it means for players, computed from the real model. Every exact value stays under Advanced.
- One button: Apply changes. The change becomes a new version; nothing is overwritten.
- The control center tells the plugin over a signed WebSocket. The plugin validates the document again, builds the new state off the main thread and swaps it in.
- The bar says “Saved and live”. Players see the change without a restart. If the server refuses, it says why and keeps running the last good version. Undo is one click, and it is a new version too.
Try the message preview
All text in the game is MiniMessage: colours, gradients, bold, italic. The control center shows it as you type, the way it looks in chat. This is a small subset running in your browser.
The resource pack, from scratch.
The pack is built by a pipeline, not by hand: item icons, a custom bitmap font called Rime, GUI skins, armour textures, 3D models for sleds and decorations, sounds and a whiteout post effect. 370 files, 1.18 MB, 104 tests, validated against the real 26.3 client. The colours come from one palette: polar night, glacier, and a single warm colour, ember orange, that always means fire, warmth or reward.


How it fits together.
The plugin boots from its last applied copy when the control center is down, so the web interface can never take the game down with it.
Tested, with the real numbers.
What ran, and what it found, including where the target was missed.
- Unit tests
- Plugin 3,040 (JUnit), control center 1,456 server + 91 web (Vitest), Docker proxy policy 8
- Contract tests
- 498 checks: every config fixture must parse in Java and validate in the TypeScript schema, bridge frames written by Java are decoded by TypeScript
- Browser tests
- 60 Playwright tests with screenshot sets, light and dark, desktop and phone
- Bots on a real server
- 286 checks, 0 failed: climate 13, items and loot 37, SMP core 61, shop and market 35, events 66 (including a nine-bot gift draw), integrations 49, control center link 25
- Integration
- 83 checks across publish, applied acknowledgement, rollback and “offline, then applied on reconnect”; the full production bundle boots as a scratch copy and passes its smoke test including a restore drill and secret rotation
- Security
- 738 checks, 0 failed: role matrix, CSRF, session fixation, uploads, console bypasses, loot templates, bridge, Docker proxy, secrets, rate limits. The restore drill found and fixed a real bug
- Soak
- 120 minutes with 15 bots, weather cycles and a config publish every 5 minutes: heap flat (+61 MB/h within a ±100 MB scatter), one full GC, 0 kicks. The target was 6 hours, so this is an honest 2.
| Bots | Spread over the world | MSPT p95, median | Windows over 25 ms | TPS, lowest |
|---|---|---|---|---|
| 25 | 3 | 14.0 ms | 9 of 144 | 19.8 |
| 30 | 8 | 26.6 ms | 100 of 144 | 18.4 |
| 40 | 18 | 51.6 ms | 274 of 275 | 15.3 |
| 40, tuned | 18 | 31.8 ms | 134 of 136 | 17.4 |
The load target (MSPT p95 under 25 ms at 25 to 40 players) is met when most players are together, as they are around Emberhold, and not met when 18 of 40 are spread across the world; every extra spread player costs about 2.5 ms per tick because it loads its own chunks and animals. The plugin itself is 0.4 % of the main thread in a profiler. For a friends’ server that is plenty; for a public one it is the limit to plan around.
What is in it.
The feature list, grouped. Each module can be switched on or off in the control center.
Warmth
- Every player has a warmth value from 0 to 100 that moves towards a target once a second: biome, height, time of day, weather, zone, water, shelter, clothing, heat sources and drinks all count.
- Toasty, comfortable, chilled, freezing, hypothermia, each with its own effects, a frost vignette and a HUD bar built from font glyphs.
- Heat comes from a per-chunk map kept up to date by block events, so there is no scanning of blocks every tick.
Clothing and gear
- Four tiers of clothing with their own armour textures: knitwear, fur-lined, expedition and aurora, plus ice skates that make you faster on ice.
- Sleds with server-side physics, an ice auger, a kettle for hot cocoa, spiced cider and ember tea, frost lanterns, ember braziers and the hearthstone.
- A snow golem companion that follows you, wears hats and can carry a small lantern as a mobile heat source.
Weather and world
- A weather machine with snowfall, blizzards with a whiteout and a 60 second warning, cold snaps that freeze the lakes, and aurora nights.
- A cold-skewed world generator as a data pack, two new biomes (glacier fields, rime forest), a fixed seed, and Emberhold, a hand-built starting village with market, post office, advent board, lake and a snowball arena.
- Ice fishing with six species, an aurora fish that only bites on aurora nights, a fishing journal and a weekly leaderboard.
Seasonal events
- An advent calendar with 24 doors, late claims and a guaranteed gift on door 24.
- Secret Frost, a gift exchange with a derangement so nobody draws themselves, a post office and a mailbox.
- A snowball fight with teams, power-ups and rounds, and a New Year fireworks show choreographed on a timeline over the lake.
Economy and land
- Embers as the server currency with a ledger, a shop with price decay, a player market with mail, and skills that level up from useful work.
- Hearth claims: place a hearthstone and the land around it is yours, with trust levels, flags and a claim map. Homes, warps, ranks and chat formats.
- Optional links to StreakRewards, Fortuna and StaffPanel without touching their config by hand, Discord linking, and Prometheus metrics.
Control center
- Made for owners who are not developers: six areas, plain choices with computed consequences, item pickers with icons, a first-run wizard, English and German. All exact values stay available under Advanced.
- Versioned config with hot reload and one-click undo; an audit log of every change; roles for owner and friends; Discord login.
- Console, player tools, backups with a verify drill, a resource pack manager, and a command palette. Light and dark, desktop and phone.
Licensing, and a guided tour.
Hearthfall is a commercial product. Source code, jars and the resource pack are not available for download, and there is no public repository. Licensing comes with the Compose bundle for installation, the documentation and support. Terms are on request.
A guided tour
Hearthfall runs privately and whitelisted, for friends. If you want to see it live, I can walk you through the world and the control center on a call or on the server. Ask, and we find a time.
Licensing and buying
One licence covers one server, with the Compose bundle for installation, documentation and support. There is no download here and no public repository. Tell me about your server and I send the terms.
A server product of your own, with a web interface? I can build that for you, too.

