Plugin:Shops

QuickShop
Server	Economy plugin  —  on Survival
Main command	/shop
Sub commands	17
Access
Requirements	Any rank
Custom	Yes (Fork)

QuickShop, or simply Shops, is an economy plugin supported within the Survival server on Prism Party. QuickShop allow players to create shops out of barrels, chests, and shulker boxes to trade items with others on the server using Gems. Outside of Auctions, shops are the primary means by which players trade items via the economy on Prism Party.

All players on Prism Party are able to create container shops so long as they can afford the ₲100 shop-creation fee. There are no Levels or Rank requirements, nor quantity limits to consider. Still, players are advised to be at least Level 1 prior to making shops as Bolt is used to protect shop containers from theft and is not available to all players until the first level up.

Barring temporary worlds, players are able to create shops anywhere they have permission to build. Thus, it it common to find collections of shops in player-made markets scattered throughout the world. These self-made markets are often accessible using the Player Warps plugin on the server, or by using the integrated /finditem command.

Outside of player-made markets in The Overworld, there exists a large collection of player shops within the Shopping District in Spawnia. The Shopping District is the premier location for player shops on the Survival server and is where a vast majority of shops and markets can be found. While all players are allowed to shop at the Shopping District, only those Level 5 or higher may open a store there.

QuickShop is a core plugin on Prism Party. Generally speaking, this means that the network can't update unless this plugin is also updated and working. Bugs impacting this plugin are considered severe.

Features

• Buy or sell items to other players to collect revenue
• Split shop earnings equally amongst trusted users
• Globally search for items sold by shops all over the world
• Preview items before purchase
• Sell or purchase items in bulk
• View transaction history at shops

Using shops

Trading

Left click or Right click the sign of a shop. Enter into chat the quantity of items you'd like to trade. Be mindful of shops trading items in bulk; In this case, enter how many bulks you'd like to trade.

Direct trading

⇧ Shift+Left click the sign of a shop. The items will be sold directly without confirmation. Only works for shops buying items off players.

Shop control

Left click the container of a shop you manage to open the control panel for it. Here you can modify various aspects such as buy/sell mode, stack size, and price.

Inventory

Right click the container of a shop you manage to open the inventory of the shop. This is the same as opening a container in vanilla Minecraft. Ensure your chest is locked to prevent players from doing the same.

Commands

[Square brackets] indicate optional parameters, while <angle brackets> indicate required parameters.

Create shop

/shop create <price>

Create a shop at the block you're looking at. You must be holding the item you wish to sell in your hand (including the quantity of items to sell per transaction. Price must be an integer between 1 and 25,000. Shops must be locked to prevent players from stealing inventory.

Valid blocks

Barrel

The preferred shop block.

Chests

Any chest, including double-chests, but excluding ender chests.

Shulker Boxes

Any Shulker Box color.

Remove shop

/shop remove

Remove the shop you're looking at.

Change mode

/shop <buy|sell>

Change a shop to either sell items to players or buy items from players.

Modes

Sell

The default mode of newly-created shops. Shops in sell mode will sell items to players and display "Buy" on the shop sign.^{[See notes]} If the shop runs out of inventory, it will be deactivated.

Buy

Shops in buy mode will buy items from players and display "Sell" on the shop sign.^{[See notes]} If you run out of Gems, the shop will be deactivated.

Item quantity

/shop size [name]

Change how many items are sold in bulk per transaction. Not to be confused with /shop amount, which is used to purchase a specified number of items from a shop.

Change item

/shop item

Change the item being traded at a shop to the item in your hand. All other shop parameters will remain the same.

Modify price

/shop price <price>

Change the price at which items are traded for the shop you're looking at.

Suggest price

/shop suggestprice

Allow the plugin to determine a recommended price for your shop by calculating a median and average of all other shops selling similar items. This command will not change the price of your shop: it will only recommend a price. Use /shop price <price> to change the shop price.

Set permissions

/shop permission user <set|unset> <player> <permission>

Change permissions for a player at the shop you're looking at. Note that access to the physical shop inventory is managed by Bolt and Claims.

Permissions

Administrator

Players with quickshop-hikari.administrator will be able to control all aspects of a shop, including giving access to this shop to other users. This level of access is required to use this command. By default, only the shop creator has this level of access.

Staff

Players with quickshop-hikari.staff will be able to control most aspects of a shop (such as shop price, item quantities, and sell mode), but will be unable to modify permissions for others. Same as running /shop staff add <name> and related commands.

Everyone

Players with quickshop-hikari.everyone will be able to trade with the shop, but do nothing else. This is the default access level for all players at your shop; It is unnecessary to set this permission for users.

Blocked

Players with quickshop-hikari.blocked will be barred from trading or interacting with your shop altogether.

Manage beneficiaries

/shop benefit <add|remove|query> <player> <percentage>

Add a player to a shop as a beneficiary and split a percentage of your earnings with them.

Transfer shop(s)

/shop transferownership <name>

Transfer ownership of the shop you're looking at to the specified player. The other player must run /shop transferownership accept to complete the transfer. Once complete, you will no longer have authority over the shop. This action cannot be undone.

/shop transferall <name>

Transfer ownership of all your shops specified player. The other player must run /shop transferall accept to complete the transfer. Once complete, you will no longer have authority over any of your shops. This action cannot be undone.

Change sign

/shop sign <material>

Change the wood-type used by the sign for the shop you're looking at. Defaults to spruce sign.

Toggle display

/shop toggledisplay

Toggle on or off the floating item above shops. By default, this display is shown. If you wish to stack your shops vertically, setting this to off is recommended to improve performance.

Toggle searchable

/shop finditem <hideshop|revealshop> <item name>

Hide or show your shop in the global search. All active shops are included in the search by default.

View notifications

/shop fetchmessage

View unread shop transaction notifications.

Shop name

/shop name [name]

Change the name of a shop you are looking at. This name is not shown to players and is instead only useful for self-organization. When a named shop runs out of inventory, you will be informed specifically of which shop has run out. Leave the name parameter blank to unset a name.

Search shops

/shop finditem <buy|sell> <item name>

Search all active shops on the server trading the specified item. Buy and sell in this context refer to the action you as the shopper will be performing at a given shop. Shops are automatically sorted by price. Clicking on a shop will teleport you to that shop.

Trade amount

/shop amount <number>

The number of items you wish to trade at a specific shop. This is to be used when you initiate a trade with a shop as an alternative to typing the number into chat. This command is not used to set the number of items to be traded per transaction as a shop owner. (/shop size)

Some commands shown in the in-game help menu are disabled on Prism Party and thus are not included on this page.

Notes

• Be mindful of the text shown on shop signs. The text on the sign indicates the action the player is performing by interacting with the shop.
  • This behavior is opposite to shop administrative commands that are from the perspective of the shop itself. For instance, a shop in "sell" mode (selling items to the player) would display "buy" on the shop sign since that is the action players are performing at that shop.
• Shops are not protected by the plugin. Instead, players must use Bolt or Claims to lock their shop containers from theft.
  • This is true even for shops created in the Shopping District.
• A single shop cannot both sell and buy items. However, a double-chest can host two shops that both sell and purchase items from players in order to accomplish this.
• Players can create shops out of barrels, chests, trapped chests, or any shulker box variant.
  • Barrels are preferred.

Gallery

• 

  An example of a shop that sells and buys items

• 

  A collection of shops at IvarEXE's pwarp

• 

  The shop search menu

• 

  The shop information screen in chat