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 http://127.0.0.1:8789/.
• 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

1. Install through your mod manager (recommended).
2. 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

1. Open your Hammer and build Pebble (DFG category): 20 Stone, 10 Bronze Nails, 1 Surtling Core, 4 Copper.
2. 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.
3. Deposit coins into the Pebble Bank to cut your carried weight, then spend from the vault directly.
4. Open http://127.0.0.1:8789/ 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 load: host-only, within CleanupRadius of a loaded Pebble, and only ZDOs you own. Strays near a Pebble that is not currently loaded are caught on a later visit, and the log says so when that happens. Turn it off with CleanupStrayGolems.
• The Sounder tab only appears when Ominous is installed. It is detected at runtime, so there is no version requirement between the two.
• The web editor listens on localhost only.

Support

If this mod has made your journey through the Tenth World a little better, consider tossing a coin into my Ko-fi jar: https://ko-fi.com/draugrforgedgaming. Your support keeps the forge hot and the mead flowing! Skål!