Prosperity SMP Wiki - User contributions [en]

Main Page

2026-05-30T02:29:56Z

VxMac: Add Dungeons to nav + Hunter row

Welcome to the official wiki for '''Prosperity SMP''', a Minecraft survival economy server running Paper 1.21.8.

== Getting started ==
New to the server? Read the [[Getting started|new player guide]] to learn how to join, pick a job, and earn your first paycheck.

* '''Server address:''' <code>play.prosperitysmp.com</code>
* '''Bedrock port:''' <code>19132</code>
* '''Version:''' Paper 1.21.8 (Java + Bedrock cross-play)

== Quick links ==
{| class="wikitable" style="width:100%;"
|-
! style="width:33%;" | Gameplay
! style="width:34%;" | Progression
! style="width:33%;" | Reference
|-
|
* [[Getting started]]
* [[Jobs]]
* [[Dungeons]]
* [[Economy]]
* [[Trading]]
* [[Auction house]]
* [[Direct trading]]
* [[Contracts]]
* [[Real estate]]
* [[Resource world]]
|
* [[Skill trees]]
* [[Prestige]]
* [[Drills and harvesters]]
* [[Master Smith]]
* [[Crates]]
* [[Titles]]
* [[Stipends]]
|
* [[Server rules]]
* [[Commands]]
* [[Frequently asked questions|FAQ]]
* [[Zoning regulations]]
* [[Lore]]
|}

== Jobs ==
{| class="wikitable" style="width:100%;"
|-
! Job !! Pays for !! Key unlocks
|-
| [[Miner]] || Stone, ores, deepslate || [[Drills and harvesters|Drills]], [[Master Smith]] upgrades
|-
| [[Farmer]] || Crops || [[Drills and harvesters|Harvesters]], auto-replant
|-
| [[Builder]] || Placing blocks || [[Contracts|Civic contracts]]
|-
| [[Woodcutter]] || Logs || Tree-felling upgrades
|-
| [[Hunter]] || Hostile mobs || [[Dungeons]], ranks E-S, combat gear
|-
| [[Fisherman]] || Fish || Rod enchants, rare-fish perks
|}

== Plugins ==
{| class="wikitable" style="width:100%;"
|-
! Plugin !! Purpose
|-
| [[ChestShop]] || Player-owned shops
|-
| [[Simulated ChestShop]] || Automated market activity engine
|-
| [[Admin shop]] || Server shop (<code>/shop</code>)
|-
| [[Essentials]] || Homes, teleportation, mail
|-
| [[BOLT]] || Chest and door locking
|-
| [[Simple Voice Chat]] || Proximity voice (Java mod)
|-
| [[CoreProtect]] || Block inspection
|-
| [[Plot rental]] || Land rental (ARM)
|-
| [[Bedrock setup]] || Bedrock Edition connection
|}

== Community ==
* [https://discord.gg/prosperitysmp Discord server]
* [[Lore]] — world history

Hunter

2026-05-30T02:29:56Z

VxMac: Hunter rework: E-S ranks + dungeon focus

{{Notice|The Hunter career is being reworked into the server's dungeon-clearing path. Ranks and the first dungeon are live; per-kill dungeon experience and the full [[Skill trees|skill tree]] are still rolling out.}}

The '''Hunter''' is one of six [[Jobs|jobs]] on Prosperity SMP and the server's combat career. Hunters earn wages by killing hostile mobs and progress by clearing [[Dungeons|dungeons]]. A Hunter's job level sets their '''rank''', from E up to S, which determines the dungeons they can take on.

== Joining ==
Run <code>/jobs join hunter</code> or select Hunter from <code>/jobs browse</code>.

== Ranks ==
The Hunter's job-level tiers are shown as ranks. Your displayed title is your current rank:

{| class="wikitable"
|-
! Hunter level !! Rank
|-
| 1 || E-Rank Hunter
|-
| 10 || D-Rank Hunter
|-
| 20 || C-Rank Hunter
|-
| 30 || B-Rank Hunter
|-
| 40 || A-Rank Hunter
|-
| 50 || S-Rank Hunter
|}

Ranking up is the core of the Hunter path: higher ranks unlock harder, more rewarding [[Dungeons|dungeons]]. You raise your rank by earning Hunter job experience — from hunting hostile mobs out in the world and from clearing dungeons.

== Dungeons ==
Hunter is the career built around [[Dungeons|dungeons]] — instanced boss challenges run solo or with a party. Clearing one awards a cash bounty, a loot crate, and Hunter experience toward your next rank. See the [[Dungeons]] page for how to enter and what to expect.

== Pay rates ==
Hunters earn approximately $0.50 per hostile mob killed. Pay varies slightly by mob type, with stronger mobs paying more.

== Stipends ==
Hunters have a 10% chance per kill to receive 2 arrows as a [[Stipends|stipend]] drop.

== Prestige ==
The Hunter prestige tool is a bow with Power V, Infinity, and Unbreaking V. See [[Prestige]] for costs.

== See also ==
* [[Dungeons]] — the dungeon system
* [[Jobs]] — overview of all jobs
* [[Skill trees]] — Hunter skill tree nodes
* [[Stipends]] — bonus item drops
* [[Titles]] — title progression

[[Category:Jobs]]

Dungeons

2026-05-30T02:29:55Z

VxMac: Create Dungeons page (MythicDungeons system, ranks, rewards)

'''Dungeons''' are instanced player-versus-environment challenges on Prosperity SMP. One to four players enter a private copy of a dungeon, fight through custom monsters, defeat a boss, and earn rewards. Dungeons are the focus of the [[Hunter]] career and are graded by Hunter rank.

== Entering a dungeon ==
Dungeons are launched from the dungeon entrance near spawn. Right-click a dungeon sign there to begin (admins can also use <code>/md play</code>).

* '''Solo:''' you are sent straight into your own private instance.
* '''Party:''' the [[#Parties|party]] leader starts the dungeon, each member confirms with <code>/ready</code>, and the whole group enters a shared instance together.

Dungeons work for both Java and Bedrock players.

== Ranks ==
Dungeons are graded from '''E''' (easiest) to '''S''' (hardest), matching the [[Hunter]] rank system. Your Hunter rank is set by your Hunter job level:

{| class="wikitable"
|-
! Rank !! Hunter level
|-
| E || 1
|-
| D || 10
|-
| C || 20
|-
| B || 30
|-
| A || 40
|-
| S || 50
|}

Higher-rank dungeons have tougher monsters and richer rewards. Leveling the Hunter job raises your rank and opens harder content. The '''E-rank''' dungeon is open now, with further ranks rolling out over time.

== Parties ==
To run a dungeon as a group:
# Form a party with <code>/party invite <player></code>; invited players accept with <code>/party join <leader></code> or by clicking the chat prompt.
# The party leader starts the dungeon.
# Each member confirms with <code>/ready</code>; once everyone is ready, the party is teleported in together.

Up to four players can share a single dungeon instance.

== Rewards ==
Defeating a dungeon's boss rewards every participating player with:
* a '''cash bounty''',
* a '''loot crate''' (opened normally — no key needed), and
* '''[[Hunter]] experience''' toward your next rank.

Monsters inside also drop materials. Reward payouts have a short cooldown, so dungeons are repeatable — though the wear your gear takes is the real cost of farming them.

== Coming prepared ==
Dungeons are a serious fight. Bring full armor, a good weapon, plenty of food, and golden apples, and expect your equipment to take heavy durability damage on a full run. Death in a dungeon is a setback, so play carefully.

== The first dungeon ==
The opening E-rank dungeon winds down through a flooded, abandoned mine and opens into a vast stone hall, where '''The Deepwarden''' — an ancient stone guardian — awakens. It calls reinforcements, slams the ground with a telegraphed shockwave, and turns more dangerous below half health. A solo player in full diamond gear can clear it with some effort; a party makes it smoother.

== Tips ==
* Rooms wake as you enter them — clear the monsters before pushing on.
* Watch for the boss's slam wind-up and step out of the impact zone.
* Skeletal archers are dangerous at range — close in or break line of sight.
* Carry spare gear or repair materials; a full clear is hard on your equipment.

== See also ==
* [[Hunter]] — the dungeon-clearing career and rank system
* [[Jobs]] — all six careers
* [[Crates]] — the loot crates dungeons award
* [[Getting started]] — new-player guide

[[Category:Gameplay]]

Main Page

2026-05-29T22:05:58Z

VxMac: Add Auction house + Direct trading to gameplay nav

Welcome to the official wiki for '''Prosperity SMP''', a Minecraft survival economy server running Paper 1.21.8.

== Getting started ==
New to the server? Read the [[Getting started|new player guide]] to learn how to join, pick a job, and earn your first paycheck.

* '''Server address:''' <code>play.prosperitysmp.com</code>
* '''Bedrock port:''' <code>19132</code>
* '''Version:''' Paper 1.21.8 (Java + Bedrock cross-play)

== Quick links ==
{| class="wikitable" style="width:100%;"
|-
! style="width:33%;" | Gameplay
! style="width:34%;" | Progression
! style="width:33%;" | Reference
|-
|
* [[Getting started]]
* [[Jobs]]
* [[Economy]]
* [[Trading]]
* [[Auction house]]
* [[Direct trading]]
* [[Contracts]]
* [[Real estate]]
* [[Resource world]]
|
* [[Skill trees]]
* [[Prestige]]
* [[Drills and harvesters]]
* [[Master Smith]]
* [[Crates]]
* [[Titles]]
* [[Stipends]]
|
* [[Server rules]]
* [[Commands]]
* [[Frequently asked questions|FAQ]]
* [[Zoning regulations]]
* [[Lore]]
|}

== Jobs ==
{| class="wikitable" style="width:100%;"
|-
! Job !! Pays for !! Key unlocks
|-
| [[Miner]] || Stone, ores, deepslate || [[Drills and harvesters|Drills]], [[Master Smith]] upgrades
|-
| [[Farmer]] || Crops || [[Drills and harvesters|Harvesters]], auto-replant
|-
| [[Builder]] || Placing blocks || [[Contracts|Civic contracts]]
|-
| [[Woodcutter]] || Logs || Tree-felling upgrades
|-
| [[Hunter]] || Hostile mobs || Dungeon access, combat gear
|-
| [[Fisherman]] || Fish || Rod enchants, rare-fish perks
|}

== Plugins ==
{| class="wikitable" style="width:100%;"
|-
! Plugin !! Purpose
|-
| [[ChestShop]] || Player-owned shops
|-
| [[Simulated ChestShop]] || Automated market activity engine
|-
| [[Admin shop]] || Server shop (<code>/shop</code>)
|-
| [[Essentials]] || Homes, teleportation, mail
|-
| [[BOLT]] || Chest and door locking
|-
| [[Simple Voice Chat]] || Proximity voice (Java mod)
|-
| [[CoreProtect]] || Block inspection
|-
| [[Plot rental]] || Land rental (ARM)
|-
| [[Bedrock setup]] || Bedrock Edition connection
|}

== Community ==
* [https://discord.gg/prosperitysmp Discord server]
* [[Lore]] — world history

Trading

2026-05-29T22:05:57Z

VxMac: Add direct trading + auction house methods; fix stale no-trade-window note

'''Trading''' on Prosperity SMP happens through several mechanisms. Player-to-player commerce drives the [[Economy|economy]], with the [[Admin shop]] serving as a guaranteed fallback.

== Trading methods ==

=== ChestShop signs ===
The primary trading method. Place a chest with a [[ChestShop]] sign to sell items to other players while online or offline. Shops in the market district get the most traffic. Best for high-volume, commonly traded commodities.

=== Direct trading ===
Run <code>/trade <player></code> to open a secure two-player [[Direct trading|trade window]]. Both players place items and cash, both confirm, and the exchange happens atomically — neither side can take the goods without giving up their own. Best for one-to-one deals, gifts, and high-value handoffs.

=== Auction house ===
Run <code>/ah</code> to open the [[Auction house]], a server-wide board of fixed-price listings. Sellers set a price and any player can buy; the item and cash change hands instantly. Best for one-off, high-value, or hard-to-display items such as enchanted gear and rare drops.

=== Admin shop ===
Run <code>/shop</code> to access the [[Admin shop]]. It offers guaranteed floor prices for common materials. Use it when no player shops are buying what you have.

=== Direct payment ===
Use <code>/pay <player> <amount></code> to send money directly. Useful for service payments or deals negotiated in chat. For trades involving items, prefer direct trading, which protects both sides.

== Price discovery ==
; /market command
: Run <code>/market <item></code> to see the median unit price based on recent player-to-player transactions across ChestShop and the auction house. This is the best indicator of what an item is actually worth.

; /find command
: Run <code>/find <item></code> to locate player shops currently selling or buying a specific item. Shows the shop owner, price, location, and current stock.

; Admin shop prices
: The [[Admin shop]] sets a floor. If <code>/market</code> shows a higher price than the admin shop, you can earn more by selling to players.

== Setting good prices ==
# Check <code>/market <item></code> before setting your [[ChestShop]] price or auction listing.
# Undercut existing sellers by a small margin to move inventory faster.
# For items with no market data, check the [[Admin shop]] price and mark up 20-50%.
# High-demand items (diamonds, iron, food) sell fastest in the market district.
# Niche items (decorative blocks, rare drops) sell slower but at higher margins, and often do best on the auction house.

== Supply and demand ==
Prices change based on player activity:
* When many players mine (supply up), ore prices tend to drop.
* When a new building project starts (demand up), building material prices rise.
* [[Contracts|Civic contracts]] create artificial demand for specific materials at fixed prices.
* The server's economic dashboard monitors these trends automatically.

== Trade safety ==
* All [[ChestShop]] transactions are logged by [[CoreProtect]].
* Scamming is prohibited under [[Server rules]]. Staff can verify transactions and issue refunds.
* [[BOLT]] protects your chest contents — only the shop interface is exposed to buyers.
* For secure item-and-cash swaps with another player, use [[Direct trading]]. It holds both offers and exchanges them atomically, so neither side can take the goods without paying.
* For fixed-price public sales, list items on the [[Auction house]], where the buyer's payment and your item change hands in a single instant transaction.

== See also ==
* [[Direct trading]] — secure two-player trade window
* [[Auction house]] — fixed-price marketplace
* [[ChestShop]] — how to create shop signs
* [[Admin shop]] — server-run fallback shop
* [[Economy]] — how money flows through the server
* [[Getting started]] — includes shop setup walkthrough

[[Category:Gameplay]]

Direct trading

2026-05-29T22:05:56Z

VxMac: Create Direct trading page (/trade secure swap window)

'''Direct trading''' lets two players swap items and cash in a single secure window. Both players place their offers, both confirm, and the exchange happens atomically — neither side can take the goods and run. It replaces the old "drop the items and trust the other player to <code>/pay</code>" method, which has cost players items in the past. Start a trade with <code>/trade <player></code>.

== Starting a trade ==

# Run <code>/trade <player></code> to send a request. The other player has 30 seconds to respond.
# The other player accepts by clicking '''[Accept]''' in chat, or by typing <code>/trade accept</code>. They can refuse with <code>/trade deny</code>.
# Once accepted, a shared trade window opens for both players.

Both players must be online, but there is '''no distance limit''' — you can trade across any world. Each player can be in only one trade at a time.

== The trade window ==

The window is split down the middle: your offer on the left, the other player's offer on the right. Both players see the same window, and it updates live as either side makes changes.

* '''Item slots:''' 12 per player. Shift-click an item from your inventory to add it to your side; click it in the window to take it back.
* '''Cash slot:''' click your cash slot, then type an amount in chat to add money to your side. Type <code>clear</code> to remove it.
* '''Ready button:''' click it when you are satisfied with both offers. It turns green.
* '''Cancel button:''' ends the trade at any time, with nothing changing hands.

Items and cash are only '''reserved''' while the window is open. They are not removed from your inventory until the trade completes, and a cancelled trade leaves everything exactly where it was.

== Confirming ==

Once '''both''' players have clicked Ready, a 3-second countdown begins. When it finishes, the swap executes: each player receives the other's offered items, and the cash is transferred.

To prevent last-second switches, '''any change to either offer resets both Ready buttons.''' If someone adds, removes, or alters an item — or changes the cash amount — both players must click Ready again. Either player can also un-ready during the countdown to stop the trade.

At execution, the server re-checks that both players are still online and still hold everything they offered. If anything is missing, the trade aborts and nothing is lost. Any items that do not fit in a player's inventory drop at their feet.

== Fees ==

Direct trading has '''no fee'''. The full amounts are exchanged exactly as offered.

== What transfers ==

All item data is preserved: enchantments, [[Master Smith|master tools]], armor trims, custom names, and durability all carry over unchanged. Cash moves through the server's economy ledger, so trades are visible to the economy systems, and high-value trades are logged for staff review.

== Bedrock players ==

Direct trading works on [[Bedrock setup|Bedrock Edition]]. The trade window is a standard chest menu rendered natively by Geyser. Because clickable chat links can be unreliable on Bedrock keyboards, the <code>/trade accept</code> and <code>/trade deny</code> commands are always available as a reliable alternative to clicking '''[Accept]'''.

== Commands ==

{| class="wikitable"
|-
! Command !! Effect
|-
| <code>/trade <player></code> || Send a trade request
|-
| <code>/trade accept</code> || Accept an incoming request
|-
| <code>/trade deny</code> || Decline an incoming request
|-
| <code>/trade cancel</code> || Cancel the trade you are currently in
|}

== Trade safety ==

Direct trading is the safest way to exchange items with another player one-on-one. Because the swap is atomic, there is no point at which one player holds both sides. Scamming through other means remains prohibited under the [[Server rules]], and trades are logged for staff review.

== See also ==

* [[Trading]] — overview of every way to trade on the server
* [[Auction house]] — fixed-price public marketplace
* [[ChestShop]] — player-owned shop signs
* [[Server rules]] — scamming and trade-fraud rules
* [[Commands]] — full command reference

[[Category:Gameplay]]

Auction house

2026-05-29T22:05:56Z

VxMac: Create Auction house page (/ah fixed-price marketplace)

'''The auction house''' is a server-wide marketplace where players list items at a fixed price for any other player to buy. It complements [[ChestShop]] signs: ChestShop is best for high-volume commodity trading, while the auction house suits one-off, high-value, or hard-to-display items such as enchanted gear, named tools, and rare drops. Open it with <code>/ah</code>.

Despite the name, the auction house is not a bidding system. Each listing has a single fixed price set by the seller, and the first buyer to pay that price receives the item.

== Listing an item ==

# Hold the item stack you want to sell.
# Run <code>/ah sell <price> [hours]</code> — for example, <code>/ah sell 1500 24</code>.
# The stack moves into the marketplace and becomes visible to everyone in <code>/ah</code>.

The price is the total asking price for the whole held stack. The optional <code>hours</code> value sets how long the listing stays up before it expires; it defaults to 24 hours and can be at most 72 hours.

=== Fees ===

A listing fee is charged the moment you list, and a sale cut is taken when the item sells:

* '''Listing fee:''' $5 plus 1% of the asking price, paid up front.
* '''Sale cut:''' 5% of the sale price, deducted from your proceeds at the time of sale.

The listing fee is '''not refunded''' if you cancel the listing or it expires. This deters listing spam, so set prices deliberately.

=== Limits ===

{| class="wikitable"
|-
! Limit !! Value
|-
| Active listings per player || 5
|-
| Minimum price || $1
|-
| Maximum price || $10,000,000
|-
| Default duration || 24 hours
|-
| Maximum duration || 72 hours
|}

== Browsing and buying ==

* <code>/ah</code> or <code>/ah browse [page]</code> opens the marketplace, showing 45 listings per page, newest first.
* <code>/ah search <query></code> filters listings by item name.
* Hovering over a listing shows its full details: quantity, price, time remaining, seller, and any enchantments or custom lore.
* Clicking a listing buys it immediately. The cash leaves your balance and the item is delivered to your inventory, or dropped at your feet if your inventory is full. There is no separate confirmation step, so click carefully.

== Managing your listings ==

; /ah me
: Shows your active listings. Shift-click a listing to cancel it. The item returns to your [[#Mailbox|mailbox]], and the listing fee is not refunded.
; /ah cancel <id>
: Cancels a specific listing by its ID — the same action as shift-clicking in <code>/ah me</code>.
; /ah history
: Shows your last 50 settled listings, both sold and expired.

== Mailbox ==

Run <code>/ah mailbox</code> to claim items that have come back to you: listings that expired with no buyer, or ones you cancelled. Click an item to collect it; if your inventory is full, it drops at your feet. Mailbox items '''never expire''', so nothing is lost by being offline.

Cash from a sale does not go to the mailbox. Sale proceeds — the sale price minus the 5% cut — are paid '''directly into your account balance''' the moment the item sells.

== Bedrock players ==

The auction house works on [[Bedrock setup|Bedrock Edition]]. The browse and mailbox screens are standard chest menus that Geyser renders natively, and every command behaves the same as on Java.

== Trade safety ==

* Buying is instant and atomic: the cash and the item change hands together, so there is no risk of paying without receiving the item.
* Every sale is recorded in the server transaction ledger and feeds the [[Consumer Price Index]], so auction prices appear in <code>/market</code> data.
* High-value sales are logged for staff review.

== See also ==

* [[Trading]] — overview of every way to trade on the server
* [[Direct trading]] — private, secure item-and-cash swaps between two players
* [[ChestShop]] — player-owned shop signs for bulk commodities
* [[Item worth]] — how the worth engine estimates fair prices
* [[Commands]] — full command reference

[[Category:Gameplay]]

Bedrock setup

2026-05-29T03:11:21Z

VxMac: Add ChestShop 15-char limit + account linking guidance

'''Bedrock Edition''' players can join Prosperity SMP through Geyser and Floodgate, which translate between Java and Bedrock protocols. All gameplay features work on both editions.

== Connection details ==

{| class="wikitable"
|-
! Setting !! Value
|-
| Server address || <code>play.prosperitysmp.com</code>
|-
| Port || <code>19132</code>
|}

=== From a console (Xbox, PlayStation, Switch) ===

Consoles cannot directly enter custom server addresses. Use one of these workarounds:

* '''BedrockConnect''' — a DNS-based redirect. Change your console's DNS settings to point to a BedrockConnect server, then select a ''Featured Server'' to enter the custom IP. See [https://bedrockconnect.net BedrockConnect.net] for instructions.
* '''Phantom''' — a local proxy that runs on a PC on your network and advertises the server to your console's LAN game list.

=== From mobile or Windows 10/11 ===

Open Minecraft Bedrock, go to ''Servers'' > ''Add Server'', enter the address and port above.

== Account linking ==

Bedrock players receive an automatically generated username with a <code>.</code> prefix (Floodgate format). The Bedrock Xbox Live account is linked to a server profile automatically on first join.

Bedrock players who also own a Java Edition account can optionally link their accounts so both clients access the same server profile, balance, and inventory. To link, connect to <code>link.geysermc.org</code> on one account and follow the prompts to generate a code, then connect on the other account and submit the code. '''Account linking should be done before accumulating data on the server''' — linking after a Bedrock player has built up balance, plots, or job levels may orphan that progress on the Bedrock profile.

== Known differences ==

{| class="wikitable"
|-
! Feature !! Java !! Bedrock
|-
| [[Simple Voice Chat]] || Supported (mod required) || Not available (use Discord)
|-
| Custom textures || Resource pack auto-loads || May require manual download
|-
| Inventory management || Standard || Slight UI differences
|-
| Command autocomplete || Full tab completion || Partial (depends on command)
|}

== ChestShop sign name limit ==

[[ChestShop]] signs cap owner names at '''15 characters'''. The Floodgate prefix (<code>.</code>) counts toward that limit, so Bedrock IGNs longer than 14 characters are truncated on the sign. The server's [[Simulated ChestShop]] internally resolves truncated names back to the full Floodgate UUID, so sales pay correctly regardless of the truncation.

If a Bedrock-owned shop is not paying correctly, report it on Discord and provide the owner's full IGN.

== Troubleshooting ==

; Cannot connect
: Verify the address is <code>play.prosperitysmp.com</code> and port is <code>19132</code>. Restart Minecraft if the server does not appear.

; Kicked for flying
: Bedrock movement packets sometimes trigger anti-fly detection. This is handled server-side — if you are kicked repeatedly, report it on Discord.

; Skin not showing
: Bedrock skins may not render for Java players. This is a Geyser limitation.

== See also ==

* [[Getting started]] — new player guide
* [[Frequently asked questions|FAQ]] — common issues
* [[Simple Voice Chat]] — voice chat (Java only)
* [[ChestShop]] — player-owned shop system

[[Category:Plugins]]

Simulated ChestShop

2026-05-29T03:11:21Z

VxMac: Add sale notification + bedrock support sections

The '''Simulated ChestShop''' is a custom-built automated market activity engine developed specifically for Prosperity SMP. Unlike off-the-shelf plugins, it was designed from scratch to integrate with the server's [[Consumer Price Index|CPI tracking]], [[Monetary policy engine|monetary policy engine]], and [[Economy|economic dashboard]]. It creates background buying activity at player-owned [[ChestShop]] signs, ensuring shops see traffic even during low-population hours.

== Purpose ==

At low player counts, player shops can sit idle for hours. This discourages players from setting up shops, which weakens the [[Economy|player-driven economy]]. The Simulated ChestShop solves this by having a server-managed bank account (CentralBank) purchase items from player shops at fair market prices.

The system '''only buys''' — it does not sell items to players. It is a pure liquidity injection from the CentralBank reserve into player hands.

== Custom development ==

The Simulated ChestShop was purpose-built as a Skript plugin (sim-chestshop.sk) rather than using an existing solution. This allows deep integration with the server's other custom systems:

* '''[[Consumer Price Index|CPI]] awareness''' — the system reads real market prices to determine fair buy values, and its own transactions are excluded from CPI calculations to prevent feedback loops.
* '''[[Monetary policy engine]] integration''' — every bank-to-player payout is classified as a TRANSFER_TO_PUBLIC event, feeding the engine's source-flow ratio analysis.
* '''Demand governor''' — an adaptive controller that adjusts buying intensity based on time of day, player count, real buyer activity, and bank health. The system backs off when real buyers are active and fills in when the market is quiet.
* '''Per-shop persona system''' — transactions use randomized buyer names in logs for natural appearance.

== How it works ==

# The system maintains a shopping list of approximately 130 common items with internal maximum buy prices.
# Every few minutes, it scans active player [[ChestShop]] signs for eligible items.
# If a shop sells an item on the list at or below the max price, the system may purchase.
# The shop owner receives payment to their balance, identical to a normal sale.
# If the shop owner is online, the system sends a chat notification: ''+$X sale: <buyer> bought Yx <item> from your shop.''
# Purchased items are removed from the chest (the bank does not stockpile).

From the shop owner's perspective, the transaction looks identical to a real player purchase.

== Sale notifications ==

When a simulated buyer purchases from a player's shop, the shop owner receives a chat message identifying the buyer persona, item, quantity, and payment amount. The notification only fires if the seller is online at the moment of sale; offline sellers see no notification but their balance reflects the sale on next login.

The notification was added on 2026-05-28 in response to player feedback that sim shop sales were silently increasing balances without indication of source.

== Bedrock shop owners ==

The system supports player shops owned by Bedrock Edition players. Floodgate's bedrock-prefix (<code>.</code>) is preserved on the sign and routed through the system's UUID resolver, which looks up the player's full Bedrock IGN even when the shop sign truncates names longer than 15 characters.

== What the system buys ==

{| class="wikitable"
|-
! Category !! Examples
|-
| Mining || Cobblestone, stone, deepslate, iron ingot, gold ingot, diamond, coal, redstone, lapis, copper
|-
| Wood || Oak log, spruce log, birch log, planks
|-
| Farming || Wheat, carrots, potatoes, sugar cane, melon, pumpkin
|-
| Food || Cooked beef, cooked chicken, bread
|-
| Building || Glass, bricks, sand, gravel
|-
| Mob drops || String, gunpowder, bones, leather, feathers
|-
| Nether/End || Quartz, glowstone, chorus fruit, blaze rod
|}

=== Items the system will NOT buy ===

Beacons, totems of undying, ender pearls, shulker boxes, elytra, mob spawners, and other high-value or exploit-prone items are excluded from the sim shop's purchase list. Players can still sell these to the [[Admin shop]] at a floor price.

== Demand controls ==

{| class="wikitable"
|-
! Control !! Purpose
|-
| Daily spending cap || Bank stops buying after a server-wide daily limit
|-
| Per-owner cap || No single shop owner receives more than a set share of the daily budget
|-
| Per-shop cooldown || Waits between purchases from the same shop
|-
| Intensity profiles || Activity scales with server population and time of day
|-
| Bank floor || Stops all activity if the CentralBank balance drops below a safety threshold
|}

== Economy integration ==

The system is tightly integrated with the server's custom economic infrastructure:

* Transactions are flagged <code>simulated: true</code> in the transaction log.
* The [[Consumer Price Index|CPI]] '''excludes''' simulated transactions — it reflects real player prices only.
* The [[Monetary policy engine]] classifies payouts as transfers from reserve, not new money creation.
* A 7-day lagged CPI snapshot prevents the system from chasing its own price signal.

== Visibility ==

The system is intentionally invisible to players except for the sale notification described above:

* No command reveals bank buy prices or the shopping list.
* The [[Economy|/market command]] shows real player data only.
* Shop owners cannot distinguish simulated purchases from real ones in the transaction log.

== Admin commands ==

{| class="wikitable"
|-
! Command !! Description
|-
| <code>/simshop status</code> || Bank balance, daily spend, pause state
|-
| <code>/simshop pause</code> || Pause all activity
|-
| <code>/simshop resume</code> || Resume activity
|-
| <code>/simshop refill <amount></code> || Add funds to CentralBank
|}

These require staff permissions.

== See also ==

* [[Consumer Price Index]] — the price index (excludes simulated trades)
* [[Monetary policy engine]] — the inflation management system
* [[Item worth]] — the unified pricing engine used by tooltips
* [[Economy]] — how money flows through the server
* [[ChestShop]] — how to create player shops
* [[Admin shop]] — the separate server-run shop
* [[Trading]] — trading methods and price discovery

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

ChestShop

2026-05-29T03:11:20Z

VxMac: Add Item worth pricing reference + tips

'''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:

{| class="wikitable"
|-
! Line !! What to write !! Example
|-
| 1 || ''Leave blank'' (your name fills in automatically) ||
|-
| 2 || Quantity per transaction || <code>64</code>
|-
| 3 || Price: <code>B</code> for buy, <code>S</code> for sell, or both || <code>B 100:S 50</code>
|-
| 4 || Item name || <code>Diamond</code>
|}

; 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 <code>/market <item></code> 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 <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 ==

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 ==

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 <code>/market <item></code> 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

[[Category:Plugins]]

Admin shop

2026-05-29T03:11:19Z

VxMac: Add endgame items + Item worth link

The '''admin shop''' is the server-run shop on Prosperity SMP, powered by the EconomyShopGUI plugin. It provides guaranteed floor prices for common materials so players always have a buyer, even when no player shops are stocked.

== Accessing the shop ==

Run <code>/shop</code> from anywhere to open the admin shop GUI. Browse categories and click items to buy or sell.

The shop is organized into categories:

* Ores and minerals
* Building materials
* Farming and food
* Tools and equipment
* Miscellaneous

== Pricing philosophy ==

Admin shop prices are intentionally set as a '''floor''' — slightly below what player [[ChestShop|shops]] typically charge. This ensures:

* New players always have somewhere to sell materials.
* Player-run shops remain competitive (the admin shop does not undercut active sellers).
* Players can use the [[Item worth]] tooltip to see the admin floor before deciding whether to sell.

For each item, the admin shop may be configured as ''buy-only'' (the shop sells to you), ''sell-only'' (you sell to the shop), or ''both''. Common raw materials are typically sell-only — the server pays a floor price but does not sell them back to players, leaving that role to the [[ChestShop|player market]].

== Endgame items ==

The admin shop pays a guaranteed floor price for several endgame materials that previously had no reliable buyer. The server does '''not''' sell these items back to players — they are sell-only.

{| class="wikitable"
|-
! Item !! Admin floor (player → server)
|-
| Netherite ingot || $1,000
|-
| Netherite scrap || $350
|-
| Ancient debris || $200
|-
| Elytra || $1,500
|-
| Totem of Undying || $300
|-
| Shulker shell || $25
|-
| Shulker box (empty) || $30
|-
| Netherite Upgrade Smithing Template || $120
|-
| Armor Trim Smithing Templates (sampled) || $100
|}

Player-market prices for these items are typically higher. Use the [[Item worth]] tooltip's Market Est line to see the engine's estimate of fair player-market pricing.

== Buying vs selling ==

The GUI shows the price and direction for each item. Most items show two prices side-by-side; if only one is shown, that direction is the only one supported.

== See also ==

* [[ChestShop]] — player-owned shops with custom pricing
* [[Item worth]] — item pricing tooltips and engine details
* [[Simulated ChestShop]] — the simulated buyer that keeps low-traffic shops liquid
* [[Jobs]] — earning money through job wages
* [[Getting started]] — new player guide

[[Category:Plugins]]

Item worth

2026-05-29T03:05:50Z

VxMac: Create Item worth page (HoverWorth + worth engine v2)

The '''item worth''' system is a server-side pricing engine that estimates the market value of every Minecraft item and displays the estimate as a tooltip line when a player hovers an item in any inventory. The system deployed on 2026-05-28.

== Overview ==

Item worth combines four data sources to produce a single per-item estimate:

# The admin shop floor price, set by the server in [[Admin_shop|admin shop]].
# The simulated market's maximum bid price (the [[Simulated_ChestShop|sim shop]]).
# Real player-to-player trade medians, drawn from [[ChestShop]] transaction logs.
# The cost of crafting the item from priced ingredients (recipe-cost).

The engine blends whichever sources are available for a given item into a single market estimate. When no direct source exists, the engine falls back to a category median (for example, all wood-family items share a category) and, as a last resort, a global median.

== Tooltip display ==

When a player hovers an item, two lines appear at the bottom of the tooltip:

Admin Sell: $X
Market Est: $Y

The '''Admin Sell''' line reports the price the admin shop pays the player when the player sells the item to the shop. For items the server does not buy, the line reads <code>not bought</code>.

The '''Market Est''' line reports the engine's best estimate of the item's player-to-player market value. The estimate is annotated with a confidence indicator:

{| class="wikitable"
|-
! Tag !! Meaning
|-
| (no tag) || Derived from admin shop and sim shop data; medium confidence
|-
| <code>(7d median)</code> || Derived from real player trades in the past seven days; high confidence
|-
| <code>(recipe)</code> || Computed as the sum of ingredient costs; high confidence for stable recipes
|-
| <code>(rough)</code> || Derived from a category or global median; low confidence
|}

The Market Est value reflects the engine's best guess at what a fair player-to-player price would be. It is not a guarantee of price discovery.

== Coverage ==

The engine maintains worth values for every item that has an in-game item form. Items without a direct admin-shop price are still priced through recipe inference or category median, so hovering any item in inventory will produce a tooltip.

As of 2026-05-28 the engine maintains 1,859 priced items: 471 from direct admin shop or sim shop data, 235 from recipe inference, and 1,153 from category-median fallback.

== Recipe inference ==

For items not directly priced, the engine attempts to derive a price from the item's crafting recipe. The bucket, for example, is priced at three times the iron ingot's worth. Wood-family items follow a deterministic pattern: oak planks cost one-quarter of an oak log, an oak slab costs half a plank, and an oak door costs two planks.

The engine supports multi-step recipe convergence. The price of a bookshelf, for example, is derived from the price of a book, which is derived from the price of paper, which is derived from the price of sugar cane (an admin-priced material).

== What the tooltip is not ==

The displayed value is an estimate, not a binding price. Sellers may price items above or below the estimate at their discretion. The admin shop pays its listed floor price and not the Market Est; that figure is shown only for reference.

The estimate does not include sentimental or aesthetic value. Enchanted items, named items, and items with custom NBT may carry higher player-market value than the engine reports.

== Tracking inflation ==

The engine is wired to apply two adjustment multipliers when their data sources activate:

* '''Inflation multiplier:''' a server-wide adjustment derived from the [[Monetary_policy_engine|monetary policy engine]]. The multiplier remains at 1.0 until the policy engine exits its bootstrap period (approximately 2026-06-05).
* '''Scarcity multiplier:''' a per-material adjustment based on the cumulative extraction count for ores in mineable worlds (resource world, nether, end). The multiplier remains at 1.0 until extraction passes 10 percent of the theoretical worldgen budget for that material.

Both multipliers operate as no-ops while their source systems are still ramping up, and will begin scaling worth values automatically once those systems go active.

== See also ==

* [[Economy]] — server economy overview
* [[Crates]] — crate progression system
* [[ChestShop]] — player-run shops

[[Category:Economy]]

Crates

2026-05-29T03:05:50Z

VxMac: Crates v2: no keys + gambling crate + milestone details

'''Crates''' are sealed containers that grant a random reward when opened. They are obtained primarily through [[Jobs|job]] progression and serve as a secondary income stream alongside Jobs payments and player trading.

== Overview ==

The crate system deployed on 2026-05-26 groups crates into four reward tiers per career, plus a prestige tier, a gambling variant, and a one-time welcome crate. Opening a crate is a single right-click action; '''no keys are required.''' The crate item itself is the container. The reward is selected at random from the crate's reward table, with the chance of each reward determined by its weight.

== Tiers ==

There are four reward tiers in the standard career crate progression. The tier of a dropped crate matches the player's current level in the relevant job at the time of the drop.

{| class="wikitable"
|-
! Tier !! Level range !! Typical rewards
|-
| Welcome || One-time only || Starter materials, small cash stipend
|-
| Apprentice || Job level 1-15 || Common career items, modest cash
|-
| Master || Job level 16-35 || Mid-tier ingots, enchanted gear, blocks
|-
| Legendary || Job level 36-50 || High-value materials, rare enchanted items
|-
| Prestige (P1) || Available after reaching [[Prestige|prestige]] 1 || Master tools, vouchers, soulbound utilities
|-
| Prestige (advanced) || Available after prestige 2 and above || Endgame and cosmetic rewards
|}

A career crate's reward pool is themed to its job. The Miner Legendary crate, for example, weights heavily toward diamond, netherite, and Fortune-enchanted gear, while the Farmer Legendary crate favors crops, bonemeal, and Replenish-enchanted tools.

== How crates are obtained ==

Crates drop from three sources:

# '''Milestone level-ups.''' A career crate is granted at every fifth job level (5, 10, 15, 20, 25, 30, 35, 40, 45). Reaching level 50 grants three crates instead of one.
# '''Random Jobs payments.''' Each Jobs Reborn payment carries a small chance to drop a crate. The base rate is 0.03 percent per payment.
# '''Server events.''' Admins may grant crates as event rewards, contest prizes, or compensation.

Prestige crates are granted exclusively upon completing a prestige tier and cannot be obtained through normal drops.

== Opening crates ==

To open a crate, hold the crate item in the hotbar and right-click. The opening animation plays at the player's location and the reward is added to the player's inventory. If the inventory is full, the reward drops at the player's feet.

The opening animation uses the CSGO-style scrolling reveal. The animation cannot be skipped.

=== Mass opening ===

Holding shift while right-clicking a stack of crates opens all crates in the stack sequentially. Rewards accumulate in the inventory. Large stacks may take several seconds to fully process.

== Gambling crate ==

The gambling crate is a paid variant available through the <code>/gamble</code> command. The command costs '''$325 per pull''' and rolls a single reward from the gambling crate's table. The expected value of a pull is approximately $288, giving the house an edge of about 11 percent.

The gambling crate's reward pool covers five outcome ranges:

* '''Bust''' (45 percent total): rotten flesh or dirt
* '''Small win''' (32 percent): $100-$150 cash, iron or a single diamond
* '''Decent win''' (17 percent): $550 cash, 16 diamond, or an enchanted book
* '''Big win''' (5 percent): $2,400 cash, netherite scrap, or enchanted diamond armor
* '''Jackpot''' (1 percent): a $10,000 cash prize, a random soulbound utility, or a random master tool

Players are limited to 20 pulls per day. The jackpot is broadcast server-wide when it hits.

The command requires the <code>gambling.use</code> permission, which is granted to the citizen group by default.

== Mending books ==

Mending is not available from the standard Master crate. The only legitimate source of Mending on Prosperity SMP is the [[Master_Smith|master tool]] obtained from a Prestige P1 crate. Master tools carry the Mending enchantment as a baked-in property and cannot be transferred to other items.

== See also ==

* [[Jobs]] — career system and prestige
* [[Item worth]] — item pricing tooltips
* [[Getting started]] — new player guide

[[Category:Gameplay]]