Shops

Welcome to "shopping district" on discord (:

Shops update was major update for our bot, Pickle Rick. This update and its commands are designed to help you as player set up stores and communicate to other players what items you're currently selling. This way, people can see what's for sale, even if the store owner isn't online!

Let's proceed with the commands:

Commands

Store Categories

GET !storecategories OR !categories OR !cat

Shows different categories that most Minecraft Items are listed under.

Path Parameters

Name	Type	Description
!storecategories	string	Initial command

200 Shows different categories that most Minecraft Items are listed under.

Item Categories
Showing all item categories for the Store Listings
Mechanism
Usable
Plant
Wood
Manufactured Block
Decoration
Ore/Mineral
Raw Materials
Stone
Interactable
Food
Utility
Weapons
Tools
Dyes
Manufactured Item
Mineral Block
Liquid
Vehicles
Informational
Fungus
Lighting
Armor
Soil
Fauna


@ Hydro Vanilla SMP

500 Returns nothing.

Category Items

GET !categoryitem OR !cati <category>

Shows the different items that are under a category. You'll use these terms for "items" in the following commands.

Path Parameters

Name	Type	Description
!categoryitem	string	Initial command

Query Parameters

Name	Type	Description
category	string	Category you want to see

200 Shows the different items that are under a category, e.g. Ore/Mineral.

Items in the Ore/Mineral Category
Ore/Mineral 1
Amethyst Cluster
Ancient Debris
Coal Ore
Copper Ore
Deepslate Coal Ore
Deepslate Coral Ore
Deepslate Diamond Ore
Deepslate Emerald Ore
Deepslate Gold Ore
Deepslate Iron Ore
Deepslate Lapis Lazuli Ore
Deepslate Redstone Ore
Diamond Ore
Emerald Ore
Gold Ore
Iron Ore
Lapis Lazuli Ore
Nether Gold Ore
Nether Quartz Ore
Redstone Ore


@ Hydro Vanilla SMP

404 Wrong category.

I'm not sure what you're trying to lookup. Try another search term.

406 Missing Required Argument.

You have to state the Category you want to see Items in.

500 Returnes nothing.

Store Item Lookup

GET !storeitemlookup OR !itemlookup OR !slookup <item>

Displays all the stores that are currently selling that specific item. It will list how many items they're selling of what type for what price.

Path Parameters

Name	Type	Description
!storeitemlookup	string	Initial command

Query Parameters

Name	Type	Description
item	string	Find selling items

200

302 No one is currently selling any items with such name.

No one is currently selling any Apples.

404 Wrong item.

Did you mean to look up "Apple"? Try running this command: !storeitemlookup "Apple"

OR

I'm not sure what you're trying to lookup. Try another search term.

406 Missing Required Argument.

Make sure to either have either a one word search term, or enclose your search term in quotations, like this:
!itemlookup "search term"

500 No response.

Stores

GET !stores

Shows a list of all the registered stores in the server.

Path Parameters

Name	Type	Description
!stores	string	Initial Command

200 Shows a list of all registered stores in the server.

List of Stores
Showing all Stores for the Stores Category
TestingStore


@ Hydro Vanilla SMP

302 There's no stores registered.

List of Stores
Showing all Stores for the Stores Category
There's no stores registered!


@ Hydro Vanilla SMP

500 No response

Store

GET !store <@USER OR storename>

Shows all items that are being sold by that store, or by the store owner you specified.

Path Parameters

Name	Type	Description
!store	string	Initial command

Query Parameters

Name	Type	Description
@USER OR storename	string	Find store

200

302 Store currently doesn't sell any items.

The TestingStore store currently does not have any items for sale.

500 No response.

Store Register

POST !storeregister OR !sreg <storename> <location:optional>

Registeres a new store that you are an owner of. Use Location to help people find where your store is.

Path Parameters

Name	Type	Description
!storeregister	string	Initial command

Request Body

Name	Type	Description
storename	string	Your store name
location	string	Store location

200

Store Unregister

DELETE !storeunregister OR !sunreg

Deletes your store, removes any members of that store, and deletes all items your store was selling at the time.

Path Parameters

Name	Type	Description
!storeunregister	string	Initial command

200

Store Add Member

PATCH !storeaddmember OR !saddm <@USER>

Adds a member to your store that can add or remove items that your store is selling.

Path Parameters

Name	Type	Description
!storeaddmember	string	Initial command

Request Body

Name	Type	Description
@USER	string	Member you want to add

200

Store Remove Member

DELETE !storeremovemember OR !storeremm OR !storeremmember <@USER>

Removes a member of your store.

Path Parameters

Name	Type	Description
!storeremovemember	string	Initial Command

Query Parameters

Name	Type	Description
@USER	string	Member you want to remove

200

Store Edit

PUT !storeedit OR !sedit <storename> <item> <quantity> <price> <description:optional>

Adds or edits item entries for your store. Quantity is how much you're selling per purchase.

Path Parameters

Name	Type	Description
!storeedit	string	Initial command

Query Parameters

Name	Type	Description
storename	string	Store you want to add items to

Request Body

Name	Type	Description
quantity	integer	How many items you're selling
price	integer	How much you want to be paid for selling
currency	string	What currency are you selling your items in
descritpion	string	Briefly describe what you're selling

200

Store Remove

DELETE !storeremove OR !sr <storename> <item>

Removes an item from your store

Path Parameters

Name	Type	Description
!storeremove	string	Inital command

Query Parameters

Name	Type	Description
storename	string	Store you want to remove items from
item	string	Item you want to remove from store

200