Skip to content

Hearthborn Client

A custom client for Haven & Hearth

Plan your village. Simplify production. Explore with better tools.

Features · Documentation · Privacy · Support development · Screenshots

Hearthborn Client

Built on top of the original (vanilla) Haven & Hearth client, Hearthborn is an independent, unofficial custom client focused on improving everyday gameplay through a customizable interface and tools for village management, production, exploration, mining, and more.

Languages: English and Russian (approximately 98% of the client translated into Russian) · Technology: Java 22 / Apache Ant

Features

Explore each feature in its own illustrated guide.

🎛️ Interface & controls

  • Redesigned interface — Classic 4×4 or sidebar menu, movable toolbars, snapping windows, mirrored HUD, and compact mode.
  • Redesigned Action Search — Favorites, history, recipe details, and ingredient search.
  • Sky — Day and night drawn by the graphics card: sun, moon phases, clouds and stars.

⚙️ Production & management

⛏️ Mining & combat

Getting started

Hearthborn is an unofficial custom client for Haven & Hearth. It is installed with its launcher, which has Java 22 built in, downloads and checks the client, and offers updates.

  1. Open the latest release and download the launcher archive for your system: hearthborn-launcher-windows-x86_64.zip, hearthborn-launcher-macos-aarch64.zip (Apple Silicon), hearthborn-launcher-macos-x86_64.zip (Intel Mac) or hearthborn-launcher-linux-x86_64.zip.
  2. Unpack the whole archive into a folder and start Hearthborn.exe (Windows), Hearthborn.app (macOS) or Hearthborn/bin/Hearthborn (Linux). The first start downloads the client, about 100 MB.

The launcher is not code-signed yet, so the system warns you the first time. On Windows click More info → Run anyway. On macOS Control-click the app, choose Open, then Open again; if macOS still refuses, run xattr -dr com.apple.quarantine Hearthborn.app in Terminal once.

The launcher does not update itself: when a newer launcher exists, it tells you once and its New launcher… button opens the download page. Client versions and game data are stored separately (%LOCALAPPDATA%\Hearthborn on Windows, ~/Library/Application Support/Hearthborn on macOS, ~/.local/share/hearthborn on Linux) and stay when you replace the launcher.

To explore the available features and controls, start with the interface guide and automation guide.

Documentation

Detailed guides with screenshots are available throughout the documentation. Start with the interface guide or storage and stockpiles, or use the feature links above to open individual guides.

Note: Timers, quality information, maps, and automation rely on data actually observed by the client. They do not reveal unexplored information or guarantee successful actions.

Privacy

Hearthborn does not send your data to third-party services. It only sends the data required to connect to and play on the official Haven & Hearth servers.

Support development

Hearthborn is free for everyone. Donations are voluntary and help support continued development, bug fixes, and new features. They do not unlock exclusive features or provide in-game advantages.

❤️ Support Hearthborn on Buy Me a Coffee

Credits and license

Hearthborn is an independent project based on the Haven & Hearth client. Original game and client credits belong to their respective authors. Refer to the upstream client for its original license terms.

Screenshots

A quick look at Hearthborn's interface and tools. Click a feature name for the full guide.

Customizable interface Village & claim planning
Customizable Hearthborn interface Village planner
Quality Roster Map icons & display settings
Quality Roster Map tools
Cheese production Automation & Xtensions
Cheese production chart Xtensions menu
Cheese aging on racks Cupboard contents
Cheese racks and aging stages Item icons above cupboards
Day and night sky Moon and stars
Night sky with the full moon The moon in another phase