Redeem

Redeem is a configurable reward redemption system developed exclusively for Valheim dedicated servers.
The mod does not create or use configuration files on the client.

Features

• Server-exclusive mod — all configuration files are created and read only on the server.
• Code-based reward system — players can redeem item packages using unique codes.
• Raffle system — administrators can run a random giveaway that awards a code to a connected player.

Usage

Standard Redemption

1. The administrator defines item packages in packages.yml and codes in codes.yml.
2. Players use the /redeem <CODE> chat command to claim rewards.
3. The server processes the code, safely delivers the items to the inventory, and marks the code as used.

Raffle System

1. The administrator runs the console command to start a raffle using a code from codes.yml.
2. All connected and eligible players are automatically entered into the raffle.
3. The winner receives a private and persistent message with the awarded code.
4. The code remains saved on the character even after logout and can be viewed at any time via command.
5. Important: unclaimed raffle codes:
   • expire automatically after the configured timeout period, if timeout is enabled;
   • or are reset when the server restarts, if timeout is disabled.

Configuration

• ServerSync — automatically synchronizes mod settings between the server and clients.
• AllowAdmins — controls whether administrators can participate in raffles.
• PendingCodeTimeoutMinutes — defines the time (in minutes) before a pending raffle code expires.
  • If set to 0, pending codes are reset when the server restarts.

Commands

Player Commands

Admin Commands (console)

Installation (manual)

1. Place the Redeem.dll file into the BepInEx\plugins\ folder on both client and server.
2. On first launch, the mod will automatically create the configuration folder on the server only.

Changelog