Plugin:Shops

QuickShop
Server	Economy plugin  —  on Survival
Main command	/shop
Sub commands	21
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.

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.

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.

View notifications

/shop fetchmessage

View unread shop transaction notifications.

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.

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.

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.

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.

Modify price

/shop price <price>

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

Change sign

/shop sign <material>

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

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.

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.
  • Shops created in the Shopping District are automatically protected.
• 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