ValheimLoading...Valheim_Donations

Last Updated

First Uploaded

Downloads

Likes

Size

115KB

Dependency string

TaegukGaming-Valheim_Donations-5.1.0

Dependants

1 other mods

Mods Misc AI Generated

Download

Details Required (2)Wiki Changelog Versions Analysis

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

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 in backend_url and plugin_token from your backend deploy, then restart.
Edit BepInEx/config/valcoin_shop.yaml to 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.

🏰 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

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

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 in backend_url and plugin_token from your backend deploy, then restart.

Edit BepInEx/config/valcoin_shop.yaml to 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.

Disclaimer

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

Valheim Donations

Details

Categories

Valheim Donations

What it does

Quick setup

Documentation

Try it out

Disclaimer

Categories

Valheim Donations

What it does

Quick setup

Documentation

Try it out

Disclaimer

Categories