Trade Contracts (or simply “Contracts”) are formal, server-enforced and secure agreements between two players, that allow them to exchange items and money without requiring both to be online.
The person who creates a contract is called its issuer, while the person who chooses to sign and complete the contract is called its contractor. Each contract has a town where the contractor must travel to in order to complete the contract. This is always the town of the issuer at the time that the contract was made.
Each contract has an expiration date that it must be completed by. After this date, the contract will be deleted.
CREATION: Contracts can be created by using /contracts create (contract type) (expiry time of contract, in hours)
.
Contract Types:
buy
contract means you want to buy items from other players. The items must be delivered to your town.sell
contract means you want to sell items to other players. The items must be collected from your town.After the expiry time has passed, the contract is immediately terminated and deleted.
/contracts reclaim
.Each contract created also has an ID code attached to it. This ID is required for managing the contract. The contract creation message will display your contract's ID.
EDITING: Once a contract has been created, the issuer must edit its details, by using the /contracts edit
command.
SUBMITTING: Once editing has been finalised, the contract must be submitted to the Contracts List, the main menu to look for contracts. Submit your edited contract by typing /contracts submit (contract ID)
. After a contract has been submitted, it is available for contractors to sign (accept the offer) and complete (fulfill the offer).
Buy contracts must specify:
1. The items that you want to buy. Add items into your contract through /contracts edit (contract ID) additem (item name) (amount of items)
.
2. The amount of money that will be awarded to the contractor after the items are delivered. Set their bulk price through /contracts edit (contract ID) reward (money amount)
.
Sell contracts must specify:
1. The items that will be sold. Add items into your contract through /contracts edit (contract ID) additem (name of item) (amount of items)
.
2. The price that the items will be sold for. Set their bulk price through /contracts edit (contract ID) price (money amount)
.
All contracts are public by default. Anyone in the server can sign public contracts and become their contractor. However, you can restrict the level of a contract's availability to certain players in the server only.
/contracts edit (contract ID) availability individual (player name)
./contracts edit (contract ID) availability town (name of town)
./contracts edit (contract ID) availability nation (name of nation)
.
All contracts can specify a collateral. This amount of money is withdrawn by the server from the contractor's balance, immediately after signing a contract that includes a collateral. After the contract is signed, the collateral is only returned to the contractor if the contract has either been successfully completed or deleted before it expires.
By default, a contract's collateral is $0. Your contract's collateral can be changed through /contracts edit (contract ID) collateral (money amount)
.
Buy contracts can change the town that the items must be delivered to and collected from using /contracts edit (contract ID) settown (town name)
. If this is not set, the contract will use the town you are currently a resident of.
Contracts are automatically deleted after their expiration time passes. If a contract expires, all items and money placed into it will disappear from the server.
Your active contracts can be manually deleted through /contracts delete (contract ID)
. If a contract is manually deleted, all items and money placed into it are refunded to the issuers and contractors.
The list of contracts and their details can be viewed through the Contracts List menu, opened through /contracts list
. In addition, you can use the command /contracts info (contract ID)
to view a specific contract's details in chat.
If you would like to sign a contract in order to fulfill it in the near future, type /contracts sign (contract ID)
. If the contract includes a collateral, this amount of money will be withdrawn by the server from your balance, and returned to you if the contract is completed or manually deleted by the issuer before it expires.
In order to complete a Sell contract: the contractor must:
/contracts sign (contract ID)
/contracts collect (contract ID)
The price of the sold items will be taken from the contractor's balance, placed in the issuer's balance, and the items will be placed in your inventory. Make sure you have enough inventory space for the items.
DELIVERY: In order to complete a Buy contract, the contractor must deliver all requested items to the issuer's town. To deliver items,
/contracts sign (contract ID)
/contracts deliver (contract ID)
. Any requested items will be removed from your inventory (delivery may happen multiple times).COLLECTION: The items have to be collected into the issuer's inventory, after the Buy contract is completed. To collect the delivered items, stand inside your town's claims, and type /contracts collect (contract ID)
. Make sure to collect the items before your contract expires, or the items will be lost!
Issuers' towns are only valid in their contract at the moment of the contract's creation. If the issuer changes towns, the contract is still valid only for the town they were in at the moment of creation.