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.
¶ Basics
This Sell contract issued by Zaify is offering 64 Steel Ingots and 32 Gunpowder, in exchange for $150 total.
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.
- In a Buy contract, the contractor must deliver items to the issuer's town, in exchange for money.
- In a Sell contract, the issuer offers to sell items that the contractor must purchase and collect from the town.
Each contract has an expiration date that it must be completed by. After this date, the contract will be deleted.
¶ Issuing
CREATION: Contracts can be created by using /contracts create (contract type) (expiry time of contract, in hours).
This Buy contract issued by Zaify is asking for 128 Nether Stars to be delivered to London, in exchange for $1000 total.
Contract Types:
- A
buycontract means you want to buy items from other players. The items must be delivered to your town. - A
sellcontract 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.
- You must collect the delivered items from a completed Buy contract before it expires.
- Unsold items from an expired Sell contract can be reclaimed using
/contracts reclaim. - The maximum time you can set for a contract to be available is 168 hours (7 days).
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).
¶ Editing Buy Contracts
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).
- This is the amount of money taken from your balance when submitting the contract. It will be returned if the contract is manually deleted before expiration or completion.
¶ Editing Sell Contracts
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).
- These are the items taken from your inventory when submitting the contract. They will be returned to your inventory if the contract is manually deleted before expiration or completion.
2. The price that the items will be sold for. Set their bulk price through /contracts edit (contract ID) price (money amount).
¶ Optional: Availability
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.
- If you want only a specific player to sign your contract, use
/contracts edit (contract ID) availability individual (player name). - If you want only players of a specific town to be able to sign your contract, use
/contracts edit (contract ID) availability town (name of town). - If you want only players of a specific nation to be able to sign your contract, use
/contracts edit (contract ID) availability nation (name of nation).
¶ Optional: Collateral
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.
- A high collateral encourages the contractor to complete the contract, but it may discourage less wealthy players from signing it.
By default, a contract's collateral is $0. Your contract's collateral can be changed through /contracts edit (contract ID) collateral (money amount).
¶ Optional: Town
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.
¶ Deletion
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.
¶ Contracting
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.
¶ Completing Sell Contracts
In order to complete a Sell contract: the contractor must:
- sign the contract using
/contracts sign (contract ID) - travel to the issuer's town, and type
/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.
¶ Completing Buy Contracts
DELIVERY: In order to complete a Buy contract, the contractor must deliver all requested items to the issuer's town. To deliver items,
- sign the contract using
/contracts sign (contract ID) - Place them in your inventory, stand in the issuer's town, and type
/contracts deliver (contract ID). Any requested items will be removed from your inventory (delivery may happen multiple times). - Once all requested items have been delivered, both the contract's money reward, and any collateral that was withdrawn from your balance when you signed the contract, will be added back to your balance.
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!
¶ Final Notice
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.