balrond hearth marks

⚒️ Balrond Hearth Mark

---

Overview

Balrond Hearth Mark adds a new buildable Hearth Mark talisman to Valheim.

Hearth Marks create named area zones around your settlements, camps, outposts, roads, mines, and other important places. When a player enters a named Hearth Mark area, the zone name is shown in the same style as Valheim biome discovery messages.

Multiple Hearth Marks can connect into one shared network. Connected marks share the same zone name and message cooldown, can be enabled or disabled together, and show temporary connection beams while being hovered.

The mod is designed to be simple and fully in-game:

> No external gameplay config is required. > All setup is done directly on the build piece.

---

🏗️ What This Mod Adds

⚒️ Hearth Mark

A new buildable talisman-style piece.

The Hearth Mark can:

• Create a named area around itself
• Show the area name when a player enters the zone
• Connect with other Hearth Marks by range
• Share a name across connected Hearth Marks
• Share message cooldown settings across connected Hearth Marks
• Toggle an area marker visual on or off
• Show temporary connection beams between linked marks
• Be enabled or disabled as part of its current network
• Store its state through Valheim ZDO data for multiplayer persistence

---

🧭 How It Works

1. Build a Hearth Mark
2. Press Use (E) to give it a name
3. Hover it and use + / - to adjust the range
4. Use Ctrl + E to set how often the zone message can appear
5. Place more Hearth Marks nearby
6. If at least one Hearth Mark reaches another, they connect
7. Connected Hearth Marks act as one named network

When a player enters the active zone, the resolved Hearth Mark name is displayed.

If one Hearth Mark in a connected network is renamed, the name is applied to the connected enabled network. If one Hearth Mark in a connected network has its message cooldown changed, the cooldown is also applied to that connected enabled network.

---

⚙️ Features

• New buildable Hearth Mark
• Named area / settlement marker system
• Connected talisman network
• Shared names across connected Hearth Marks
• Shared message cooldown across connected Hearth Marks
• Adjustable message cooldown from 1 minute to 1440 minutes
• Default message cooldown: 10 minutes
• Adjustable range from 1m to 50m
• Default range: 15m
• Range changes directly in-game
• Optional persistent area marker display
• Temporary hover area marker
• Temporary connection beam visualization
• Enabled / disabled talisman state
• Network-wide disable behavior
• Ward/private-area access support
• Multiplayer-friendly ZDO synchronization
• Full localization key support
• No gameplay config file required

---

🧱 Building

Build Piece

The Hearth Mark is added to the Hammer build menu.

Category:

Misc

Crafting station:

Workbench

🧾 Recipe

| Resource | Amount | |---|---:| | Thunderstone | 1 | | Feathers | 3 | | Fine Wood | 2 | | Bone Fragments | 3 |

---

🎮 Controls

| Action | Input | |---|---| | Set Hearth Mark name | E | | Enable / disable Hearth Mark network | Shift + E | | Show / hide persistent area marker | Alt + E | | Set zone message cooldown | Ctrl + E | | Increase range | + or Numpad + | | Decrease range | - or Numpad - |

> ⚠️ Valheim's Interact() alt parameter is the game's alternative-use input, normally Shift + E. > This mod checks the real keyboard Alt key directly for Alt + E marker toggle.

---

🏷️ Naming System

Press E on a Hearth Mark to open the name input.

The name limit is:

64 characters

If the Hearth Mark is connected to other enabled Hearth Marks, the name is applied to the current connected network.

This allows one large settlement or base area to share the same name across multiple talismans.

---

⏱️ Message Cooldown System

Press Ctrl + E on a Hearth Mark to open the message cooldown input.

The cooldown is entered in minutes.

Default cooldown:

10 minutes

Minimum cooldown:

1 minute

Maximum cooldown:

1440 minutes

The cooldown controls how often the zone message can appear again after entering a Hearth Mark area. For example, setting the cooldown to 15 means the same zone message will not keep appearing every time you briefly leave and re-enter the zone within that time.

If the Hearth Mark is connected to other enabled Hearth Marks, the cooldown is applied to the current connected network. This means connected talismans share both the same zone name and the same message cooldown.

---

🔗 Network System

Hearth Marks connect by range.

Two Hearth Marks are connected when at least one of them reaches the other.

Example:

Hearth Mark A range: 10m
Hearth Mark B range: 15m
Distance between them: 12m

A does not reach B.
B reaches A.
Result: connected.

This lets larger Hearth Marks act as anchors for smaller ones.

Connected networks are recalculated when:

• a Hearth Mark range changes
• a Hearth Mark is enabled or disabled
• a Hearth Mark is destroyed
• a name is propagated through the network
• a message cooldown is propagated through the network

---

📏 Range System

Default range:

15m

Minimum range:

1m

Maximum range:

50m

Step size:

1m

While hovering the Hearth Mark:

• Press + to increase range
• Press - to decrease range

Changing range can:

• Connect new Hearth Marks
• Disconnect old Hearth Marks
• Merge networks
• Split networks
• Change where zone entry messages appear

---

👁️ Area Marker

The Hearth Mark has an area marker visual.