Confirm with your password

Valheim Donations

Valcoin donation economy for dedicated servers: Ko-fi/Patreon/PayMongo donations become in-game currency, spendable in a configurable shop via one panel (F4, or the inventory-screen Donations button). Needs the plugin client-side; no chat commands.

Client & Server Currency Valheim 1.0
Install with Gale
Changelog & versions
Stats Source Decompile

· 💗 Donate

Stars
0
Downloads
37
Version
5.24.0
Updated
Author
TaegukGaming
Virus scan
✓ Scan successful
Runs on
Client & Server
Required by
1 mods

Compatibility

Required 1

Install these too — Gale pulls them in for you.

Description

Valheim Donations

Lets Valheim players donate via Ko-fi, Patreon, or PayMongo and get Valcoins credited in-game automatically, redeemable in a configurable in-game shop for perks and weekly-limited consumables. Requires the plugin installed on both server and client — donations happen entirely through an in-game panel, not chat commands.

What it does

  • One in-game panel, opened with F4 — a browsable, offline-resilient home for donating, the shop, gifting, and the patron leaderboard, that lights up automatically once the server's donation backend comes online. All actions (donate, buy, gift, admin give/remove) happen here, over a silent RPC — nothing is typed into public chat.
  • Simple donate flow — click one button to get your code, copy it, and open the donation portal in your browser; your Valcoins credit automatically. The tab leads with a clear $1 USD = N Valcoins rate (served by your backend, so it always matches what donations actually credit).
  • Any of three providers (Ko-fi, Patreon, PayMongo) can be wired up independently; each webhook verifies its own signature and credits Valcoins automatically within seconds.
  • A configurable shop (valcoin_shop.yaml) sells:
    • Soulkeeper Charm (add_charges) — death insurance: on death you keep your skills (no drain) and a Valkyrie carries you back to your tombstone, scattering nearby creatures on arrival. Capped at 10 charges per player per week.
    • Familiars (armor_vfx) — a miniature flying creature (Bat, Ghost, Deathsquito, Drake, Wraith, Volture, Gjall, Fallen Valkyrie) hovers at your shoulder, bound to your equipped helmet. Grants feather fall and a small flat attack bonus. Other players see it too. Move yours by editing BepInEx/config/valcoin_familiars.yaml — one block per familiar, left/right, height, front/back — and it repositions within a second, in-game, no re-equip. Your view only.
    • Weekly-capped, boss-gated consumables (grant_item) — feasts, meads, and bulk materials spawned directly into the buyer's inventory server-side.
  • Preview images — give any shop item a picture via preview_image (an https URL or a file in BepInEx/config). It shows as a thumbnail in the shop row, larger in the purchase-confirm dialog, and clicking either opens a full-size view.
  • Earn Valcoins by playing (optional, needs ValheimServerGuide) — a one-time welcome quest worth 30 Valcoins that introduces the donation system, plus daily quests (hunt, tame, fell a Biome Lord, bond with a Dvergr companion) capped at 8 per day with a 7-day streak bonus. Quest earnings never appear on the Top Patrons board, and the cap keeps them a taster rather than a substitute for donating.
  • Gift Valcoins to other players from the panel; a built-in Top Patrons leaderboard shows lifetime donors.
  • Admin tab (admin-only) to manually give/remove a player's balance.

Quick setup

  1. Install this mod on your dedicated server AND every player's client — the client copy is required, not optional; there's no chat-command fallback for un-modded players.
  2. Deploy the companion FastAPI backend (see the GitHub repo — deploys to Fly.io in a few commands).
  3. Launch the server once. It writes a template BepInEx/config/valcoin_config.json — fill in backend_url and plugin_token from your backend deploy, then restart.
  4. Edit BepInEx/config/valcoin_shop.yaml to set your shop catalog (also auto-templated on first run).
  5. List admin Steam64 IDs in BepInEx/config/valcoin_admins.yaml to unlock the panel's Admin tab for them.
  6. (Optional — quests.) If you run ValheimServerGuide, copy guidance.valcoin-quests.yaml from the repo into the server's BepInEx/config/ValheimServerGuide/. Payouts are priced in BepInEx/config/valcoin_quests.yaml, auto-templated on first run. Needs backend 0.7.0+.

That's the minimum. Everything else — provider webhooks, weekly-capped consumables — is documented in the repo.

Documentation

Full setup, provider configuration, and shop schema are in the GitHub repo docs.

Try it out

This mod was built for the TaegukGaming community server running the Hearthbound modpack.

🏰 Hearthbound Valheim Modpack

Disclaimer

This mod is created using AI. No other mods were copied during the process. All feature ideas come from the uploader and are mainly to cater the needs of the TaegukGaming community server. If any features or ideas look similar to other mods, these are not intentional.

This mod is free to use as is. Voluntary support is appreciated.

Version: 5.24.0 Source / issues: https://github.com/yesu0725/valheim-donations-plugin Backend (required, self-hosted): https://github.com/yesu0725/valheim-donations-backend

Changelog

5.24.0 Latest
  • The donation panel fits on screen at every GUI scale. If you play with the GUI scale above 100% (or on a high-resolution monitor), the Donate tab's text grew but the panel did not, and the bottom of the tab -- your donation code, the Copy code and Open donation portal buttons -- was cut off below the frame. The panel now grows with the game's own UI, and the Donate tab is laid out in two columns like the crafting menu: the explanation on the left, your code and its buttons on the right. Nothing scrolls, and the font size is unchanged.

Client-side only. Server operators can update at their leisure; no configuration changes.

5.23.1

  • Valheim 1.0 support. On 1.0 the familiar name on your helmet ("Bronze Helmet of the Bat") stopped appearing, because the game changed the method that builds item tooltips. Everything else kept working -- the familiar itself, its perks, purchases, quests and donations were never affected -- but the name is back. Every other place this mod hooks into the game was re-checked against 1.0 and is unchanged.

  • Requires the current BepInEx pack. The dependency now points at BepInExPack Valheim 5.4.2350, which is the version that runs on Valheim 1.0. If you update this mod by hand rather than through a mod manager, update that pack too.

Update your client and your server. No configuration changes.

5.23.0
  • You can move your familiar. A new BepInEx/config/valcoin_familiars.yaml sets where each familiar hovers -- left/right, height, front/back -- with a separate block per familiar. Save the file and it moves within a second, in-game, without re-equipping your helmet, so you can nudge a number and watch it settle. It ships with the positions familiars already had, so it changes nothing until you edit it, and any familiar you delete from the file just keeps its default. This is your own view only -- it does not change what anyone else sees, and it has nothing to do with prices or Valcoins.

Includes 5.22.4 and 5.22.3 below.

27 older entries, full version history & downloads →

Files

5 files · 179 KB download

Loading files…

Manual download
Just this mod One .zip — Valheim Donations 5.24.0
Files you'll get 2
  • Valheim Donations 5.24.0 TaegukGaming this mod Get
  • JsonDotNET 13.0.4 ValheimModding Get

Your browser may ask permission to download several files at once. How to install these manually
Manual installation instructions
1

Install BepInExPack Valheim

BepInExPack Valheim is required to run mods in Valheim.

Download BepInExPack Valheim 5.4.2360 · View mod page

Check out the mod page for detailed installation instructions.

2

Install Valheim Donations

This mod must be installed on both the client and the server.

Download Valheim Donations 5.24.0

Extract the ZIP and place the file(s) into the BepInEx/plugins/ folder inside your Valheim game folder.