BountyHunter

Bounty Hunter Contract

Adds a server-managed player assassination contract system. Players can put a price on other players' heads, offer real items as rewards, decide how many hunters may participate, and set how long the target must survive. The server is responsible for storing the contract, the reward, the bond, the participants, the timer, and the final result.

• You can find me on our Valheim server's Discord. My name is Azathothreborn in OdinPlus.

Features

• Buildable contract board
• Players can publish contracts against other connected players.
• The reward is taken directly from the inventory when the contract is created.
• The creator can choose the target, reward, duration, and maximum number of hunters.
• The contract timer only advances while the target is connected.
• Hunters can accept or leave active contracts.
• The target can eliminate hunters and win the reward.
• Participants are forced to use PvP while the contract remains active.
• Rewards and bonds are claimed from the board when the contract ends.

How it works

An administrator must place the contract board in the world. By default, only administrators can build it, but any player can use a board that has already been placed.

To publish a contract:

• Open the board.
• Select a player as the target.
• Choose an item from your inventory as the reward.
• Enter the number of items you want to deposit.
• Set the maximum number of hunters.
• Choose the contract duration.
• Deposit the reward and the required bond.

Once published, other players can join as hunters.

The contract can end when:

• A hunter eliminates the target.
• The target eliminates all available hunters.
• The contract timer expires.
• The creator cancels the contract.
• An administrator removes it.

The exact result depends on the server configuration.

Rewards and bonds

The reward is stored by the server when the contract is published. A new copy of the item is not created.

Administrators can also block specific items through their prefab.

In addition to the reward, the creator must pay a coin bond. It is returned when the contract ends normally.

When the creator cancels a contract:

• If nobody had accepted it, the creator recovers the reward and the bond.
• If hunters had already joined, the creator recovers the reward, but the bond is distributed among the accepted hunters.

Timer

The duration is calculated using only the time the target remains connected.

For example, a 24-hour contract requires 24 actual accumulated hours of the target being connected. When the target disconnects, the timer pauses.

Administrators can also allow permanent contracts with no expiration date.

PvP Behavior

The target and active hunters are forced to have PvP enabled while participating in a contract.

Installation

Install the mod using a Valheim-compatible mod manager or place its files inside:

BepInEx/plugins

Configuration

Open the file:

BepInEx/config/Azathoth.BountyHunterContract.cfg

You can also modify it in-game using a mod such as Configuration Manager. Options locked by the server can only be changed by an administrator.

[1 - General]

Locks synchronized options so they can only be modified by administrators.

Lock Configuration = On

[2 - Contracts]

Maximum number of units that can be deposited as a reward.

Maximum Reward Item Amount = 1000000

Prefabs that cannot be used as rewards.

Separate them with commas, semicolons, or line breaks.

Prohibited Reward Prefabs =

Maximum number of open contracts per creator.

Maximum Open Contracts Per Creator = 5

Required bond in Coins.

Cancellation Bond Coins = 100

Default duration shown on the board, expressed in minutes.

Default Contract Duration Minutes = 1440

Minimum allowed duration.

Minimum Contract Duration Minutes = 10

Maximum allowed duration.

Maximum Contract Duration Minutes = 10080

Allows using 0 minutes to create permanent contracts.

Allow Permanent Contracts = Off

Allows the target to win the reward by defeating all hunters.

Ta