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 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)
• DFGHub (DFG-DFGHub-1.4.2). Bounties and Pebble's vendor jobs are a tab on its board.
• 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

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!

Changelog

All notable changes to Pebble.

1.0.8

• Bounties are the Bounties tab on the DFG board. Turn in takes the goods and does not pay. Receive rewards pays. Repeatable bounties come back to Active. One-shot quests stay Completed.
• Pebble's vendor series is twenty stone jobs on that same tab, one at a time, from Skip to My Lou through the Master Mason's Geode. Each reward is coins plus one keepsake.
• DFGHub is required. The mod does not load without it.

1.0.5

Two fixes for installs where Pebble was not extracted into a folder named Pebble.

• Silent NPC. The dialog config and audio folder were resolved as BepInEx\plugins\Pebble\ rather than from the DLL's own location. A mod manager that extracts the package flat, or into a differently named folder, pointed the mod at a directory that did not exist — and startup then created an empty audio\ there, so every clip failed with "File not found in tracks folder" and Pebble said nothing. Both paths now resolve from the assembly location, and an unreferenced or empty audio set now logs a warning naming both paths instead of reporting 0 failed.
• Stone cutter icon in the Hammer menu. The piece is cloned from piece_stonecutter and inherited its icon, because Pebble shipped no icon of its own. pebble_icon.png is now part of the package and is applied to the piece.

1.0.4

First published build of Pebble. Everything below is in this release.

• Buildable Artificer workshop piece (DFG_PebbleWorkshop, cloned from piece_stonecutter) with an animated Stone Golem NPC that turns to face the player and blends a talk animation inside 6 m.
• Obsidian & Antique Gold trading panel opened with E, modelled on VikingVault, with eight tabs: PackGolem, Rare Curios, Sell Goods, Pebble Bank, Potions, Provisions, Bounties, and a conditional Sounder tab.
• Pebble Bank: server-wide shared coin treasury, 0.1 kg per coin, with deposits and withdrawals and direct purchase integration so shop and upgrade spending draws from vault funds without a second trip to the chest.
• Lift-Harness utility belt: +100 to +600 kg carry weight by quality, plus a configurable sprint and jump stamina reduction above 300 kg.
• Player inventory rows expanded from 5 up to 9 using the engine's native Player.SetInventorySize.
• Sell Goods catalogue with search, Quick Sell All Treasures and bundle sales; bundle pricing in pebble_pricing.json.
• Rare Curios, Potions & Meads, Provisions and Bounties wares, each independently toggleable.
• NPC dialogue with audio, from six Text/AudioFile arrays in pebble_dialog.json, including random idle lines while the player is nearby.
• Conditional 📡 Sounder tab, shown only when Ominous is installed, reporting live sounder status, beacon and radar ranges and the active/locked biome matrix, and selling Artificer Biome Attunement upgrades paid from pocket or bank.
• Live web GUI at http://127.0.0.1:8789/.
• PebbleAPI.RegisterTab lets other mods contribute their own tabs.
• Golems spawned by earlier builds could write themselves into world saves. The NPC clone's ZDO is now marked non-persistent, and a host-only sweep removes strays left near a loaded workshop on load.