Bukkit

THIS PAGE IS CURRENTLY OUTDATED, I SUGGEST WATCHING THE YOUTUBE VIDEO ON THE FRONT PAGE

Getting Started: Commands

/tm req | request NAME - Request a player to trade with you, must currently be within 10 blocks of them.
/tm acc | accept NAME - Accept a trade request from the given player.
/tm con | confirm - Used to toggle whether or not you have confirmed an offer.
/tm can | cancel - Cancels a trade.
/tm open - Reopens the trade window after closing.
/tm help PAGE# - Provides a (currently) brief overview of the commands and some information about the plugin's uses.

Getting Started: Requesting a Trade
Now that you know the commands, you can begin trading other players. There are a few things you should have in mind before trading, however. Firstly, you should know the name of the other player you're trading. Secondly, you must be within 10 blocks of the other player. If you meet those two conditions, proceed to use the /tm req | request command to request the other player. For example, I want to trade a player named Notch, and the range I'm within 10 blocks of them. Since I'm not too far away and I know the player's name, I can simply type /tm request Notch to request a trade with him.

Trading
Continuing from the example shown before, if I were Notch, all I would have to do is either type /tm acc | accept Koanga or perhaps wait out the request time so that it auto-declines. Let's assume that Notch did accept the request. Now we're faced with an interface like this:

The green wool blocks are the confirm buttons, upon clicking them they lock your offer in, and become blue. If you click them again, they become green again and you will unconfirm, thus unlocking, your offer. If the other player in the trade modifies their offer after you have confirmed your offer, your offer will automatically be un-confirmed as a safety measure.

The red wool blocks are the cancel blocks, they cancel the trade upon clicking them, instantly aborting anything done up to this point. WARNING: if your inventory becomes full and the items in the trade cannot be successfully returned to you, THEY WILL BE DROPPED. Ensure you have enough space to retrieve your items before cancelling.

The blue and orange areas outlined signify the offer windows. Each player is assigned one, and they can look at the chatlog to see which portion of the window is their own.

You can look at the window's title to determine which portion of the window is your own. You can only edit this portion, and any changes done to it are also shown to the other player (however, they cannot edit it). Note that if you ever close the trade and wander too far away (10 blocks) from the other player, it will automatically cancel to prevent the trade being used as extra inventory space. After putting in your items, all you have to do is click the green wool block, which will then become blue, and wait for the other player to do so as well. Once that is done, you'll have completed a trade! WARNING: If any person involved doesn't have enough inventory space to complete the trade (this even includes partial stacks of the same item), the items will be dropped on the ground! Ensure you have enough space in your inventory to accept the other player's offer.