Plugin:Shops: Difference between revisions

QuickShop
QuickShop
Server	Economy plugin — on Survival
Main command	/shop
Sub commands	21
Access
Requirements	Any rank
Custom	Yes (Fork)
External sites Internal resources Survival/Spawn/Shopping_District;

Revision as of 03:36, 1 September 2024

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[edit]

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[edit]

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[edit]

Examples[edit]

Notes[edit]

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[edit]

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

@@ Line 137: / Line 137: @@
 |port     = {{Item|yellow_candle}}
 |title    = '''Staff'''
-|subtitle = Players with {{Copy|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.
+|subtitle = Players with {{Copy|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 {{CMD|shop staff add <name>}} and related commands.
 }}
 {{Component
-|port     = {{Item|cyan_candle}}
+|port     = {{Item|lime_candle}}
 |title    = '''Everyone'''
 |subtitle = Players with {{Copy|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.
@@ Line 164: / Line 164: @@
 |label1 = /shop name [name]
 |list1  = 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.
+}}
+{{Navplate
+|title = Item quantity
+|label1 = /shop size [name]
+|list1  = Change how many items are sold in bulk per transaction. Not to be confused with {{CMD|shop amount}}, which is used to purchase a specified number of items from a shop.
+}}
+{{Navplate
+|title = Suggest price
+|label1 = /shop suggestprice
+|list1  = 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 {{CMD|shop price <price>}} to change the shop price.
+}}
+{{Navplate
+|title = Suggest price
+|label1 = /shop toggledisplay
+|list1  = 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.
+}}
+{{Navplate
+|title = Transfer shop(s)
+|label1 = /shop transferownership <name>
+|list1  = Transfer ownership of the shop you're looking at to the specified player. The other player must run {{CMD|shop transferownership accept}} to complete the transfer. Once complete, you will no longer have authority over the shop. '''This action cannot be undone.'''
+|label2 = /shop transferall <name>
+|list2  = Transfer ownership of ''all'' your shops specified player. The other player must run {{CMD|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.'''
 }}
@@ Line 175: / Line 197: @@
 |title = Trade amount
 |label1 = /shop amount <number>
-|list1  = 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.
+|list1  = 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. ({{CMD|shop size}})
 }}