Lukas

All projects

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.

The trailer, 80 seconds, no voice. Every game scene is a frame-by-frame capture from a real Minecraft 26.3 client; the control center scenes are the real web interface at the time of recording; the screenshots below show the current one.

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.

      Change a reward, apply, see it in game

      1. 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.
      2. One button: Apply changes. The change becomes a new version; nothing is overwritten.
      3. 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.
      4. 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.

      Preview

      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.

      Contact sheet of all item icons on a frost background: clothing, sleds, tools, drinks, materials, fishing, events, decor, companion hats and claim markers Contact sheet of all item icons on a polar night background: clothing, sleds, tools, drinks, materials, fishing, events, decor, companion hats and claim markers
      Every item icon of the pack on one sheet, 16 × 16 pixels, with colour ramps that shift towards blue-violet in the shadows and towards warm in the highlights. Select the sheet to open it large.
      The 3D models of the pack: advent board, aurora ribbons, braziers, lanterns, hats, hearthstone, kettle, sleds and more
      The 3D models: decorations, hats, sleds, aurora ribbons.
      The HUD glyphs: an eleven step warmth bar from ice to ember, status and weather icons, rank and skill icons
      The HUD glyphs: the warmth bar in eleven steps, status, weather, rank and skill icons.

      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.

      Hearthfall architecturePlayers connect to a Paper 26.3 server running the Hearthfall plugin and download the resource pack from the control center. Owner and friends reach the control center in a browser through Apache with Discord login. The control center stores versioned configuration in its own MariaDB schema and pushes it to the plugin over a signed WebSocket bridge; the plugin validates it again, applies it without a restart and keeps the last applied copy on disk. The plugin stores game data in MariaDB. A filtering Docker proxy lets the control center restart the server and build packs, and backups go nightly to an off-site storage box. PlayersMinecraft 26.3 Paper 26.3 + Hearthfall29 modules · Java 25 · port 25580 Control centerFastify · React · versions · audit Browserowner, friends config, consoleapplied / rejected HTTPSDiscord login · Apache + TLS resource pack (SHA-1 pinned) applied/*.jsonboot copy when the control center is down Docker proxyfiltered: restart, logs Pack builderon demand: pipeline in a container MariaDB: hf_gameeconomy · claims · homes · ledgermarket · skills · events · fishing MariaDB: hf_ccconfig versions · users · sessionsaudit log · packs · backup records Discordlogin, link, bot World + backups04:30 snapshot, zstd, 2 dumps Verify drillscratch DB + scratch Paper boot Off-sitestorage box, rsync

      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.
      Load test with bots on production settings: 4.5 GB container, world pre-generated to radius 1300
      BotsSpread over the worldMSPT p95, medianWindows over 25 msTPS, lowest
      25314.0 ms9 of 14419.8
      30826.6 ms100 of 14418.4
      401851.6 ms274 of 27515.3
      40, tuned1831.8 ms134 of 13617.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.

      Request a tour

      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.

      Ask by email

      A server product of your own, with a web interface? I can build that for you, too.

      Get a quote