ChestShop: Difference between revisions
More actions
Initial content |
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 | |||
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 | |||
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 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. | ||
* | * 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
- Place a chest where you want your shop.
- Place a sign on the chest (or on a block adjacent to it).
- 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
- Admin shop — the server-run fallback shop
- Item worth — item pricing tooltips
- Simulated ChestShop — the simulated buyer
- Getting started — includes a shop setup walkthrough
- Commands — full command reference