Valheim Donations

Lets Valheim players (vanilla or modded) donate via Ko-fi, PayPal, Patreon, or PayMongo and get Valcoins credited in-game automatically, redeemable in a configurable in-game shop for perks and weekly-limited consumables.

What it does

• /donate in-game mints a short-lived claim code and DMs the player a portal link — no account creation, no chat-typed emails.
• Any of four providers (Ko-fi, PayPal, 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 cosmetic perks (grant_perk), stackable charges (add_charges), or weekly-capped, boss-gated consumable items (grant_item) — spawned directly into the buyer's inventory, so it works for vanilla clients too.
• /gift lets players transfer Valcoins to each other; /topdonors shows the lifetime leaderboard.
• Works without the client plugin. All commands are intercepted server-side via chat, so un-modded players get the full feature set.
• Optional client UI (same DLL installed client-side) adds an F8 quick panel and an F4 Donation Codex — a browsable, offline-resilient home for the economy, shop, and patron leaderboard that lights up automatically once the server's donation backend comes online.

Quick setup

1. Install this mod on your dedicated server.
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. (Optional) Install this same mod on player machines too, to unlock the F8/F4 in-game panels. Vanilla clients keep working via chat commands regardless.

That's the minimum. Everything else — provider webhooks, admin commands, 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.1.0 Source / issues: https://github.com/yesu0725/valheim-donations-plugin Backend (required, self-hosted): https://github.com/yesu0725/valheim-donations-backend

Changelog

5.1.0

• F8 panel now tracks live backend reachability, same as the F4 Codex: it polls periodically while open, flips an online/offline state on real fetch success/failure (not just "config has a URL"), and dims the Buy/Donate/Gift buttons while offline.
• Shop catalog now syncs to remote clients over RPC. Previously valcoin_shop.yaml only existed on whichever machine loaded it, so vanilla/remote clients connecting to a dedicated server saw an empty shop. The server now broadcasts its parsed catalog to every connected client every 30 seconds.

5.0.0

Initial public release.

• Valcoin economy: /donate, /coins, /shop, /buy, /gift, /topdonors, /title, plus admin /givecoins and /removecoins.
• Four donation providers: Ko-fi, PayPal, Patreon, PayMongo — each independently optional, verified via its own webhook signature.
• F4 Donation Codex: browsable, offline-resilient home for the economy, shop catalog, and patron leaderboard. Lights up automatically when the backend comes online — no client update needed.
• F8 quick panel: Donate / Shop / Gift / Top tabs for players who also run the plugin.
• Mouse-cursor fix for both panels — click and navigate with the mouse instead of hotkeys only.
• grant_item shop effect: weekly-capped, boss-gated consumable items (hard-to-cook food, meads, rare materials) spawned directly into the buyer's inventory — works for vanilla clients too.
• Vanilla-client compatible: every command works via chat even without the plugin installed client-side.