BountyForge

BountyForge Mod - README

This mod is actively maintained and will continue to receive improvements and optimizations. For issues or support or mod abuse in anyway, please reach out to Darreaninility#4118 on the VArena Discord or The Modding Community Discord (link usually found at V Rising Modding Wiki).

Description

BountyForge is a mod that introduces a player-driven bounty system and an engaging assassin contract mechanic to your server. It allows players to place bounties on others using configurable items, hunt down targets for rewards, and compete on a leaderboard. Additionally, the assassin contract system randomly assigns timed kill missions to players. The mod also features a clan betrayal system to prevent users for leaving clans to claim bounties. With BountyForge, you can:

• Enable players to place bounties on each other.
• Allow players to claim bounties by defeating their targets.
• Offer random, timed assassination contracts to players with specific kill objectives.
• Implement a "clan betrayal" cooldown, preventing players from immediately claiming bounties on or getting contract credit for killing recent former clanmates.
• Display map icons for players who have bounties on them.
• Maintain a leaderboard tracking the most successful bounty hunters.
• Customize all aspects of the bounty and contract systems through detailed configuration.

##TODO

• Make the text more attractive.

Features

Player-Placed Bounties

• Players can place bounties on others using a configurable item and amount (.addbounty).
• Successful kills on bountied targets reward the killer.

Assassin Contract System

• Randomly assigns timed assassination contracts to eligible online players.
• Contracts require eliminating a specified number of any other players within a time limit.
• Successful contract completion yields a configurable reward.
• Players can check their contract status (.contract).

Clan Betrayal Prevention

• When a player leaves a clan, a configurable cooldown period is initiated between the leaver and their former clanmates.
• During this cooldown, attempting to claim a bounty on a recent former clanmate will be voided.
• Killing a recent former clanmate will not count towards assassin contract progress.

Bounty Claiming & Self-Claim

• Bounties are typically claimed upon downing the target.
• Optional: Bountied players can "self-claim" their own bounty by achieving a configurable number of PvP kills while bountied.

Leaderboard

• Tracks total bounty values claimed by players (.bountytop).

Map Icons

• Displays a configurable map icon on players who have an active player-placed bounty on them.

Player Information Commands

• List all active player-placed bounties (.bountylist).
• Check personal bounty status and self-claim progress (.bountyme).
• Check current assassin contract status (.contract).

Configuration

• Extensive settings for payment items, minimum amounts, contract parameters, betrayal cooldown, feature toggles, and more via BountyForge.cfg.

Admin Commands

• Reload mod configuration (.reloadbountyforge).
• Clear map icons (.bfclearicons).

Commands

Note on Player Names: When using commands that require a player name, ensure you use their current in-game character name.

Admin-Only Commands:

• .reloadbountyforge: Reloads the BountyForge configuration and data from disk.
• .bfclearicons : Clears bounty map icons. Use "all" to attempt to clear all tracked icons, or a player's name to clear icons specifically for that player and perform a more aggressive scan for their icons.

Player-Accessible Commands:

• .addbounty (alias: .ab): Places a bounty of a specified amount on a player. Requires the configured payment item and amount in your inventory.
• .bountylist (alias: .bl): Lists all active player-placed bounties, ordered by reward amount.
• .bountyme: Shows your current bounty status (if you are a target), your self-claim progress, and your total bounty rewards claimed on the leaderboard.
• .contract (alias: .ac): Shows your current assassin contract status, including objective, progress, time remaining, and reward.
• .bountytop (alias: .bt): Displays the top bounty hunters by total bounty value claimed.

Configuration

All BountyForge configuration settings are located in the BepInEx/config/BountyForge.cfg file (created automatically after the first server run with the mod). Data files (like active bounties, contracts, and betrayal cache) are stored in BepInEx/config/BountyForge/Data/.

Key configuration sections in BountyForge.cfg:

• [General]:
• Enabled (true/false): Enable or disable the entire BountyForge mod.
• DebugLogging (true/false): Enable detailed debug logging. (Most BountyManager logging is now removed, but other parts might use this).
• [Bounty.Placement]:
• PaymentItemGUID (integer): Prefab GUID of the item used for bounty payments (e.g., Thistle).
• PaymentItemName (string): Display name for the payment item.
• MinimumBountyAmount (integer): The minimum amount required to place a bounty.
• [Bounty.Claiming]:
• ForbidPlacerReclaimingPayment (true/false): If true, the bounty placer does not get their items back if they kill their own target.
• EnableTargetSelfClaimViaKills (true/false): Allows bountied players to self-claim by getting kills.
• KillsForTargetSelfClaim (integer): Number of kills needed for self-claim.
• [Leaderboard]:
• TargetSelfClaimAddsToScore (true/false): If self-claims add to the leaderboard.
• PlacerReclaimAddsToScore (true/false): If placer reclaiming their bounty (if allowed) adds to their score.
• [MapIcons]:
• EnableMapIcons (true/false): Toggle m