Server Update The New Shop

This is a preliminary list of commands that will become available when the shop goes online.
This page will update with new content when the shop comes up, currently this page is just to familiarize yourselves with the new command syntax.

Basic Commands:

/shop tutorial

- Display the tutorial

/shop help

- Display a help message (context sensitive)

/shop list [<pagesize>] [-highlow|-lowhigh]

- Lists items in shop

/shop [search] <name|id>[:<data>] [<amount>] [-highlow|-lowhigh]

- Searches for a given item

/shop info <name|id>[:<data>] [<amount>] [-highlow|-lowhigh]

- Brings up a list of items that meet the criteria for your information search

/shop toggle <autocomplete>

- Toggles different shop parameters, changing functionality of the shop. These parameters are persistent through restarts.

autocomplete: toggles the ability to skip the /shop select <index> command when purchasing or selling items. Will pick the most relevant result to complete the transaction.

Purchasing/Selling Commands:

/shop buy <name|id>[:<data>] [<amount>] [-highlow|-lowhigh]

- Brings up a list of items that meet the criteria for your purchase

/shop sell <name|id>[:<data>] [<amount>] [-highlow|-lowhigh]

- Brings up a list of items that meet the criteria for your sale

Navigation Commands:

/shop select <index>

- Selects the item related to the commands /shop [buy/sell/info] and either displays relevant information or completes a shop transaction.

/shop page <page>

- Navigates to a given page

/shop next

- Navigates to the next page

/shop prev

- Navigates to the previous page

/shop cancel

- Cancels any current action

Admin Commands:

/shop add [-h] [<parameters>]

- Adds an item to the shop

/shop remove <index>

- Removes an item from the shop

/shop modify <index> [-h] [<parameters>]

- Modifies an item in the shop

/shop lookup <player> [<parameters>]

- Looks up a player's transaction history

NOTE: Any shop query may contain quotations around the item name to set the query into "precision mode", in which a transaction will complete automatically if only one result is obtained. Furthermore, it'll only show results that match the input exactly (IE. they must be equivalent).
NOTE: An object in < > brackets represents a parameter. An object surrounded by [ ] brackets are optional parameters. Brackets with an | symbol within them means that any of the parameter types within those brackets will work.

Example:

<name>

- This would take a "name" as a parameter, so if it's an item, you'd type in the item name (No spaces)

[<name>]

- This is an OPTIONAL "name" parameter. It is not required for the command to work

<name|id>

- This is a parameter that accepts two types, a name or an id. If it was an item, it would accept the item name or item id.

EDIT BY TIMS: You CAN still purchase items in only one command. Use

/shop buy "gold" 5

To buy 5 gold bars. There will be no confirmation screen, and we will not refund any mistakes you make using this. The confirmation screen is there to derp-proof the /shop, and using quotation marks is there to enable power users to still buy/sell using only one command.

There are two options, and they're totally dependent on what we do on our side. Now any type of wool is just considered "wool", so if you were to type /shop buy wool, it would list all the variations of wool that we have in the shop. But they'll be listed as Wool[D:<data>] where <data> is the data value of the wool (or, in other words, the color of the wool) and that would require you to know the data value for the color you want.

However, if we add an alias to the wool (another name basically) and say we alias Wool[D:6] to be RedWool or something, then type /shop buy RedWool would work...

It sounds complicated, but it's not really.

Here is an example of the shop interface when you're searching for wool. These are the different wool types.

Request: Aliasing data values and enchantment names.Wool[D:Blue] is more helpful than Wool[D:3], as is DiamondSword[E:Bane of Arthropods IV] vs DiamondSword[E:remember_that_game_at_chuck_e_cheese_where_you_step_on_the_spiders_well_this_is_kind_of_like_that].

You can alias an item name, not item data or item enchantments. Just give an item you want an alias like "RedWool" and it'll show up as Redwool[D:6] and as for enchantments, you can use the alias feature to name the item based on the enchants. Otherwise it'll just show something like DiamondSword[E] (it does not describe what the enchantments are unless you request /shop info on the item.

That hadn't occured to me. IN MY DEFENCE. THAT WAS POSTED IN THE SHORT SPAN I WAS DEAD DURING LOL. >_>

Just a quick update, I'm going to try to have it ready for today, but I've decided to restructure some of the code so that'll take more testing time. If I don't get it out by this evening, then look towards the end of the week for a release.

Depending on what time I get home and whether any issues arise, the new shop should be live around 6:30PST.

Which part is unintuitive or hard to understand?