TruffleBoars

TruffleBoars gives your tamed boars a delightful and rewarding new domestic purpose: rooting in natural soil to dig up wild mushrooms!

In real-world folklore and tradition, swine are celebrated for sniffing out and uncovering truffles and forest fungi buried beneath fertile earth. TruffleBoars brings this classic pastoral mechanic directly into Valheim with rich audio/visual effects, star-tier breeding incentives, pen lag prevention, and complete multiplayer synchronization.

---

Features

• 🍄 Mushroom Foraging: Tamed adult boars periodically root into natural soil, grassy meadows, and cultivated farm plots to unearth mushrooms.
• 🎬 Living Animations & Effects: Boars pause their idle wandering, lower their snouts to root into the ground with authentic eating/rooting animations, kick up dirt particle clouds, and play earthy digging sound effects before the mushroom pops free!
• ⭐ Star-Tier Breeding Rewards:
  • 0-Star Boar: Steady, standard mushroom foraging.
  • 1-Star Boar: 20% faster forage cooldowns and a 30% bonus chance to dig up extra yield.
  • 2-Star Boar: 40% faster forage cooldowns, 60% bonus chance for extra yield, and a chance to dig up rare subterranean treats like Yellow Mushrooms!
• 🌿 Ground & Structure Detection: Boars only dig when standing directly on natural terrain (grass, forest dirt, or cultivated ground). They will never dig through wooden floors, cobblestone slabs, marble structures, or player-built buildings.
  • 🧹 Pen Clutter & Lag Protection: If an enclosure or pen already has several uncollected mushrooms lying around (configurable, default: 5 items within an 8-meter radius), boars pause foraging until the player gathers them. This protects your frame rate and avoids runaway item clutter when you're away on long voyages!
• 🍎 Contented & Fed Requirement: By default, boars only forage when they are well-fed and happy (RequireFed = true), rewarding you for keeping feeding troughs stocked with berries, carrots, turnips, or onions.
• 🌐 Multiplayer & ServerSync:
  • Fully authoritative ZNetView synchronization: only the network owner of the boar manages the timer and drops the item, preventing duplicate spawns.
  • Built-in ServerSync allows dedicated server administrators to lock and enforce configs for all connected players.

---

Configuration

The configuration file is created automatically at BepInEx/config/com.jubaroo.truffleboars.cfg upon first run. All settings can be adjusted in-game via configuration managers (e.g. BepInEx Configuration Manager) or directly edited:

General

Setting	Default	Description
Lock Configuration	true	If on, the configuration is locked and can only be changed by server admins.
Enabled	true	Master toggle for the TruffleBoars mod.
RequireTamed	true	Whether boars must be fully tamed to forage.
RequireFed	true	When true, boars only forage when well-fed and happy.
PigletsCanForage	false	Whether baby piglets can forage or only mature adult boars.
AllowOnStructures	false	Allow boars to forage on top of player buildings (wood/stone floors).
AllowOnPavedRoads	false	Allow boars to forage on hoe-paved cobblestone surfaces.
ExtraBoarPrefabs	""	Comma-separated list of additional creature prefab names to treat as boars (for modded boars).

Timers & Cooldowns

Setting	Default	Description
MinForageInterval	240	Minimum seconds between forage attempts (e.g., 4 minutes).
MaxForageInterval	480	Maximum seconds between forage attempts (e.g., 8 minutes).
StarCooldownReductionPercent	20	Percent reduction applied to cooldown per star (e.g., 20% for 1-star, 40% for 2-star).

Drops & Loot

Setting	Default	Description
DefaultDropPrefab	Mushroom	The default item prefab dropped (Red Mushroom).
RareDropPrefab	MushroomYellow	The rare item prefab dropped by high-tier boars (Yellow Mushroom).
OneStarRareChance	10	Percent chance (0-100) for a 1-star boar to dig up the rare item instead.
TwoStarRareChance	30	Percent chance (0-100) for a 2-star boar to dig up the rare item instead.
BonusDropChancePerStar	30	Percent chance per star level to produce an extra +1 mushroom item.

Limits & Lag Prevention

Setting	Default	Description
MaxNearbyItems	5	Maximum number of uncollected mushrooms in an area before boars pause digging. Set to 0 to disable.
NearbyScanRadius	8.0	Radius in meters to scan for uncollected mushrooms around the boar.

Audio & Visuals

Setting	Default	Description
SpawnDirtParticles	true	Spawn dirt puffs when rooting.
PlayDigSound	true	Play earthy digging sound effects when rooting.
ShowHeartEffect	false	Display a gentle heart/contentment puff when a mushroom is uncovered.

---

Installation

Manual Installation

1. Ensure BepInExPack Valheim is installed.
2. Download the latest TruffleBoars-x.x.x.zip release.
3. Extract the contents and move TruffleBoars.dll into your Valheim/BepInEx/plugins/ directory.

Mod Manager Installation

Install via r2modman or Thunderstore Mod Manager with one click.

---

Compatibility

• 100% compatible with Ashlands and Bog Witch updates.
• Fully compatible with other tame and animal mods (AllTameable, PetBoars, Farmyard, etc.).
• Safe to add or remove mid-playthrough.

---

Author & Support

Crafted with love by Jubaroo. Enjoy your pastoral Viking truffle-hunting adventures!