Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
Valheim Donations
Valcoin donation economy for dedicated servers: Ko-fi/PayPal/Patreon/PayMongo donations become in-game currency, spendable in a configurable shop. F4 Donation Codex + F8 quick panel for players who also run the plugin client-side.
| Last updated | 9 hours ago |
| Total downloads | 5 |
| Total rating | 0 |
| Categories | Mods Misc AI Generated |
| Dependency string | TaegukGaming-Valheim_Donations-5.1.0 |
| Dependants | 1 other package depends on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2333
ValheimModding-JsonDotNET
Shared version 13.0.3 of Json.NET from Newtonsoft, net45 package for use in Valheim mods. Maintained by the ValheimModding team.
Preferred version: 13.0.4README
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
/donatein-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. /giftlets players transfer Valcoins to each other;/topdonorsshows 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
- Install this mod on your dedicated server.
- Deploy the companion FastAPI backend (see the GitHub repo — deploys to Fly.io in a few commands).
- Launch the server once. It writes a template
BepInEx/config/valcoin_config.json— fill inbackend_urlandplugin_tokenfrom your backend deploy, then restart. - Edit
BepInEx/config/valcoin_shop.yamlto set your shop catalog (also auto-templated on first run). - (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.
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
