Prosperity SMP Wiki - User contributions [en]

Banking

2026-06-12T02:20:38Z

VxMac: Bank is open; link the new Stock market guide

{{Notice|The Central Bank is '''open''' — savings, bonds, and stocks are all live. New to investing? The [[Stock market]] page is a full course: how the Prosperity Index works, how to read it like a trader, and how real-world markets work.}}

Bank news - daily market closes, the weekly bank summary, and any rate changes - is posted to the Discord <code>#market-news</code> channel.

The '''Central Bank''' is the server's savings bank. It offers three products: '''flexible savings''' (deposit and withdraw any time), '''7-day bonds''' (locked for a week at a higher rate), and '''stocks''' (the Prosperity Index - the highest long-run returns, with real down weeks). Money in the bank earns weekly returns and still counts toward your net worth. Rates are scaled to server time: one real month is one in-game year, so a good "annual" return arrives in about four real weeks.

== Products ==
{| class="wikitable"
|-
! Product !! Base rate !! Risk !! Liquidity
|-
| Flexible savings || 1% per week || None || Deposit and withdraw any time
|-
| 7-day bond || 1.5% per week, locked in when you buy || None || Locked for 7 days; can auto-renew; early exit forfeits interest plus a small penalty
|-
| Stocks (Prosperity Index) || Volatile — big bull runs and real crashes (the market moves every hour) || Can lose value fast in a downturn || Buy and sell any time
|}

* '''Rates are paid in full each week.''' The interest pool is funded by taxes and penalties, with the Treasury covering any difference. Bond rates are locked at purchase; flexible rates can change for future weeks.
* Interest is calculated on the '''lowest balance you held for the full week''', so topping up right before payout does not earn extra.
* The full rate applies to your entire balance - there are no balance caps.
* Minimum deposit: '''$50'''. One bond at a time per player, from $50 up - no maximum.
* '''Capital gains tax:''' bond interest pays net of a '''10%''' tax, and realized stock gains are taxed '''15%''' when you sell. Your deposits and principal are never taxed. Tax proceeds flow back into the bank's interest pool.
* When a bond matures, the principal plus interest is credited automatically to your flexible savings - or, with '''auto-renew''' on (<code>/bond autorenew</code>), it locks straight into a fresh 7-day bond at the then-current rate, compounding week over week.

=== High-yield tiers ===
Large accounts earn '''multiplied rates''' on savings and bonds. Your tier is set by your total account balance - flexible savings, bond, and stocks combined. It applies to weekly savings interest and to the rate locked into new or auto-renewed bonds.

{| class="wikitable"
|-
! Tier !! Total account balance !! Rate multiplier !! Flexible !! Bond
|-
| Standard || under $50,000 || 1× || 1%/week || 1.5%/week
|-
| High-Yield || $50,000+ || 4× || 4%/week || 6%/week
|-
| Private Reserve || $150,000+ || 8× || 8%/week || 12%/week
|}

Tiers apply to savings and bonds only — '''the stock market is the same for everyone''', whatever your balance.

Check your tier with <code>/savings balance</code>.

== Using the bank ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/savings</code> || Open the bank menu (works on Bedrock)
|-
| <code>/savings deposit <amount></code> || Deposit cash into flexible savings
|-
| <code>/savings withdraw <amount></code> || Withdraw back to your wallet
|-
| <code>/savings balance</code> || Check your savings and bond
|-
| <code>/bond buy <amount></code> || Buy a 7-day bond at the current locked rate
|-
| <code>/bond status</code> || See your bond's maturity time and projected interest
|-
| <code>/bond autorenew</code> || Toggle automatic renewal at maturity (compounds)
|-
| <code>/bond claim</code> || Exit a bond early (forfeits interest, charges a penalty; you confirm first)
|-
| <code>/stocks invest <amount></code> || Buy into the Prosperity Index
|-
| <code>/stocks sell <amount|all></code> || Sell back to your wallet at the current value
|-
| <code>/stocks status</code> || Your position and last week's market close
|}

=== Stocks ===
''Main article: [[Stock market]]''

The Prosperity Index moves '''every hour''' - the same move for every investor, with days that can swing several percent in either direction. The official '''daily close''' (the net of the day's hourly moves) is posted to Discord at 4 AM and shown in <code>/stocks status</code> alongside the live day-so-far number; the week's net move is announced in chat at the weekly close. The market runs hot and cold: bull runs can stack double-digit weekly gains, and corrections or crashes can wipe gains back out just as fast. Over the long run the index is built to grow with the server's economy.

=== Reading the market (beginner tips) ===
You don't need spreadsheets to do well here. <code>/stocks</code> shows the index level, a 24-hour mini-chart, the last seven daily closes, and any current streak — and the daily close posts to Discord every morning. A few patterns cover most of what matters:

* '''Streaks are real.''' Several green closes in a row usually means a run — riding it has been profitable. Runs always end eventually, so take some profit on the way up.
* '''Crashes happen.''' A violent red day is often followed by more rough days. Stepping out for a day or two after a big drop — or buying the recovery once it stabilizes — are both real strategies.
* '''Buying the dip beats panic-selling the bottom.''' The players who lose the most buy the top of a run and sell the bottom of a crash. Over the long run the index grows with the server.
* '''Never invest money you need tomorrow.''' Rent, food, and gear come first; invest what's left.

Full price charts are coming to the [https://economy.prosperitysmp.com economy website], where classic chart patterns (double bottoms, breakouts, and the like) will actually be visible — the skills you learn reading them work the same way here as in real markets. There is no lock and no penalty: buy in or sell out whenever you like. New money rides from the '''next''' hourly move, so there are no free instant gains. Positions can shrink hard on a bad day - never invest cash you cannot afford to see dip.

Your first deposit asks you to accept the account terms below with <code>/savings accept</code>.

== Account terms ==

By making your first deposit, you agree to the terms below. They exist to keep the bank fair and safe for everyone.

=== 1. Your savings are yours ===
Money you deposit stays yours. Flexible savings can be withdrawn at any time. Bond principal is returned when the bond matures (or earlier, with a penalty). The bank does not charge fees to hold your money, and there are no inactivity fees - your savings remain yours for as long as you have an account.

=== 2. Interest ===
Savings and bonds earn interest, paid out weekly.

* '''Rates are paid in full.''' The rate shown in <code>/savings</code> is what you receive, funded by the bank's interest pool (taxes, penalties, and Treasury top-ups).
* '''Bond rates are locked when you buy the bond''' and are honored for the bond's full term. Interest is paid net of the 10% capital gains tax.
* '''Flexible savings rates can change for future weeks.''' We will never reduce interest you have already been paid; changes only affect future periods.
* Interest is calculated on the '''lowest balance you held for the full week''', so topping up right before payout does not earn extra - money has to actually sit in the account.

=== 3. Bonds ===
* A bond locks your money for its full term (currently '''7 days''') at a fixed rate.
* When it matures, your principal plus interest is credited to your flexible savings.
* '''Ending a bond early''' forfeits all of its interest and charges a small principal penalty. You will always be shown the penalty and asked to confirm before an early exit goes through.
* Bonds set to '''auto-renew''' roll the principal plus paid interest into a new bond at the then-current rate. You can toggle auto-renew at any time before maturity.

=== 3b. Stocks ===
* Stock positions are revalued hourly by the shared market move - the same percentage for every investor. '''Values go down as well as up''' - a down day reduces your position, and that reduction is final.
* The market is designed to trend upward with the server economy over the long run, but no specific week or return is guaranteed.
* There is no lock-in: you can sell any part of your position at its current value at any time.
* '''Realized gains are taxed 15% at sale''', measured against what you originally paid in. Selling at or below your cost basis is never taxed.

=== 4. Exploited, duplicated, or mistakenly-credited money ===
The Central Bank runs on a real, tracked economy. To keep it fair:

* '''Money gained from a bug, glitch, duplication, lag, or a system/admin error is not a valid balance.''' Staff may remove or reverse it at any time - even if it has already been spent, traded, moved, or saved into the bank.
* '''If your balance changes in a way you cannot explain''' - a sudden jump, a payment that ran twice, a deposit or interest amount that looks wrong - '''tell staff right away.''' Quietly keeping or moving money you know is bugged is treated as abuse of the economy.
* '''Do not exploit, and do not help others exploit.''' Doing so can mean a rollback of the gains, removal from economy systems, and - depending on severity - a ban.
* '''Honest reporters are rewarded, not punished.''' Find a real bug and report it instead of abusing it and you may earn a bug bounty (past finders have earned cash and crates). Reporting in good faith will never get you in trouble.

=== 5. Account security ===
To protect the bank and its savers, staff may:

* '''Recover money credited in error''' to your account, as described in section 4.
* '''Temporarily freeze an account''' that shows suspicious activity, while it is reviewed. A frozen account can still be viewed; deposits and withdrawals are paused until the review clears.
* '''Review or limit unusually large withdrawals''' for security. Normal saving and withdrawing should not be affected unless a security review or a temporary bank pause is active.

=== 6. Fair use ===
* '''One Central Bank account per player.''' Using alternate accounts to farm interest or get around limits is abuse of the economy and is handled under section 4.

=== 7. Changes to these terms ===
We may update these terms as the bank grows. Material changes will be announced. Continuing to use your account after a change means you accept the updated terms.

''Questions about your account? Ask staff - we're happy to help.''

== Taxes on bank money ==
* '''Interest and gains are taxed at source''' — 10% on bond interest and 15% on realized stock gains, withheld automatically when you're paid. Your deposits and principal are never taxed.
* '''Wealth tax:''' from '''June 18''', money in your flexible savings account counts toward the wealth-tax bracket exactly like wallet cash (it's instant-access money). '''Bonds and stocks do not count''' — invested money is taxed on its gains, not for being held.
* The wealth tax is only ever charged from wallet cash — nothing is ever force-sold.

== See also ==
* [[Stock market]] - the full investing guide, from chart reading to how real markets work
* [[Economy]] - server economy overview
* [[Commands]] - full command reference
* [[Server rules]] - general conduct rules

[[Category:Economy]]

Stock market

2026-06-12T02:19:44Z

VxMac: Create stock market guide: Prosperity Index mechanics, chart reading, strategy, and real-world market education

{{Notice|The market involves '''real risk''' — the index can fall for days at a time and your position can lose value. Never invest money you need this week (rent, shop stock, taxes). For account terms, rates, and the bank's other products, see [[Banking]].}}

The '''stock market''' on Prosperity is the '''Prosperity Index''' — a single, server-wide market operated by the Central Bank. Every investor holds a piece of the same index: when it rises, every position grows by the same percentage, and when it falls, every position shrinks by the same percentage. There are no individual stocks to pick; the skill is in '''reading the market''' — knowing when to be invested, when to take profit, and when a drop is an opportunity.

This page is a complete course: how the Prosperity market works, how to read charts and spot patterns like a trader, and how real-world stock markets work. Everything here can be learned by playing — no outside videos required.

== The Prosperity Index ==
The index started at a level of '''100''' at launch, so the level is also its total growth since opening (a level of 110 means +10% all-time). It is the same market for everyone — there are no balance tiers, no private rates, and no way to get a different price than the player next to you.

{| class="wikitable"
|-
! When !! What happens
|-
| Every hour || The index moves. Hourly moves are usually small, but they add up — this is the "heartbeat" you watch during the day.
|-
| 4 AM (daily close) || The day's net move becomes official. Gains and losses are applied to every position, and the close is posted to the Discord <code>#market-news</code> channel.
|-
| Weekly close || The week's net move is announced in chat — the number that matters most for long-term investors.
|}

The market runs hot and cold. Winning streaks can stack large weekly gains, and corrections can wipe gains back out just as fast. Over the long run the index is built to grow with the server's [[Economy|economy]] — but "long run" is doing real work in that sentence. Any single day or week can go badly.

=== How your money tracks the index ===
Your position is updated at each '''daily close''', not hour by hour. The hourly moves show where the day is heading; 4 AM is when the result lands on your balance. Three rules follow from this, and they reward honest investing over clever timing:

* '''New money starts earning at the next daily close.''' A day's gain is paid on the smallest amount you held for that whole day — so jumping in at 11 PM to grab a green day earns nothing extra.
* '''Losses apply to whatever is invested at the close.''' If a day is going badly, selling before 4 AM genuinely limits the damage — the close only hits what's still in.
* '''Selling mid-day pays your value as of the last close.''' The day-so-far number in <code>/stocks</code> is a preview, not yet your money.

=== Costs and taxes ===
* Minimum investment: '''$50'''. No maximum, and no fees to buy or sell.
* '''Capital gains tax: 15% of realized gains''', withheld automatically when you sell. The bank tracks what you paid in (your ''cost basis''); if you sell for no gain, there is no tax. Your principal is never taxed.
* Stocks are '''exempt from the wealth tax''' — invested money is taxed on its gains when you sell, not for being held.

== Investing ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/stocks</code> || Your position, the index level, a 24-hour mini-chart, the last seven daily closes, and any current streak
|-
| <code>/stocks invest <amount></code> || Buy into the index
|-
| <code>/stocks sell <amount|all></code> || Sell back to your wallet (15% tax on the gain portion only)
|-
| <code>/savings</code> || The Central Bank menu — savings, bonds, and stocks in one place (works on Bedrock)
|}

== Tools for market watchers ==
* '''In game:''' <code>/stocks</code> is the quick check — level, 24-hour sparkline, recent closes, and streak warnings.
* '''The website:''' [https://economy.prosperitysmp.com/stocks.html economy.prosperitysmp.com/stocks.html] is the full trading desk — candlestick and line charts, 1H/4H/1D/7D views, and live cards for momentum, volatility, trend age, and a plain-English signal. Everything in the "Reading the market" section below can be practiced there.
* '''Discord:''' <code>#market-news</code> posts every daily close, plus notes when the market is on a notable run.
* '''Sector Watch is not the stock market.''' The sector indexes (<code>/sectors</code>, [https://economy.prosperitysmp.com/sectors.html sectors.html]) track real job activity in Mining, Farming, Lumber, Combat, and Fishing. They are observe-only for now and have no connection to the Prosperity Index.

== Reading the market ==
You can do well here with no math beyond percentages. These are the concepts traders actually use, in the order you should learn them.

=== Reading a candlestick chart ===
The website's candle view packs four facts into each bar. For a 4H candle, that bar summarizes four hours of moves:

* The '''body''' (the thick part) runs from where the price '''opened''' to where it '''closed''' for that period.
* '''Green''' body: it closed higher than it opened. '''Red''': it closed lower.
* The '''wicks''' (thin lines above and below) show the '''highest and lowest''' points touched during the period.

What to look for: a long body means conviction (the market moved hard one way and stayed there). Long wicks with a small body mean a fight — the price swung but ended near where it started, which often shows up near turning points. A series of green bodies stacking upward is a trend you can see at a glance.

=== Trend ===
The trend is the market's overall direction over days, not hours. The simplest test: look at the 7D chart and ask whether the recent closes are mostly higher or mostly lower than a week ago. Trading '''with''' the trend (buying in an uptrend, being cautious in a downtrend) is the single highest-value habit in investing. Single hours are mostly noise — an uptrend has plenty of red hours inside it, and reacting to every one of them is how players churn money away.

=== Momentum ===
Momentum is the trend's '''speed''' — not just "is it going up," but "is it going up faster or slower than before?" A run that gained 2% a day and is now gaining 0.5% a day is still rising, but losing momentum, and fading momentum is often the earliest warning that a run is getting old. The website's momentum card computes this for you; you can also eyeball it from candle bodies getting shorter.

=== Volatility ===
Volatility is how '''wide''' the swings are, regardless of direction. A calm market drifts in small steps; a volatile one lurches. Volatility matters for sizing: in a calm market a large position is comfortable, while in a wild one the same position will hand you stomach-dropping red days — and frightened investors make bad decisions. When the volatility card runs hot, smaller positions keep you rational.

=== Streaks, tops, and dips ===
The patterns that repeat on Prosperity, written plainly:

* '''Runs are real, and runs end.''' Several green closes in a row usually means more strength behind it — riding a run has been profitable. But '''the longer a run goes, the closer the top'''. Nobody rings a bell at the top; the players who keep their fortunes take profit ''on the way up'', a piece at a time.
* '''Big drops are often followed by strong recoveries''' — here, more often than not. Buying after a violent red day has minted fortunes. It has also occasionally bought into a second red day, which is why dip-buying is done in stages, never all at once.
* '''Downturns can run for a few days.''' One red close is noise. Three is a downtrend — respect it, and let it show signs of stabilizing before you wade in.

=== The bond benchmark ===
The most useful question in the whole game: '''"Do I believe the market will beat 1.5% this week?"''' That's what a [[Banking|7-day bond]] pays, guaranteed and locked at purchase. If the market is trending up with momentum, the answer is often yes — stay invested. If the market looks tired or is mid-downtrend and you can't honestly answer yes, the bond is the better trade that week. Professionals call this ''opportunity cost''; you can just call it the bond test. Asking it once a day, after the 4 AM close, is a complete investing routine.

== Strategies that work ==
{| class="wikitable"
|-
! Strategy !! How it works !! The catch
|-
| '''Buy and hold''' || Invest and ignore the daily noise. The index is built to grow with the economy long-run, so patience alone has positive odds. || You will sit through crashes without flinching. Most players can't.
|-
| '''Ride the run, skim the top''' || Stay invested while the trend and momentum are up; each time the run stretches on, sell a slice (say 20–25%) and bank it. || Skimming means giving up some upside if the run keeps going. That's the price of never being the player who round-tripped a fortune back to zero.
|-
| '''Buy the dip — in stages''' || After a violent drop, buy a first slice. If it falls again, buy another. Never spend your whole reserve on the first red day. || Sometimes the knife keeps falling. Stages limit the damage; all-in doesn't.
|-
| '''Steady drip (dollar-cost averaging)''' || Invest a fixed amount on a schedule — say $500 every Sunday — regardless of the price. You automatically buy more units when it's cheap and fewer when it's expensive. || Boring. Also the strategy with the best track record for people who don't want to watch charts, which is most people.
|}

Whatever the strategy, '''keep your living money out of the market.''' Rent for your [[Plot rental|plot]], shop restocking cash, and tax money stay in your wallet or flexible savings. The market is for money you can leave alone.

== Mistakes that lose money ==
Every one of these has already cost a Prosperity player real money. They are all psychology, not math:

* '''Buying the top (FOMO).''' The market's been green for a week, chat is celebrating, so you finally go all-in — at the very point the bond test says the run is old. If the excitement is what convinced you, you're late.
* '''Panic-selling the bottom.''' The worst trade on the server is buying a happy top and selling a terrified bottom — it converts a temporary loss into a permanent one. If you wouldn't sell calmly, don't sell scared.
* '''Going all-in.''' With everything invested you can't buy dips, can't pay rent without selling at a bad time, and can't think straight on red days. An uninvested reserve is a weapon, not laziness.
* '''Revenge investing.''' Doubling down to "win back" yesterday's loss is how a bad day becomes a bad month. The market doesn't know what you lost and doesn't owe it back.
* '''The gambler's fallacy.''' "Four red days — tomorrow ''has'' to be green." No it doesn't. Streaks shift the odds here, but nothing is ever due. Decide on the trend in front of you, not on what feels fair.
* '''Confusing the market with the [[Casino|casino]].''' The casino is entertainment priced with a house edge — play long enough and you lose, by design. The market has long-run growth behind it but real short-run pain. Treating the market like a slot machine (all-in, instant gratification, revenge bets) imports the casino's results into the one place built to actually pay you.

== How real stock markets work ==
The Prosperity market is modeled on the real thing, so what you learn here transfers. Here is the real version, plainly.

=== What a stock actually is ===
A stock (or ''share'') is a small slice of '''ownership in a company'''. Own a share of a company with 1 million shares and you own one-millionth of it — its factories, its brand, and a claim on its future profits. Companies sell shares to raise money to grow; investors buy them hoping the company becomes more valuable, and some companies also pay out a slice of profit to shareholders directly each quarter (a ''dividend''). That's the foundational difference from Prosperity: a real share is a claim on a real business's earnings, not just a number that moves.

=== How prices are set ===
There is no official in charge of a stock's price. Real markets are a continuous '''auction''': buyers post what they're willing to pay (''bids''), sellers post what they'll accept (''asks''), and the exchange matches them millions of times a day. The price is simply the last match — which means a price is just '''what the next person will pay'''. That's why news moves prices instantly: a great earnings report makes buyers raise their bids before a single product ships. Prices move on ''expectations'' of the future, not on the present — by the time everyone knows something is good, it's already in the price.

=== Market indexes ===
Nobody can follow thousands of stocks, so the world watches '''indexes''' — single numbers that average a basket of them. The famous ones are the '''S&P 500''' (500 of the largest US companies — when news says "the market was up today," it usually means this), the '''Dow Jones''' (30 giants, the oldest measure), and the '''Nasdaq''' (technology-heavy). The Prosperity Index works the same way: one number standing in for the health of the whole economy. In real life you can invest directly in an index through an ''index fund'' — which is essentially what every Prosperity investor is doing.

=== Bulls, bears, and crashes ===
* A '''bull market''' is a sustained rise (the nickname: a bull attacks upward with its horns). A '''bear market''' is a fall of 20% or more from the peak (a bear swipes downward). A '''correction''' is a smaller drop, around 10% — uncomfortable, routine.
* Real history is dramatic. The crash of '''1929''' wiped out roughly 89% of the US market's value and fed the Great Depression. The '''dot-com bust''' (2000) erased fortunes built on internet hype. The '''2008 financial crisis''' halved the market in months. The '''2020''' pandemic crash dropped it ~34% in five weeks — followed by one of the fastest recoveries ever.
* The pattern across a century: '''crashes are normal, recoveries have followed every one of them so far''' — for the ''index''. Individual companies are different: many businesses in those crashes went to zero and never came back. That asymmetry is the core argument for indexes over stock-picking, and it's why diversification matters.

=== Why markets grow over the long run ===
Markets aren't magic money printers — they grow because the '''underlying economies grow'''. Companies earn profits, reinvest them, invent things, and become genuinely more valuable; prices follow, unevenly and with terrifying interruptions. The US market has averaged roughly '''10% per year over the last century''' — an average that includes 1929, 2008, and every crash between.

The engine that turns that into wealth is '''compounding''': gains earning gains. A handy shortcut is the '''rule of 72''' — divide 72 by the yearly return to get the years to double your money (at 10%, about 7 years; double again and again and modest savings become fortunes). On Prosperity the same arithmetic runs faster, since one real month is roughly one in-game year — which is why steady investing here visibly snowballs within weeks.

=== How ordinary people invest well ===
Decades of evidence point to a humbling conclusion: '''boring beats clever.''' The approach that consistently works for regular people, almost word-for-word what works on Prosperity:

* '''Buy index funds, not lottery tickets.''' Most professional stock-pickers fail to beat the index over time. Owning the whole market is the percentage play.
* '''Invest on a schedule''' (dollar-cost averaging) instead of trying to guess the perfect day.
* '''Stay in.''' "Time in the market beats timing the market" — the market's best days cluster right next to its worst ones, and people who flee crashes miss the rebounds.
* '''Diversify.''' Never bet everything on one company, one idea, or one asset.
* '''Only invest money you won't need soon''' — the only people forced to sell at the bottom are the ones who needed the money.

And the rule that protects you from every scam ever invented: '''nobody can guarantee market returns.''' Anyone promising "guaranteed 20%" or pressuring you to act before you can think is stealing from you. Real risk-free rates are low (that's the bank); everything paying more carries risk — on Prosperity and everywhere else, forever.

=== Prosperity vs. the real thing ===
{| class="wikitable"
|-
! !! Prosperity Index !! Real markets
|-
| What you own || A position in one server-wide index || Shares of specific companies, or index funds
|-
| What drives it || The server's economy over the long run, with hot and cold streaks || Company earnings, economic growth, news, and crowd psychology
|-
| Price discovery || One shared move per hour, identical for everyone || Continuous auction between millions of buyers and sellers
|-
| Hours || 24/7, daily close at 4 AM || Trading hours (US: 9:30 AM–4 PM Eastern, weekdays)
|-
| Timescale || Compressed — one real month ≈ one in-game year, so "annual" returns arrive in weeks || A doubling can take a decade
|-
| Income while holding || None from stocks (bonds and savings pay the steady interest) || Some stocks pay dividends
|-
| Taxes || 15% on realized gains, withheld automatically || Capital gains taxes, rates vary by country and holding period
|-
| Guarantees || None — it can and does crash || None whatsoever. Anyone who says otherwise is lying.
|}

== Glossary ==
{| class="wikitable"
|-
! Term !! Meaning
|-
| Bull / bear market || Sustained rising market / falling market (bear: down 20%+ from the peak)
|-
| Rally || A strong rise after a flat or falling stretch
|-
| Correction || A moderate pullback (~10%) inside a larger uptrend
|-
| Crash || A violent, fast drop
|-
| Dip || A short-lived drop — "buying the dip" means treating it as a discount
|-
| Drawdown || How far you are below your peak value
|-
| Trend || The market's overall direction over days or weeks
|-
| Momentum || The speed of the trend — fading momentum often precedes a turn
|-
| Volatility || The size of the swings, regardless of direction
|-
| Mean reversion || The tendency of extreme moves to be pulled back toward normal
|-
| Position || The money you currently have invested
|-
| Cost basis || What you paid in — gains are measured against it
|-
| Realized / unrealized gain || Profit you've locked by selling / profit still on paper
|-
| Capital gains tax || Tax charged on realized gains only (15% here)
|-
| Taking profit || Selling part of a winning position to bank the gain
|-
| Dollar-cost averaging (DCA) || Investing fixed amounts on a schedule, ignoring price
|-
| Diversification || Spreading money across assets so one failure can't ruin you
|-
| Compounding || Gains earning gains — the engine of long-term wealth
|-
| Index || One number averaging many assets to represent a whole market
|-
| FOMO || Fear of missing out — the emotion that buys tops
|}

== See also ==
* [[Banking]] — account terms, savings, bonds, and the high-yield tiers
* [[Economy]] — how the server economy fits together
* [[Casino]] — the other place money moves fast, and why it's different
* [[Commands]] — full command reference

[[Category:Economy]]

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