Pebble

Report a bug or buy us a coffee at dfgaming.net.

Pebble

Meet Pebble, a buildable Artificer standing in your camp who trades, banks, and hands out upgrades. Talk to him with E and a Norse Obsidian & Antique Gold trading panel opens: shops for the things you cannot farm, a shared coin vault that keeps your carry weight down, and carry-weight upgrades you buy with the coin you just banked.

A Valheim BepInEx 5 plugin built on Jotunn.

Features

• A buildable Artificer — place him from the Hammer under the DFG category. An animated miniature Stone Golem that turns to face you and plays a talk animation when you are close.
• Pebble Bank — a server-wide shared treasury. Coins you deposit stop weighing you down at 0.1 kg each, and shop and upgrade purchases draw from it automatically, so you never have to ferry a chest of coins back from a raid.
• Carry-weight upgrades — the Lift-Harness utility belt adds +100 to +600 kg by quality, with a configurable sprint and jump stamina saving once you are loaded up.
• Backpack expansion — up to nine inventory rows, using the engine's own Player.SetInventorySize rather than a reimplementation of the grid.
• Rare Curios — boss offerings and rare catalysts that are otherwise miserable to farm.
• Sell Goods — a searchable catalogue of everything Pebble buys, with Quick Sell All Treasures and bundle sales.
• Potions & Meads, Provisions, and Bounties for monster trophies.
• A live web editor at
• Speaks. Dialogue with audio, drawn from pebble_dialog.json, including idle lines while you stand nearby.

Requirements

• BepInExPack Valheim
• Jotunn (2.30.x)
• Valheim 1.0.16+

Installation

• Install through your mod manager (recommended).
• Manual: place Pebble.dll, pebble_model.glb, pebble_dialog.json and audio\ into BepInEx\plugins\Pebble\.

The GLB is the Artificer's model and is required — Pebble will not appear without it.

How to Use

• Open your Hammer and build Pebble (DFG category): 20 Stone, 10 Bronze Nails, 1 Surtling Core, 4 Copper.
• Press E to talk. The header shows Pocket: N g | Bank: N g, so you always know what you are carrying against what you have banked.
• Deposit coins into the Pebble Bank to cut your carried weight, then spend from the vault directly.
• Open to tune prices, categories and stock.

The panel

| Tab | What it is for |

|---|---|

| 📦 PackGolem | Backpack rows and the Lift-Harness carry-weight belt. |

| 💎 Rare Curios | Boss offerings, rare catalysts, and Sounder tuning. |

| 💰 Sell Goods | Searchable buy-list, with Quick Sell All Treasures and bundles. |

| 🏦 Pebble Bank | Deposits, withdrawals, and where shop purchases draw from. |

| 🧪 Potions | Healing, stamina and resistance meads. |

| 🎣 Provisions | Early fishing rod and bait, mining and survival sundries. |

| 📜 Bounties | Monster trophies for coins and bonus materials. |

| 📡 Sounder | Only if Ominous is installed. Live sounder status, biome matrix, and Artificer Biome Attunement upgrades. |

Configuration

com.dfg.pebble.cfg, four sections:

• 1 - General — Enabled, DebugLogging, EnableWebGui, WebPort (default 8789).
• 2 - Workshop Piece — PieceName, NpcScale, build costs, CleanupStrayGolems, CleanupRadius.
• 3 - PackGolem — PackUpgradesEnabled, MaxInventoryRows, LiftBeltEnabled, BeltWeightT1 … BeltWeightT5, BeltStaminaReduction.
• 4 - Wares — per-tab toggles for Rare Curios, Sell Goods, Potions, Provisions and Bounties.

Pricing and bank data live in pebble_pricing.json and pebble_bank.json under BepInEx\config\.

Extending it

Other mods can add a tab to the panel:

PebbleAPI.RegisterTab("My Tab", () => { / draw your IMGUI here / });

Registered tabs appear after the built-in ones and are drawn through your own callback.

Notes and limitations

• Pebble is a real, persistent world object — he is saved with your world, and moving base means he does not come with you.
• Versions up to 1.0.0 could leave full-sized hostile Stone Golems in your save. Pebble now sweeps them on