Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

ChestShop: Difference between revisions

From Prosperity SMP Wiki
Initial content
 
VxMac (talk | contribs)
Add Item worth pricing reference + tips
 
Line 2: Line 2:


== Creating a shop ==
== Creating a shop ==
# Place a chest where you want your shop.
# Place a chest where you want your shop.
# Place a sign on the chest (or on a block adjacent to it).
# Place a sign on the chest (or on a block adjacent to it).
Line 25: Line 26:


=== Examples ===
=== Examples ===
A sign reading:
A sign reading:
  (your name)
  (your name)
  64
  64
  B 500
  B 500
  Diamond
  Diamond
This sells 64 diamonds to customers for 00 per transaction.
 
This sells 64 diamonds to customers for $500 per transaction.


A sign reading:
A sign reading:
  (your name)
  (your name)
  16
  16
  B 200:S 100
  B 200:S 100
  Iron Ingot
  Iron Ingot
This sells 16 iron ingots for 00, or buys 16 from customers for 00.
 
This sells 16 iron ingots for $200, or buys 16 from customers for $100.
 
== Setting prices ==
 
Hover over an item in your inventory to see the [[Item worth]] tooltip. The ''Market Est'' line shows the engine's estimate of the item's fair player-market value, which is a useful reference for pricing your ChestShop signs. The ''Admin Sell'' line shows what the admin shop pays — you generally want to charge more than that.
 
You can also run <code>/market <item></code> to see recent real player-trade data for the item, if any exists.


== Item names ==
== Item names ==
The sign has a character limit. For long item names, use the short alias. Common aliases:
{| class="wikitable"
|-
! Full name !! Alias
|-
| Iron Ingot || <code>Iron Ingot</code>
|-
| Gold Ingot || <code>Gold Ingot</code>
|-
| Diamond || <code>Diamond</code>
|-
| Cobblestone || <code>Cobblestone</code>
|-
| Oak Log || <code>Oak Log</code>
|}


If the item name does not fit, check the alias list at the shop help board near spawn or ask staff.
The sign has a 15-character limit per line. For long item names, use the short alias. Examples include splash potion variants (mapped to <code>Strength II</code>, <code>Fire Res 8:00</code>, etc.). Check the alias board near spawn or ask staff if your item name does not fit.


== Finding shops ==
== Finding shops ==
Run <code>/find <item></code> to search for player shops selling or buying a specific item. Results show the shop owner, price, location, and stock.
Run <code>/find <item></code> to search for player shops selling or buying a specific item. Results show the shop owner, price, location, and stock.


== Chest locking ==
== Chest locking ==
All chests are automatically locked by [[BOLT]]. Only the chest owner can access the contents. The shop sign allows customers to interact with the buy/sell interface without opening the chest.
All chests are automatically locked by [[BOLT]]. Only the chest owner can access the contents. The shop sign allows customers to interact with the buy/sell interface without opening the chest.


== Tips ==
== Tips ==
* Stock your chest before creating the sign — an empty shop cannot sell.
* Stock your chest before creating the sign — an empty shop cannot sell.
* Check <code>/market <item></code> to see the going rate before setting prices.
* Use [[Item worth]] tooltips or <code>/market <item></code> to see going rates before setting prices.
* Place shops in the market district for maximum visibility.
* Place shops in the market district for maximum visibility.
* Shops work while you are offline.
* Shops work while you are offline.
* The [[Simulated ChestShop]] may buy from your shop in the background at any time, with no required setup on your part.


== See also ==
== See also ==
* [[Admin shop]] — the server-run fallback shop
* [[Admin shop]] — the server-run fallback shop
* [[Item worth]] — item pricing tooltips
* [[Simulated ChestShop]] — the simulated buyer
* [[Getting started]] — includes a shop setup walkthrough
* [[Getting started]] — includes a shop setup walkthrough
* [[Commands]] — full command reference
* [[Commands]] — full command reference


[[Category:Plugins]]
[[Category:Plugins]]

Latest revision as of 03:11, 29 May 2026

ChestShop is the player-owned shop system on Prosperity SMP. Players create buy and sell signs on chests to trade items with other players. All shops in the market district use this system.

Creating a shop

  1. Place a chest where you want your shop.
  2. Place a sign on the chest (or on a block adjacent to it).
  3. Write the following on the sign:
Line What to write Example
1 Leave blank (your name fills in automatically)
2 Quantity per transaction 64
3 Price: B for buy, S for sell, or both B 100:S 50
4 Item name Diamond
Buy price (B)
The amount a customer pays you to buy items from your chest.
Sell price (S)
The amount you pay a customer when they sell items to your chest.

Examples

A sign reading:

(your name)
64
B 500
Diamond

This sells 64 diamonds to customers for $500 per transaction.

A sign reading:

(your name)
16
B 200:S 100
Iron Ingot

This sells 16 iron ingots for $200, or buys 16 from customers for $100.

Setting prices

Hover over an item in your inventory to see the Item worth tooltip. The Market Est line shows the engine's estimate of the item's fair player-market value, which is a useful reference for pricing your ChestShop signs. The Admin Sell line shows what the admin shop pays — you generally want to charge more than that.

You can also run /market <item> to see recent real player-trade data for the item, if any exists.

Item names

The sign has a 15-character limit per line. For long item names, use the short alias. Examples include splash potion variants (mapped to Strength II, Fire Res 8:00, etc.). Check the alias board near spawn or ask staff if your item name does not fit.

Finding shops

Run /find <item> to search for player shops selling or buying a specific item. Results show the shop owner, price, location, and stock.

Chest locking

All chests are automatically locked by BOLT. Only the chest owner can access the contents. The shop sign allows customers to interact with the buy/sell interface without opening the chest.

Tips

  • Stock your chest before creating the sign — an empty shop cannot sell.
  • Use Item worth tooltips or /market <item> to see going rates before setting prices.
  • Place shops in the market district for maximum visibility.
  • Shops work while you are offline.
  • The Simulated ChestShop may buy from your shop in the background at any time, with no required setup on your part.

See also