PrisonerExchange

PrisonerExchange

A V Rising plugin made to enable trading and swapping prisoners between clans, without the hassle of manually transferring them.

Features

• Sell a prisoner to another user or clan.
• Swap a prisoner for another with a user or clan.
• Set a custom PrefabGUID as currency for handling sales.
• Announce completed prisoner sales in global chat
• Set a minimum/maximum sale price as a global limit.
• Customizable command cooldown for selling/swapping prisoners.
• Automatic expiration of sale and swap offers.

Commands

Staff Commands

-.pe clear Clear all active prisoner exchanges between users.

-.pe remove (username) Remove any sale/swap request involving a specified user.

-.pe removecooldown (username) Removes command cooldown on specified user.

Sale commands

-.pe sell (username) (price) Sends a sale offer to the specified username.

-.pe cancelsale Cancel outgoing sale offer.

-.pe acceptsale Accept incoming sale offer.

-.pe declinesale Decline incoming sale offer.

Swap commands

-.pe swap (username) Initiate a trade with another user (prisoner for prisoner).

-.pe cancelswap Cancel outgoing swap offer.

-.pe acceptswap Accept incoming swap offer.

-.pe declineswap Decline incoming swap offer.

Usage

Selling a prisoner

• Stand right in front of the prison cell holding the prisoner you would like to sell.
• Type.pe sell (username) (price)
• If you regret sending the offer, you can type.pe cancelsale to cancel the offer.
• The request is sent to the specified user with information about the trade (prisoner type, blood and price and who is selling it).
• The receiving user can now type.pe acceptsale while standing next to an empty prison cell.
• If the receiving user would like to decline they can type.pe declinesale or simply wait for it to expire.
• If the user has enough currency, the sale will conclude and the currency will be transferred from the buyers inventory into yours.

Swapping a prisoner

• Stand right in front of the prison cell holding the prisoner you would like to swap.
• Type.pe swap (username)
• A list of the users prisoners will appear in chat.
• You will be prompted to select a number representing the prisoner you want to swap for.
• Once the number has been selected, the offer will be sent to the receiving user.
• If you regret sending the offer, you can type.pe cancelswap to cancel the offer.
• The receiving user can type.pe acceptswap or.pe declineswap to conclude the swap.
• Once concluded the prisoners will switch places and be assigned to the same cage you started the swap from.

Configuration

The config file is automatically generated under the server install directory as \BepInEx\config\PrisonerExchange.cfg

Sample configuration

Allow admins to bypass restrictions on selling/swapping prisoners.

Setting type: Boolean

Default value: true

AdminBypass = true

Enable or disable the ability to sell prisoners.

Setting type: Boolean

Default value: true

SellingEnabled = true

Enable or disable the ability to swap prisoners.

Setting type: Boolean

Default value: true

SwappingEnabled = true

Announce completed sales in global chat.

Setting type: Boolean

Default value: true

AnnounceExchange = true

Prefab GUID for the currency. (Crystals by default)

Setting type: String

Default value: -257494203

CurrencyPrefab = -257494203

Name of currency.

Setting type: String

Default value: Crystals

CurrencyName = Crystals

Set the minimum amount of currency required for a sale.

Setting type: Int32

Default value: 100

MinimumSalePrice = 100

Set the maximum amount of currency allowed for a sale.

Setting type: Int32

Default value: 5000

MaximumSalePrice = 5000

Only allow clan leader to sell prisoners.

Setting type: Boolean

Default value: false

ClanLeaderOnly = false

Adds a fixed cooldown period for selling/swapping prisoners (minutes).

Setting type: Int32

Default value: 5

CommandCoolDownPeriod = 5

Automatically expire sales and swap requests. (seconds)

Setting type: Int32

Default value: 60

Expi