Prosperity SMP Wiki - User contributions [en]

Zoning Regulations

2026-06-03T03:39:05Z

Maintenance script: Redirect duplicate to canonical sentence-case page

#REDIRECT [[Zoning regulations]]

Zoning regulations

2026-06-03T03:39:04Z

Maintenance script: Update zoning: add height limits, fix farm rules

'''Zoning regulations''' define what can be built and operated on each plot type on Prosperity SMP. Land is sold bare — owners build to specification within these rules. Every plot falls into one of three zones, identified by a letter prefix and a three-digit number: residential ('''R'''), commercial ('''C'''), or industrial ('''I''') — for example, R001, C001, I001.

== Residential (R) ==
Residential plots are for personal homes and private builds.
* Only '''houses''' may be built — no businesses or paid services.
* Houses may not have '''more than three visible floors'''. Basements and rooftops are not counted as visible floors.
* Gardens and personal storage are permitted.

== Commercial (C) ==
Commercial plots are for businesses, shops, offices, and apartment buildings.
* Permitted builds include businesses, offices, shops, apartment buildings, and other commercial structures.
* [[ChestShop]] signs are encouraged on commercial plots.
* '''Height-limited to 60 blocks''', unless otherwise approved by the Department of Construction and Transport.

== Industrial (I) ==
Industrial plots are for factories, warehouses, and production facilities.
* Permitted builds include factories, warehouses, and material-processing facilities.
* Farms must be '''manual or semi-automatic''' — fully automatic AFK farms are prohibited (see [[Server rules]]).
* Agriculture is permitted only if conducted underground or otherwise hidden from view.
* '''Height-limited to 60 blocks''', unless otherwise regulated by subordinate laws.

== Apartments ==
* Apartments must not contain Nether portals or [[ChestShop]] signs.
* Water and lava must not drip from source blocks into neighboring rental units.

== General rules ==
* Build only within your plot boundaries. Encroaching on roads, paths, or neighboring plots is prohibited.
* No offensive structures in any zone. See [[Server rules]].
* Plot owners are responsible for maintaining their builds. Abandoned plots may be reclaimed by staff after notice.

== Enforcement ==
Zoning violations result in fines and admin-mediated remediation. Repeat offenders may be evicted, returning the plot to the market. The sheriff and administration hold final discretion.

== See also ==
* [[Real estate]] — how to acquire plots
* [[Auction Policy]] — bidding on government plot auctions
* [[Server rules]] — general conduct rules
* [[BOLT]] — protecting your builds

[[Category:Policies]]

Zoning Regulations

2026-06-03T03:35:43Z

Maintenance script: Create Zoning Regulations

'''Zoning regulations''' govern how land is used on ProsperitySMP. Land is sold bare — owners build to specification within these rules. Plots are identified by a letter prefix and a three-digit number (for example, R001, C001, I001). Building outside your plot's permitted use, or beyond its height limit, is a zoning violation.

== Plot types ==

=== Residential (R) ===

* Plots beginning with '''R''' (for example, R001).
* May only have '''houses''' built on them.
* Houses may not have '''more than three visible floors'''. Basements and rooftops are not counted as visible floors.

=== Commercial (C) ===

* Plots beginning with '''C''' (for example, C001).
* May only have businesses, offices, shops, apartment buildings, and other commercial buildings.
* '''Height-limited to 60 blocks''', unless otherwise approved by the Department of Construction and Transport.

=== Industrial (I) ===

* Plots beginning with '''I''' (for example, I001).
* May only have factories, warehouses, and production facilities.
* '''Height-limited to 60 blocks''', unless otherwise regulated by subordinate laws.

== Apartments ==

* Apartments must not contain Nether portals or chest shops.
* Water and lava must not drip from source blocks into neighboring rental units.

== Agriculture ==

* Agriculture is not permitted on residential plots.
* On commercial and industrial plots, agriculture is permitted only if it is conducted underground or otherwise hidden from view.

== Enforcement ==

Zoning violations result in fines and admin-mediated remediation. Repeat offenders may be evicted, with the plot returning to the market. The sheriff and administration hold final discretion.

[[Category:Government]]
[[Category:Policy]]

Auction Policy

2026-06-03T03:27:01Z

Maintenance script: Restore full Auction Policy content

The '''Auction Policy''' governs all plot auctions conducted by the Government of ProsperitySMP (the "Department"). By participating in an auction — as either an auctioneer or a bidder — you agree to be bound by this policy. All monetary values are denominated in Prosperity Dollars ($).

== Auction setup ==

Every auction listing must include the following, and none of it may be modified once the auction is posted:

* '''Title''' — the plot name (for example, C001).
* '''Starting bid''' — the lowest amount an opening bid may be.
* '''Minimum increase''' — the smallest amount by which a new bid must exceed the current high bid.
* '''Plot image''' — a photograph of the plot and/or its information sign.
* '''End time''' — a numerical duration measured from the most recent eligible bid (for example, "24 hours after the last eligible bid").

A '''buyout price''' is optional. If one is offered, it must be stated in the original listing and may not be added, removed, or changed afterward — including when live bidding approaches it.

== Bidding ==

* All bids are denominated in Prosperity Dollars and are '''legally binding'''. A bidder is obligated to honor any bid they place.
* Bids may not be modified or withdrawn once placed.
* A bidder may raise their '''own''' leading bid only '''once''' per auction. Any further attempt to raise their own leading bid is invalid.
* A bidder may not bid more than the funds available in their personal, company, or bank balance.
* If a bid is funded from anything other than the bidder's personal balance (a company, a bank, or another source), the bidder must '''state the source of funds'''. The Department reserves the right to privately request proof of funds.

The recommended bid format is:

: Bid: $0 (source of funds)

== Winning and payment ==

* The highest eligible bid at the close of the auction wins.
* If a winning bidder's balance falls below their bid amount by the time the auction closes, the next-highest eligible bid becomes the default winner.
* If a winning bidder is removed from, or leaves, ProsperitySMP before the plot is transferred, the next-highest eligible bid becomes the default winner.
* Payment is due at the close of the auction. A non-payment dispute (by either party) may be resolved by opening a support ticket with evidence — whether a winner fails to pay, or an auctioneer withholds a won plot.

== Conduct ==

Neither auctioneers nor bidders may act to divert attention away from a bid. Prohibited conduct includes:

* Commenting negatively on the starting price.
* Commenting negatively on the plot's rarity, or lack thereof.
* Commenting negatively on the plot's utility, or lack thereof.
* Advertising one's own bid or business in another auction's channel.
* Holding general conversation within a bidding channel.

== Government authority ==

* An auctioneer may rescind an auction '''only''' while it has received no bids.
* The Department reserves the right to terminate any auction at any time, for any reason.
* The Department reserves the right to restrict any individual's ability to participate in auctions.
* These authorities also apply to eviction auctions.

== Agreement ==

By participating in any auction, you agree to the terms of, and to be bound by, this Auction Policy.

[[Category:Government]]
[[Category:Policy]]

Auction Policy

2026-06-03T03:26:45Z

Maintenance script: noop verify

Auction Policy

2026-06-03T03:26:19Z

Maintenance script: Create Auction Policy

MediaWiki:Common.js

2026-05-27T19:00:29Z

Maintenance script: Auto-open sidebar drawer on desktop

/* Auto-open Citizen sidebar drawer on desktop */
(function() {
if (window.innerWidth < 1200) return;

function openDrawer() {
var toggle = document.getElementById('citizen-drawer-toggle');
if (toggle && !toggle.checked) {
toggle.checked = true;
toggle.dispatchEvent(new Event('change', { bubbles: true }));
}
}

if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', openDrawer);
} else {
openDrawer();
}
})();

MediaWiki:Common.css

2026-05-27T17:47:39Z

Maintenance script: Clear

/* empty */

MediaWiki:Common.css

2026-05-27T17:46:34Z

Maintenance script: Dark theme + modern styling for Vector-2022

/* Prosperity SMP Wiki — dark theme for Vector-2022 */

/* Dark background */
body, .mw-page-container {
background-color: #0f0f1a !important;
color: #e0e0e0 !important;
}

.vector-header-container,
.mw-header {
background-color: #0f0f1a !important;
border-bottom: 1px solid rgba(226, 183, 20, 0.15);
}

/* Content area */
.mw-body, .mw-body-content, .vector-body {
background-color: #141425 !important;
color: #e0e0e0 !important;
}

.mw-parser-output {
color: #e0e0e0 !important;
}

/* Sidebar */
.vector-column-start .vector-main-menu,
.vector-sidebar,
.mw-sidebar-container,
nav.vector-main-menu-container {
background-color: #0f0f1a !important;
}

.vector-main-menu .vector-menu-heading,
.sidebar-heading,
.vector-menu-heading {
color: #e2b714 !important;
font-weight: 600;
text-transform: uppercase;
font-size: 0.8rem;
letter-spacing: 0.04em;
}

/* Sidebar links */
.mw-sidebar a, .vector-main-menu a,
nav.vector-main-menu-container a,
.vector-column-start a {
color: #b0b0c0 !important;
}

.mw-sidebar a:hover, .vector-main-menu a:hover,
nav.vector-main-menu-container a:hover,
.vector-column-start a:hover {
color: #e2b714 !important;
}

/* Links */
.mw-body a, .mw-body-content a {
color: #6ba4e8 !important;
}

.mw-body a:hover {
color: #e2b714 !important;
}

/* Headings */
.mw-body h1, .mw-body h2, .mw-body h3, .mw-body h4 {
color: #ffffff !important;
border-bottom-color: rgba(226, 183, 20, 0.2) !important;
}

.mw-page-title-main, #firstHeading {
color: #e2b714 !important;
}

/* Tables */
.wikitable, .wikitable th, .wikitable td {
background-color: #1a1a2e !important;
color: #e0e0e0 !important;
border-color: #2a2a4a !important;
}

.wikitable th {
background-color: #1e1e36 !important;
color: #e2b714 !important;
}

/* Code blocks */
code, pre, .mw-code {
background-color: #1a1a2e !important;
color: #e8c547 !important;
border-color: #2a2a4a !important;
}

/* Search */
.vector-search-box input,
.cdx-text-input__input {
background-color: #1a1a2e !important;
color: #e0e0e0 !important;
border-color: #2a2a4a !important;
}

/* Footer */
.mw-footer, footer {
background-color: #0a0a14 !important;
color: #808090 !important;
border-top-color: rgba(226, 183, 20, 0.1) !important;
}

/* Tabs */
.vector-tabs .mw-list-item a,
.vector-menu-tabs .mw-list-item a {
color: #b0b0c0 !important;
}

.vector-tabs .mw-list-item.selected a,
.vector-menu-tabs .mw-list-item.selected a {
color: #e2b714 !important;
}

/* Notices / admonitions */
.mw-message-box {
background-color: #1a1a2e !important;
border-color: #e2b714 !important;
color: #e0e0e0 !important;
}

/* TOC */
.toc, .toccolours {
background-color: #1a1a2e !important;
border-color: #2a2a4a !important;
}

/* Category links */
.catlinks {
background-color: #1a1a2e !important;
border-color: #2a2a4a !important;
color: #b0b0c0 !important;
}

/* Blockquote */
blockquote {
background-color: #1a1a2e;
border-left: 3px solid #e2b714;
padding: 0.5em 1em;
margin: 1em 0;
}

/* User menu / personal tools */
.vector-user-links, .vector-menu-content {
background-color: #0f0f1a !important;
}

MediaWiki:Common.css

2026-05-27T17:44:59Z

Maintenance script: Force sidebar always visible on desktop

/* Force Citizen sidebar drawer to always be visible on desktop */
@media (min-width: 1200px) {
/* Make the header wider to accommodate the always-open drawer */
.citizen-header {
width: 280px !important;
}

/* Force the drawer to always be visible */
.citizen-drawer {
display: block !important;
visibility: visible !important;
opacity: 1 !important;
position: static !important;
transform: none !important;
height: auto !important;
overflow: visible !important;
pointer-events: auto !important;
}

.citizen-drawer .citizen-dropdown__content {
display: block !important;
visibility: visible !important;
opacity: 1 !important;
position: static !important;
transform: none !important;
max-height: none !important;
overflow: visible !important;
pointer-events: auto !important;
box-shadow: none !important;
border: none !important;
background: transparent !important;
}

.citizen-drawer__card {
display: block !important;
visibility: visible !important;
}

/* Push page content to the right to make room */
.citizen-body {
margin-left: 280px !important;
}

/* Hide the hamburger toggle since drawer is always open */
.citizen-drawer > .citizen-dropdown__trigger {
display: none !important;
}

/* Style the always-visible sidebar */
.citizen-drawer .citizen-menu__heading {
font-weight: 600;
text-transform: uppercase;
font-size: 0.75rem;
letter-spacing: 0.05em;
opacity: 0.7;
margin-top: 1rem;
}

.citizen-drawer .citizen-menu__content a {
padding: 4px 0;
display: block;
}
}

MediaWiki:Sidebar

2026-05-27T16:59:53Z

Maintenance script: Add Systems section with MPE + CPI

Consumer Price Index

2026-05-27T16:59:39Z

Maintenance script: Audit corrections from locked spec

The '''Consumer Price Index''' (CPI) is a custom-built price tracking system on Prosperity SMP. It measures the cost of a fixed basket of goods using real player-to-player trade data, producing a single index number that represents the overall price level. The CPI feeds directly into the [[Monetary policy engine]] and is reported weekly via Discord.

== What it measures ==
The CPI tracks the price of a weighted basket of 27 common items. It answers: are things getting more or less expensive?

A rising CPI means inflation. A falling CPI means deflation. A stable CPI means equilibrium.

== Basket composition ==
The policy basket is weighted toward everyday staples, not luxury items:

{| class="wikitable" style="width:100%;"
|-
! Category !! Weight !! Key items
|-
| Building materials || 20% || Cobblestone, stone, deepslate, logs, planks, sand, glass
|-
| Basic inputs || 30% || Iron ingot (12%), coal (6%), copper (4%), gold (4%), redstone (4%)
|-
| Food and farming || 20% || Wheat, potato, carrot, cooked meats, sugar cane
|-
| Utility consumables || 15% || Arrow, torch, firework rocket, lapis lazuli
|-
| Premium commodities || 15% || Diamond (8%), emerald (3%), netherite scrap (4%)
|}

Diamond is weighted at 8%, not higher — the basket is deliberately tilted toward staples so a few large diamond trades cannot distort the signal.

== Index formula ==
The CPI uses a '''winsorized geometric mean''', the same approach used by real-world national statistics offices:

: '''P = exp( SUM of weight_i x ln(price_i_trimmed) )'''

Each item's observed unit prices are sorted, then the top and bottom 10% are clamped (winsorized) before the geometric mean is computed. This prevents a single outlier trade from skewing the index.

== Data source ==
The CPI is computed from '''completed, non-simulated, player-to-player''' [[ChestShop]] transactions only:

* Only real trades count. [[Simulated ChestShop]] activity is tagged <code>simulated: true</code> and excluded.
* Only completed sales count, not listed prices.
* Rolling 7-day window.

This separation prevents a feedback loop where [[Simulated ChestShop|Sim Shop]] activity inflates CPI, which causes the Sim Shop to adjust prices upward, which inflates CPI further.

== Manipulation defenses ==

=== Depth gates ===
An item is excluded from the policy basket unless it meets all three thresholds:
* 10+ transactions in the 7-day window
* 3+ unique buyers
* 3+ unique sellers

Items below these thresholds still appear in <code>/market</code> with a low-confidence flag but do not influence the engine.

=== Rate-of-change clamp ===
No single item can move more than 8% per week. Excess movement is dampened.

=== Manipulation risk score ===
Each item receives a composite score from five equally-weighted factors:
# Low transaction count
# Low buyer diversity
# Low seller diversity
# Account concentration (one account over 60% of volume)
# Category outlier (item moved more than 2 standard deviations from its category)

When risk exceeds 0.5, upward price moves are partially dampened while downward moves are trusted. This reflects that most MC economy manipulation is bullish.

=== Median lag ===
The [[Simulated ChestShop]] reads a CPI snapshot '''7 days old''', not current. A manipulator would need to sustain artificial prices for over a week — expensive and risky.

== Per-item confidence ==
Each basket item receives its own confidence score based on transaction depth and participant diversity:

: '''confidence = sqrt(depth_score x diversity_score)'''

Items with low confidence contribute less to the overall index.

== Player-facing: /market ==
{| class="wikitable"
|-
! Command !! Shows
|-
| <code>/market</code> || Top 10 items by 7-day trading volume
|-
| <code>/market <item></code> || Median price, fair range (25th-75th percentile), volume, category
|}

The <code>/market</code> command shows real player data only. It does '''not''' reveal Sim Shop buy prices, CentralBank balance, or engine state.

== Weekly Discord report ==
Every Monday, an automated report posts to Discord showing total turnover, top items by value, and per-item medians. Same data pipeline as the policy CPI but formatted as a public summary.

== Commodity index ==
Separately from the policy CPI, the system computes a '''commodity index''' tracking premium items (diamond, gold, netherite, emerald). This is dashboard-only and does not influence the [[Monetary policy engine]].

== See also ==
* [[Monetary policy engine]] — consumes the CPI for recommendations
* [[Economy]] — how money flows through the server
* [[Simulated ChestShop]] — excluded from CPI by design
* [[Trading]] — how trading works
* [[ChestShop]] — the shop system generating CPI data

[[Category:Systems]]

Monetary policy engine

2026-05-27T16:57:21Z

Maintenance script: Rewrite from locked v2 spec + deployed code audit

The '''monetary policy engine''' is a custom-built automated economic management system developed specifically for Prosperity SMP. It tracks every dollar created and destroyed on the server, decomposes the money supply into policy-relevant buckets, computes a real-time inflation signal from the [[Consumer Price Index]], and generates advisory recommendations to maintain a healthy economy. The entire system — from event capture to controller logic — was purpose-built for this server.

== Design philosophy ==
Real-world central banks use the relationship between money supply, spending velocity, prices, and output to guide policy. The Prosperity SMP engine draws on the same principles but takes a deliberately simpler approach: rather than trying to estimate all four variables (which is unreliable with a small player base), it '''directly observes price changes''' through the [[Consumer Price Index|CPI]] and reacts proportionally.

The engine was designed through a five-round iterative critique between two AI systems (Claude and ChatGPT). The original v1 draft attempted to directly compute inflation pressure from money supply growth minus output growth. This was rejected during the critique — velocity and output are too noisy with 10-15 players. The v2 design watches CPI directly and uses money supply data for dashboard diagnostics rather than direct control.

== Architecture ==
The system operates across two custom-built layers.

=== Skript capture layer (Minecraft server) ===
Three custom Skript files capture every money flow event in real time:

* '''treasury-grant.sk''' — a single entry point for all money creation. Every script that pays a player routes through this wrapper, ensuring nothing enters circulation untracked.
* '''money-supply.sk''' — classifies every Vault transaction into a five-category taxonomy, computes money supply decomposition with exponential activity decay, runs stock-flow reconciliation, and exports JSON snapshots every 5 minutes.
* '''cpi-basket.sk''' — computes a winsorized geometric mean [[Consumer Price Index]] from real player-to-player trade data, with manipulation defenses and per-item confidence scoring.

=== Admin Hub controller layer (TypeScript) ===
A custom module in the Next.js Admin Hub ingests the Skript-exported JSON and runs the policy controller:

* Loads current money supply, CPI, lagged CPI, reconciliation state, and money flow events
* Computes the inflation gap (observed CPI growth vs target)
* Evaluates a confidence score from four data quality components
* Applies a proportional controller with locked safety bounds
* Aggregates source-flow ratios (sink intensity, bank drain, job faucet)
* Generates a recommendation with reasoning trace and uncertainty band
* Persists an hourly audit log for historical analysis

== Event taxonomy ==
Every balance change on the server is classified into exactly one of five categories:

{| class="wikitable" style="width:100%;"
|-
! Category !! Definition !! Effect on total supply
|-
| '''CREATE''' || Money appears from nowhere (job wages, contract rewards, crate cash, /eco give) || Increases supply
|-
| '''DESTROY''' || Money disappears (admin shop purchases, fees, /eco take) || Decreases supply
|-
| '''TRANSFER_TO_PUBLIC''' || System pays player ([[Simulated ChestShop|Sim Shop]] payouts) || No change
|-
| '''TRANSFER_FROM_PUBLIC''' || Player pays system (rent to system landlord) || No change
|-
| '''TRANSFER_PRIVATE''' || Player pays player ([[ChestShop]] sales, /pay) || No change
|}

Currently tracked sources: Jobs payouts, /eco give and /eco take, [[Contracts|civic contract]] rewards, [[Simulated ChestShop]] payouts, and [[Admin shop]] (EconomyShopGUI) transactions. All hooks are live and producing data.

== Money supply decomposition ==
The engine decomposes total money into three buckets with different policy relevance:

{| class="wikitable"
|-
! Bucket !! What it contains !! Why it matters
|-
| '''M_active''' || Balances of players who logged in within 14 days, weighted by exponential decay || Money actively chasing goods — the primary inflation-relevant pool
|-
| '''M_dormant''' || Balances of inactive players || Not circulating; a returning player creates a "liquidity shock"
|-
| '''M_reserve''' || CentralBank and system accounts || Sterilized reserve — only enters circulation when disbursed
|}

The effective supply formula:

: '''M_effective = M_active + (0.20 x M_dormant) + (lambda x M_reserve)'''

Where lambda estimates how much reserve money will enter circulation in the next 7 days. The activity decay uses:

: '''weight = max(0.05, e^(-days_since_login / 14))'''

This decomposition appears on the Admin Hub dashboard. The controller itself uses CPI data (not M directly) for recommendations — M decomposition is a diagnostic signal for admins, not a control input in v1.

== Stock-flow reconciliation ==
An hourly integrity check ensures tracked events match reality:

: '''Change in M_total = SUM of CREATE events - SUM of DESTROY events'''

If the observed total diverges from the predicted total by more than 2%, the engine disables all recommendations. This is the "hard gate" — it prevents acting on bad data. As of deploy, reconciliation passes consistently with error under 0.01%.

== Controller: the actual formula ==
The v1 controller is a '''CPI-gap proportional controller'''. It directly observes price changes and reacts:

: '''gap = (current_basket_index / lagged_7d_basket_index) - 1 - target_growth'''
: '''new_multiplier = old_multiplier x (1 - confidence x 0.20 x gap)'''

In words: the engine computes how fast the CPI basket is growing relative to the admin-set target (+0.5% per week default). If prices are rising too fast, it recommends lowering the Sim Shop multiplier. If too slow, it recommends raising it. The magnitude is scaled by data confidence.

=== Locked constants ===
{| class="wikitable"
|-
! Parameter !! Value !! Meaning
|-
| K_p || 0.20 || Proportional gain (intentionally conservative — actuator response is unknown)
|-
| Target growth || +0.5%/week || Default healthy inflation rate
|-
| Dead-band || +/- 0.3% || Below this gap magnitude, engine outputs NO_OP
|-
| Max weekly change || +/- 5% || Hard clamp on multiplier movement per week
|-
| Multiplier bounds || 0.7 to 1.3 || Absolute floor and ceiling
|-
| Min confidence (display) || 0.30 || Below this, recommendations are suppressed
|-
| Min confidence (auto-apply) || 0.70 || v2 auto-apply threshold (not active in v1)
|}

=== Why proportional-only ===
The spec includes provisions for adding derivative (D) and integral (I) control terms later, forming a full PID controller. These are deferred because:
* The D term requires smoothed historical data (EWMA, not yet accumulated — needs ~14 days)
* The I term can accumulate error during bad-data periods and needs anti-windup
* The actuator gain (how much multiplier change produces how much CPI change) is unknown until perturbation experiments run at day 30+

v1 ships the simplest controller that makes correct directional decisions. More sophisticated control is a future upgrade backed by accumulated data.

== Confidence scoring ==
{| class="wikitable"
|-
! Component !! Measures !! Maximum when
|-
| Basket coverage || Fraction of CPI basket items with valid trade data || All items pass depth gates
|-
| Sample depth || Average transactions per basket item || 50+ transactions per item
|-
| Diversity || Unique buyers + sellers across basket || 8+ unique participants
|-
| Maturity || Days since server deploy || 90+ days
|}

: '''confidence = (coverage x depth x diversity x maturity) ^ (1/4)'''

The geometric mean ensures all four components must be healthy. Each is floored at 0.1 to prevent any single zero from killing the score entirely.

== NO_OP conditions ==
The engine outputs "no action" when any of:

# Confidence below 0.30
# Gap within dead-band (+/- 0.3%)
# Reconciliation failing (hard gate)
# Fewer than 5 active players in 7 days
# Previous action not yet observed (one-week cooldown)
# New-player spike (3+ new players in 48 hours)
# Within first 14 days of operation (Phase A bootstrap)

NO_OP is the '''most common output''' on a young server. The engine is designed to be cautious — doing nothing is better than acting on insufficient data.

== Bootstrap schedule ==
{| class="wikitable"
|-
! Period !! Behavior
|-
| Day 0-14 || Advisory disabled. Dashboards live. Data collection running.
|-
| Day 14-30 || Advisory enabled with confidence scaling. No auto-apply.
|-
| Day 30-90 || Category-level perturbation experiments to measure actuator response.
|-
| Day 90+ || Auto-apply eligible if confidence sustained above 0.70.
|}

== Source-flow ratios ==
The controller also computes diagnostic ratios displayed on the Admin Hub:

{| class="wikitable"
|-
! Ratio !! Formula !! What it tells admins
|-
| sink_ratio || (DESTROY + TRANSFER_FROM_PUBLIC) / M_active || How fast money leaves active circulation
|-
| bank_drain_ratio || TRANSFER_TO_PUBLIC / M_active || How fast the bank injects liquidity
|-
| jobs_faucet_ratio || CREATE from Jobs / M_active || Job wage intensity vs the active money pool
|-
| net supply change || CREATE - DESTROY over 7 days || Bottom-line money supply movement
|}

== Design lineage ==
The engine spec was refined through five rounds of Claude/ChatGPT iterative critique, correcting three material flaws in the original v1 draft:

# '''CentralBank counted as active money''' — corrected to sterilized reserve with lambda-weighted disbursement forecast
# '''Policy response was inverted''' — the v1 draft raised the inflation target during high pressure (accommodation); corrected to proportional tightening toward a fixed target
# '''"Deflation via fewer purchases" was mislabeled''' — reducing the faucet slows growth (disinflation) but does not contract existing supply (real deflation requires sinks)

The locked v2 spec is maintained in the server's internal documentation.

== See also ==
* [[Consumer Price Index]] — the CPI basket the engine observes
* [[Economy]] — how money flows through the server
* [[Simulated ChestShop]] — the custom market activity system
* [[Admin shop]] — server-run shop (a money sink)
* [[Prestige]] — endgame money sink at scale

[[Category:Systems]]

Simulated ChestShop

2026-05-27T15:19:45Z

Maintenance script: Note custom-built plugin + link to engine pages

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.
# 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.

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

== 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:
* 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.

== 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
* [[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]]

Fisherman

2026-05-27T15:19:03Z

Maintenance script: Fix titles + dev notice

{{Notice|This job page covers the core mechanics. The full [[Skill trees|skill tree]] breakdown and advanced strategies are still in development.}}

The '''Fisherman''' is one of six [[Jobs|jobs]] on Prosperity SMP. Fishermen earn wages by catching fish.

== Joining ==
Run <code>/jobs join fisherman</code> or select Fisherman from <code>/jobs browse</code>.

== Pay rates ==
Fishermen earn approximately $0.30 per fish caught. All vanilla fish types qualify. Treasure catches (enchanted books, saddles, nautilus shells) do not pay wages but are valuable as loot.

== Titles ==
{| class="wikitable"
|-
! Level !! Title
|-
| 1 || Novice Fisherman
|-
| 10 || Apprentice Fisherman
|-
| 20 || Elite Fisherman
|-
| 30 || Master Fisherman
|-
| 40 || Grand Master Fisherman
|-
| 50 || Legendary Fisherman
|}

== Prestige ==
The Fisherman prestige tool is a fishing rod with Luck of the Sea III, Lure III, and Unbreaking V. See [[Prestige]] for costs.

== See also ==
* [[Jobs]] — overview of all jobs
* [[Skill trees]] — Fisherman skill tree nodes
* [[Titles]] — title progression

[[Category:Jobs]]

Hunter

2026-05-27T15:19:02Z

Maintenance script: Fix titles + dev notice

{{Notice|This job page covers the core mechanics. The full [[Skill trees|skill tree]] breakdown, dungeon integration, and advanced strategies are still in development.}}

The '''Hunter''' is one of six [[Jobs|jobs]] on Prosperity SMP. Hunters earn wages by killing hostile mobs. The Hunter career path is combat-focused, designed around mob farming and future dungeon content.

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

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

== Titles ==
{| class="wikitable"
|-
! Level !! Title
|-
| 1 || Novice Hunter
|-
| 10 || Apprentice Hunter
|-
| 20 || Elite Hunter
|-
| 30 || Master Hunter
|-
| 40 || Grand Master Hunter
|-
| 50 || Legendary Hunter
|}

== 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 ==
* [[Jobs]] — overview of all jobs
* [[Skill trees]] — Hunter skill tree nodes
* [[Stipends]] — bonus item drops
* [[Titles]] — title progression

[[Category:Jobs]]

Woodcutter

2026-05-27T15:19:02Z

Maintenance script: Fix titles + dev notice

{{Notice|This job page covers the core mechanics. The full [[Skill trees|skill tree]] breakdown and advanced strategies are still in development.}}

The '''Woodcutter''' is one of six [[Jobs|jobs]] on Prosperity SMP. Woodcutters earn wages by chopping logs in the [[Resource world|resource world]].

== Joining ==
Run <code>/jobs join woodcutter</code> or select Woodcutter from <code>/jobs browse</code>.

== Pay rates ==
Woodcutters earn approximately $0.025 per log chopped. All log types (oak, spruce, birch, jungle, acacia, dark oak, mangrove, cherry, bamboo) qualify.

== Titles ==
{| class="wikitable"
|-
! Level !! Title
|-
| 1 || Novice Woodcutter
|-
| 10 || Apprentice Woodcutter
|-
| 20 || Elite Woodcutter
|-
| 30 || Master Woodcutter
|-
| 40 || Grand Master Woodcutter
|-
| 50 || Legendary Woodcutter
|}

== Prestige ==
The Woodcutter prestige tool is a netherite axe with Efficiency V, Sharpness IV, and Unbreaking V. See [[Prestige]] for costs.

== See also ==
* [[Jobs]] — overview of all jobs
* [[Skill trees]] — Woodcutter skill tree nodes
* [[Titles]] — title progression

[[Category:Jobs]]

Builder

2026-05-27T15:19:01Z

Maintenance script: Fix titles + dev notice

{{Notice|This job page covers the core mechanics. The full [[Skill trees|skill tree]] breakdown and advanced strategies are still in development.}}

The '''Builder''' is one of six [[Jobs|jobs]] on Prosperity SMP. Builders earn wages by placing blocks. Unlike other jobs, Builder income relies heavily on [[Contracts|civic contracts]] rather than per-action wages.

== Joining ==
Run <code>/jobs join builder</code> or select Builder from <code>/jobs browse</code>.

== Pay rates ==
Builders earn approximately $0.015 per block placed. This is intentionally lower than other jobs because Builder income comes primarily from [[Contracts|contracts]].

== Titles ==
{| class="wikitable"
|-
! Level !! Title
|-
| 1 || Novice Builder
|-
| 10 || Apprentice Builder
|-
| 20 || Elite Builder
|-
| 30 || Master Builder
|-
| 40 || Grand Master Builder
|-
| 50 || Legendary Builder
|}

See [[Titles]] for the full title system.

== Prestige ==
The Builder prestige tool is a netherite shovel with Efficiency V and Unbreaking V. See [[Prestige]] for costs.

== See also ==
* [[Jobs]] — overview of all jobs
* [[Contracts]] — civic contract system (primary Builder income)
* [[Zoning regulations]] — building rules by plot type
* [[Titles]] — title progression

[[Category:Jobs]]

Farmer

2026-05-27T15:17:28Z

Maintenance script: Fix titles + add dev notice

{{Notice|This job page covers the core mechanics. Additional details including the full [[Skill trees|skill tree]] node breakdown and advanced strategies are still being developed.}}

The '''Farmer''' is one of six [[Jobs

== Joining ==
jobs]] on Prosperity SMP. Farmers earn wages by harvesting crops. Higher levels unlock [[Drills and harvesters

== Pay rates ==
harvesters]] (3x3 AOE farming tools with auto-replant).

Wages increase by 1% per level (up to +50% at level 50). See [[Jobs]] for the leveling curve.

== Titles ==
{| class="wikitable"
|-
! Level !! Title
|-
| 1 || Novice Farmer
|-
| 10 || Apprentice Farmer
|-
| 20 || Elite Farmer
|-
| 30 || Master Farmer
|-
| 40 || Grand Master Farmer
|-
| 50 || Legendary Farmer
|}

See [[Titles]] for the full title system including [[Prestige|prestige titles]].

== Tools ==
Run <code>/jobs join farmer</code> or select Farmer from <code>/jobs browse</code>.

== Stipends ==
Farmers earn approximately $0.030 per crop harvested. All standard crops (wheat, carrots, potatoes, beetroot, melon, pumpkin, sugar cane, nether wart) qualify.

== Prestige ==
Harvesters are 3x3 AOE hoes purchased with <code>/buyharvester</code>. See [[Drills and harvesters]] for pricing and mechanics.|Farmers have a 7% chance per crop harvested to receive 1 bone meal as a [[Stipends|stipend]] drop.|The Farmer prestige tool is a netherite hoe with Efficiency V and Unbreaking V, with 3x3 AOE farming and auto-replant. See [[Prestige]] for the full cost table and [[Drills and harvesters]] for tool details.

== See also ==
* [[Jobs]] — overview of all jobs
* [[Drills and harvesters]] — AOE tool mechanics
* [[Skill trees]] — per-job perks
* [[Prestige]] — prestige system

[[Category:Jobs]]

Miner

2026-05-27T15:17:10Z

Maintenance script: Fix titles to Novice->Legendary

The '''Miner''' is one of six [[Jobs|jobs]] on Prosperity SMP. Miners earn wages by breaking stone, ores, and deepslate in the [[Resource world|resource world]]. Higher levels unlock [[Drills and harvesters|drills]] (3x3 AOE mining tools), [[Master Smith]] enchant upgrades, and access to the [[Prestige|prestige system]].

== Joining ==
Run <code>/jobs join miner</code> or select Miner from <code>/jobs browse</code>.

== Pay rates ==
Miners earn per block broken. Wages increase by 1% per level (up to +50% at level 50).

{| class="wikitable"
|-
! Block !! Base wage
|-
| Stone, deepslate, granite, diorite, andesite || $0.035
|-
| Cobblestone || $0.025
|-
| End stone || $0.040
|-
| Coal ore || $0.040
|-
| Iron ore || $0.040
|-
| Gold ore || $0.040
|-
| Diamond ore || $0.040
|-
| Sandstone, red sandstone || $0.025
|}

Income also comes from selling materials at the [[Admin shop]] or player [[ChestShop|shops]], and from [[Contracts|civic contracts]].

== Titles ==
{| class="wikitable"
|-
! Level !! Title
|-
| 1 || Novice Miner
|-
| 10 || Apprentice Miner
|-
| 20 || Elite Miner
|-
| 30 || Master Miner
|-
| 40 || Grand Master Miner
|-
| 50 || Legendary Miner
|}

See [[Titles]] for the full title system including [[Prestige|prestige titles]].

== Drills ==
Drills are 3x3 AOE pickaxes purchased with <code>/buydrill</code> and gated by Miner level.

{| class="wikitable"
|-
! Tier !! Name !! Level !! Price !! Base !! Enchants
|-
| 1 || Compact Drill || 15 || $1,000 || Iron pickaxe || Efficiency III, Unbreaking IV
|-
| 2 || Industrial Drill || 30 || $4,000 || Diamond pickaxe || Efficiency IV, Unbreaking III, Fortune I
|-
| 3 || Apex Drill || 45 || $6,500 || Netherite pickaxe || Efficiency V, Unbreaking IV, Fortune II
|}

Drills work only in the resource world, nether, and end. See [[Drills and harvesters]] for full mechanics.

== Master Smith ==
The [[Master Smith]] is an upgrade station at the Job Center offering elevated enchant levels.

=== Books (applied via anvil) ===
{| class="wikitable"
|-
! Tier !! Book !! Gate !! Cost
|-
| 1 || Efficiency VII || [[Skill trees|Skill tree]] node (L35+) || $10,000 + 5 diamond blocks
|-
| 1 || Fortune V || Skill tree node (L45+) || $12,000 + 5 diamond blocks
|-
| 2 || Efficiency VIII || [[Prestige]] P2 (Twice-Forged) || $35,000 + 12 diamond blocks
|-
| 2 || Fortune VI || Prestige P2 || $40,000 + 12 diamond blocks
|-
| 3 || Efficiency IX || Prestige P4 (Mythic) || $100,000 + 20 diamond blocks
|-
| 3 || Fortune VII || Prestige P4 || $120,000 + 20 diamond blocks
|}

== Prestige tools ==
Each prestige tier grants a named prestige pickaxe (Efficiency V, Fortune III, Unbreaking V on netherite). The name and color change per tier but base enchants are the same. Stat progression comes from Master Smith books.

{| class="wikitable"
|-
! Tier !! Tool name !! Master Smith unlock
|-
| P1 || Reborn Drill || Base books
|-
| P2 || Twice-Forged Drill || Tier 2 books
|-
| P3 || Thrice-Forged Drill || —
|-
| P4 || Mythic Drill || Tier 3 books
|-
| P5 || Eternal Drill || —
|}

== Stipends ==
Miners have a 20% chance per block broken to receive 1 gunpowder as a stipend drop (resource world only). See [[Stipends]].

== See also ==
* [[Jobs]] — overview of all jobs
* [[Drills and harvesters]] — full drill and harvester mechanics
* [[Master Smith]] — enchant upgrade station
* [[Skill trees]] — Miner skill tree nodes
* [[Prestige]] — prestige system
* [[Resource world]] — where to mine

[[Category:Jobs]]

Jobs

2026-05-27T15:16:40Z

Maintenance script: Fix titles to Novice->Legendary + add /title command

'''Jobs''' are the primary way to earn money on Prosperity SMP. The server runs six careers through the Jobs Reborn plugin, each paying wages for specific in-game actions. Players can hold one job at a time and switch freely with a 60-second cooldown.

== Available jobs ==
{| class="wikitable" style="width:100%;"
|-
! Job !! Pays for !! Starting wage !! Key unlocks
|-
| [[Miner]] || Breaking stone, ores, deepslate || ~$0.035/block || Drills (L15/L30/L45), Master Smith (L35+)
|-
| [[Farmer]] || Harvesting crops || ~$0.030/block || Harvesters (L15/L30/L45)
|-
| [[Builder]] || Placing blocks || ~$0.015/block || Civic contracts (primary income)
|-
| [[Woodcutter]] || Chopping logs || ~$0.025/block || Tree-felling upgrades
|-
| [[Hunter]] || Killing hostile mobs || ~$0.50/kill || Dungeon access, combat gear
|-
| [[Fisherman]] || Catching fish || ~$0.30/catch || Rod enchants, rare-fish perks
|}

Wages increase by 1% per level, up to +50% at level 50. Real income also includes item drops, [[Admin shop]] sales, [[Contracts|contracts]], and stipends.

== How jobs work ==
# Run <code>/jobs browse</code> to see available jobs.
# Click a job to join it, or run <code>/jobs join <name></code>.
# Perform qualifying actions to earn wages and XP.
# Level up to unlock new perks, [[Titles|titles]], and equipment.
# At level 50, you can [[Prestige|prestige]] to reset and earn permanent bonuses.

== Leveling ==
Each level requires a fixed amount of XP. The curve is near-linear — level 50 takes approximately 50 hours of active work.

{| class="wikitable"
|-
! Milestone !! Approximate time
|-
| Level 10 || 2-3 hours
|-
| Level 20 || 7-10 hours
|-
| Level 30 || 18-25 hours
|-
| Level 40 || 32-40 hours
|-
| Level 50 || ~50 hours
|}

== Titles ==
All six jobs share the same title progression. Titles display in chat and the tab list.

{| class="wikitable"
|-
! Level !! Title !! Color
|-
| 1 || Novice || Gray
|-
| 10 || Apprentice || Blue
|-
| 20 || Elite || Purple
|-
| 30 || Master || Pink
|-
| 40 || Grand Master || Yellow
|-
| 50 || Legendary || Gold
|}

Use <code>/title <job></code> to pin a specific title, or <code>/title auto</code> to show your highest. See [[Titles]] for details.

[[Prestige]] titles (Reborn, Twice-Forged, Thrice-Forged, Mythic, Eternal) outrank regular titles.

== Prestige ==
At level 50, run <code>/prestige <job></code> to reset to level 1 with permanent bonuses. See [[Prestige]] for the full cost table.

== Commands ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/jobs browse</code> || View and join available jobs
|-
| <code>/jobs info</code> || See your current job stats
|-
| <code>/jobs leave</code> || Leave your current job
|-
| <code>/jobs top</code> || Leaderboard by job level
|-
| <code>/prestige <job></code> || Prestige a maxed job
|-
| <code>/title <job></code> || Pin a title to display
|}

== See also ==
* [[Skill trees]] — per-job perk unlocks
* [[Contracts]] — bonus income from deliveries
* [[Crates]] — loot from job crates
* [[Titles]] — title progression details
* [[Drills and harvesters]] — AOE tools for Miners and Farmers

[[Category:Gameplay]]

Titles

2026-05-27T15:16:06Z

Maintenance script: Fix title progression to match in-game (Novice->Legendary)

'''Titles''' are chat prefixes that display before a player name in chat and the tab list. They are earned through [[Jobs|job leveling]] and the [[Prestige|prestige system]].

== Job titles ==
Every job shares the same six-tier title progression. The title displays as the tier name followed by the job name (e.g., [Novice Miner], [Legendary Farmer]).

{| class="wikitable"
|-
! Level !! Title !! Color
|-
| 1 || Novice || Gray
|-
| 10 || Apprentice || Blue
|-
| 20 || Elite || Purple
|-
| 30 || Master || Pink
|-
| 40 || Grand Master || Yellow
|-
| 50 || Legendary || Gold
|}

All six jobs ([[Miner]], [[Farmer]], [[Builder]], [[Woodcutter]], [[Hunter]], [[Fisherman]]) use this same progression. The title updates automatically on level-up.

== Prestige titles ==
[[Prestige]] titles outrank all regular job titles. When a player prestiges, their chat prefix changes to the prestige tier name.

{| class="wikitable"
|-
! Tier !! Title prefix !! Color !! Example
|-
| P1 || Reborn || Gold || [Reborn Miner]
|-
| P2 || Twice-Forged || Dark purple || [Twice-Forged Miner]
|-
| P3 || Thrice-Forged || Pink || [Thrice-Forged Miner]
|-
| P4 || Mythic || Red || [Mythic Miner]
|-
| P5 || Eternal || Dark red || [Eternal Miner]
|}

== Choosing a title ==
If you have multiple jobs or want to display a specific title:
* <code>/title</code> — list your unlocked titles
* <code>/title <job></code> — pin a specific job title
* <code>/title auto</code> — revert to showing your highest-tier title automatically

== How titles display ==
Titles appear in chat messages, the tab list, and name tags above the player. The system uses LuckPerms prefixes and updates without requiring a relog.

== See also ==
* [[Jobs]] — leveling and title unlocks
* [[Prestige]] — prestige tier titles

[[Category:Gameplay]]

Consumer Price Index

2026-05-27T15:15:21Z

Maintenance script: Initial content

The '''Consumer Price Index''' (CPI) is a custom-built price tracking system on Prosperity SMP. It measures the cost of a fixed basket of goods using real player-to-player trade data, producing a single index number that represents the overall price level of the server economy. The CPI feeds directly into the [[Monetary policy engine]] and is reported weekly to the community via Discord.

== What the CPI measures ==
The CPI tracks the price of a weighted basket of 27 common items across five categories. It answers the question: "Are things getting more or less expensive on the server?"

A rising CPI means prices are going up (inflation). A falling CPI means prices are dropping (deflation). A stable CPI means the economy is in equilibrium.

== Basket composition ==
The policy CPI basket is weighted to reflect typical player spending patterns:

{| class="wikitable" style="width:100%;"
|-
! Category !! Weight !! Items
|-
| Building materials || 20% || Cobblestone, stone, deepslate, sand, gravel, logs, planks, sandstone, glass, bricks
|-
| Basic inputs || 30% || Iron ingot (12%), coal (6%), copper ingot (4%), gold ingot (4%), redstone (4%)
|-
| Food and farming || 20% || Wheat, potato, carrot, cooked beef, cooked chicken, cooked porkchop, sugar cane, paper
|-
| Utility consumables || 15% || Arrow, torch, firework rocket, lapis lazuli
|-
| Premium commodities || 15% || Diamond (8%), emerald (3%), netherite scrap (4%)
|}

Diamond is weighted at 8%, not 30% — the basket is deliberately tilted toward everyday staples rather than luxury items. A few large diamond trades should not distort the overall price signal.

== Index formula ==
The CPI uses a '''winsorized geometric mean''', the same mathematical approach used by real-world national statistics offices:

: '''P = exp( SUM of weight_i x ln(price_i_trimmed) )'''

Where each item price is winsorized (extreme outliers in the top and bottom 10% are clamped) before the geometric mean is computed. This prevents a single unusual trade from skewing the index.

== Data source ==
The CPI is computed exclusively from '''completed, non-simulated, player-to-player''' [[ChestShop]] transactions:

* Only real trades between players count. [[Simulated ChestShop]] activity is excluded.
* Only completed sales count. Listed prices (signs with no actual purchase) are tracked separately and do not affect the policy CPI.
* The rolling window covers the last 7 days of trade data.

This separation prevents a feedback loop where the [[Simulated ChestShop|Sim Shop]] buying activity inflates the CPI, causing the Sim Shop to buy at higher prices, causing CPI to rise further.

== Manipulation defenses ==
The CPI includes several custom-built defenses against price manipulation:

=== Depth gates ===
An item is excluded from the policy basket if it does not meet minimum thresholds:
* At least 10 transactions in the 7-day window
* At least 3 unique buyers
* At least 3 unique sellers

Items below these thresholds still appear in the <code>/market</code> command with a low-confidence flag, but they do not influence the engine.

=== Rate-of-change clamp ===
No item can move the CPI by more than 8% per week. If an item price jumps more than 8% from the prior week, the excess is attributed to possible manipulation and dampened.

=== Manipulation risk score ===
Each item receives a composite risk score based on five factors (each weighted equally at 0.20):

# Low transaction count (fewer than 10)
# Low buyer diversity (fewer than 3 unique buyers)
# Low seller diversity (fewer than 3 unique sellers)
# Account concentration (one account responsible for more than 60% of trade volume)
# Category outlier (item moved more than 2 standard deviations from its category average)

When the risk score exceeds 0.5, the system applies asymmetric trust dampening — upward price moves are partially discounted while downward moves are trusted at face value. This reflects the reality that most market manipulation in Minecraft economies is bullish (inflating prices to profit from the Sim Shop).

=== Median lag ===
The [[Simulated ChestShop]] reads a CPI snapshot that is '''7 days old''', not the current snapshot. This means a manipulator would need to sustain artificial prices for over a week before the Sim Shop adjusts — raising the cost and risk of manipulation.

== Per-item confidence ==
Each item in the basket receives its own confidence score:

: '''confidence = sqrt(depth_score x diversity_score)'''

Where depth_score reflects transaction count (maxes at 50 trades) and diversity_score reflects unique participant count (maxes at 8 unique buyers + sellers). Items with low confidence contribute less to the overall basket index.

== Player-facing: /market command ==
Players can check current market prices using <code>/market</code>:

{| class="wikitable"
|-
! Command !! What it shows
|-
| <code>/market</code> || Top 10 items by total dollar volume traded (last 7 days)
|-
| <code>/market <item></code> || Median price, fair range (25th-75th percentile), volume, category
|}

The <code>/market</code> command shows real player-to-player data only. It does '''not''' reveal the Sim Shop buy price, CentralBank balance, or engine recommendations.

== Weekly Discord report ==
Every Monday at midnight, an automated report posts to the server Discord with:
* Total items traded and turnover
* Top 10 items by value
* Per-item median prices

This report uses the same data pipeline as the policy CPI but is formatted as a public-facing summary.

== Commodity index ==
In addition to the policy CPI (which drives the [[Monetary policy engine]]), the system computes a separate '''commodity index''' tracking premium items (diamond, gold, netherite, emerald, ancient debris). This index is for dashboard display only and does not influence policy decisions.

== See also ==
* [[Monetary policy engine]] — the system that consumes the CPI
* [[Economy]] — how the economy works
* [[Simulated ChestShop]] — the market activity system (excluded from CPI)
* [[Trading]] — how trading works on the server
* [[ChestShop]] — the shop system that generates CPI data

[[Category:Systems]]

Monetary policy engine

2026-05-27T15:15:20Z

Maintenance script: Initial content

The '''monetary policy engine''' is a custom-built automated economic management system on Prosperity SMP. It tracks every dollar created and destroyed on the server, computes real-time inflation metrics, and generates policy recommendations to maintain a healthy economy. It is believed to be the first implementation of classical monetary theory applied to a live Minecraft server economy.

== Overview ==
The engine applies the '''quantity theory of money''' — the same framework used by real-world central banks — to the server economy:

<blockquote>
'''M x V = P x Q'''

Where M = money supply, V = velocity (turnover rate), P = price level ([[Consumer Price Index|CPI]]), and Q = real output (goods traded).
</blockquote>

If money supply grows faster than real output, prices must rise (inflation). If it grows slower, prices fall (deflation). The engine measures these forces in real time and recommends adjustments to keep the economy stable.

== Architecture ==
The system operates across two custom-built layers, both developed specifically for Prosperity SMP.

=== Skript capture layer ===
Custom Skript files running on the Minecraft server capture every money flow event in real time:

* '''treasury-grant.sk''' — a single entry point for all money creation events. Every script that pays a player routes through this wrapper, ensuring no money enters circulation without being tracked.
* '''money-supply.sk''' — classifies every Vault transaction into a five-category taxonomy, computes money supply decomposition with exponential activity decay, and runs stock-flow reconciliation.
* '''cpi-basket.sk''' — computes a winsorized geometric mean Consumer Price Index from real player-to-player trade data, with built-in manipulation defenses.

=== Admin Hub controller layer ===
A TypeScript module in the custom Next.js Admin Hub ingests Skript-exported JSON and runs the policy controller:

* Computes EWMA-smoothed inflation gap
* Evaluates confidence from data maturity, sample depth, and participant diversity
* Applies proportional control with locked safety bounds
* Generates recommendations with reasoning traces and uncertainty bands
* Persists an audit log for historical analysis and future regression

== Event taxonomy ==
Every balance change on the server is classified into exactly one of five categories:

{| class="wikitable" style="width:100%;"
|-
! Category !! Definition !! Effect on money supply
|-
| '''CREATE''' || Money appears from nowhere (job wages, contract rewards, crate cash, /eco give) || Increases total supply
|-
| '''DESTROY''' || Money disappears (admin shop purchases, fees, /eco take) || Decreases total supply
|-
| '''TRANSFER_TO_PUBLIC''' || System account pays a player ([[Simulated ChestShop|Sim Shop]] payouts) || No change (reserve to active)
|-
| '''TRANSFER_FROM_PUBLIC''' || Player pays a system account (rent to system landlord) || No change (active to reserve)
|-
| '''TRANSFER_PRIVATE''' || Player pays another player ([[ChestShop]] sales, /pay) || No change (changes hands)
|}

Only CREATE and DESTROY events change the total money supply. Transfers redistribute existing money.

== Money supply decomposition ==
The engine does not treat all money equally. It decomposes the total into three buckets:

{| class="wikitable"
|-
! Bucket !! Definition !! Policy relevance
|-
| '''M_active''' || Balances of recently active players, weighted by exponential decay || The money actively chasing goods — the primary inflation signal
|-
| '''M_dormant''' || Balances of players inactive for 14+ days || Not circulating; a returning player creates a liquidity shock
|-
| '''M_reserve''' || CentralBank and system accounts || Sterilized reserve — only inflationary when disbursed
|}

The effective money supply formula:

: '''M_effective = M_active + (0.20 x M_dormant) + (lambda x M_reserve)'''

Where lambda forecasts how much reserve money will enter circulation in the next 7 days. The activity decay uses an exponential curve:

: '''weight = max(0.05, e^(-days_since_login / 14))'''

This prevents the engine from panicking when a large dormant balance reactivates.

== Stock-flow reconciliation ==
An hourly integrity check verifies that the tracked events match reality:

: '''Change in M_total = SUM of CREATE - SUM of DESTROY'''

If observed and predicted totals diverge by more than 2%, the engine disables all recommendations and flags the discrepancy. This prevents acting on bad data.

== Controller design ==
The v1 controller uses a '''proportional-only''' formula with conservative tuning:

: '''new_multiplier = old_multiplier x (1 - confidence x K_p x gap)'''

Where:
* '''gap''' = observed weekly CPI growth minus admin-set target (decimal form)
* '''K_p''' = 0.20 (proportional gain constant)
* '''confidence''' = data quality score from 0 to 1

Safety bounds:
* Maximum weekly change: +/- 5%
* Multiplier range: 0.7 to 1.3
* Dead-band: if gap is smaller than 0.3%, the engine outputs NO_OP

The controller is '''advisory only''' in v1. Recommendations require manual admin approval. Auto-application requires confidence above 0.70 for four consecutive weeks.

== Confidence scoring ==
The confidence score is a geometric mean of four components, each bounded between 0.1 and 1.0:

{| class="wikitable"
|-
! Component !! What it measures !! Maximum (1.0) when
|-
| Basket coverage || Fraction of CPI basket items with valid data || All basket items have enough trades
|-
| Sample depth || Average transactions per basket item || 50+ transactions per item
|-
| Diversity || Number of unique buyers and sellers || 8+ unique participants
|-
| Maturity || Time since server deploy || 90+ days of operation
|}

: '''confidence = (coverage x depth x diversity x maturity) ^ (1/4)'''

The geometric mean prevents any single component from dominating — all four must be healthy for confidence to be high.

== NO_OP conditions ==
The engine outputs no action when any of:

# Confidence below 0.30
# Gap within dead-band (+/- 0.3%)
# Reconciliation failing
# Fewer than 5 active players
# Previous action not yet observed (one-week cooldown)
# New-player spike (3+ new players in 48 hours)
# Within first 14 days of operation (Phase A bootstrap)

NO_OP is the most common output on a small server. The engine is designed to be cautious.

== Bootstrap schedule ==
{| class="wikitable"
|-
! Period !! Behavior
|-
| Day 0-14 || Advisory disabled. Dashboards live. Data collection running.
|-
| Day 14-30 || Advisory enabled with confidence scaling. No auto-apply.
|-
| Day 30-90 || Perturbation experiments to measure actuator response.
|-
| Day 90+ || Auto-apply eligible if confidence sustained above 0.70.
|}

== Source-flow ratios ==
The engine computes diagnostic ratios displayed in the Admin Hub Treasury panel:

{| class="wikitable"
|-
! Ratio !! What it measures
|-
| '''sink_ratio''' || How fast money is removed from circulation
|-
| '''bank_drain_ratio''' || How fast the bank injects liquidity into player hands
|-
| '''jobs_faucet_ratio''' || Job wage intensity relative to active money pool
|}

== Design process ==
The engine was designed through a five-round iterative critique between two AI systems (Claude and ChatGPT), correcting three material design flaws in the original draft:

# CentralBank balance incorrectly counted as active money (corrected to sterilized reserve with lambda-weighted forecast)
# Policy response was inverted — raising the target during inflation is accommodation, not control (corrected to proportional tightening)
# "Deflation via fewer purchases" was a misnomer — reducing the faucet slows growth but does not contract existing supply (corrected to "disinflation")

The full technical spec is maintained in the server's internal documentation.

== See also ==
* [[Consumer Price Index]] — the CPI basket the engine consumes
* [[Economy]] — how money flows through the server
* [[Simulated ChestShop]] — the bank-funded market activity system
* [[Admin shop]] — server-run shop (a money sink)
* [[Prestige]] — endgame money sink

[[Category:Systems]]

Main Page

2026-05-27T15:07:59Z

Maintenance script: Add Simulated ChestShop to plugins table

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

Simulated ChestShop

2026-05-27T15:06:41Z

Maintenance script: Initial content

The '''Simulated ChestShop''' system is an automated market activity engine on Prosperity SMP. It creates background buying activity at player-owned [[ChestShop]] signs, ensuring that shops see regular traffic even during low-population hours. The system is designed to be invisible to players — it behaves like a normal customer.

== Purpose ==
At low player counts, player shops can sit idle for hours with no buyers. 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 does '''not''' sell items to players. It only buys. This makes it a pure money faucet into player hands, funded by the CentralBank reserve.

== How it works ==
# The system maintains a shopping list of common items it is willing to buy.
# Every few minutes, it scans active player [[ChestShop]] signs for eligible items.
# If a shop is selling an item on the shopping list at a reasonable price, the system may purchase from it.
# The shop owner receives payment to their balance, just like a normal sale.
# The 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. The system uses randomized persona names in logs to avoid easy identification.

== What the system buys ==
The shopping list includes common economy staples:

{| class="wikitable"
|-
! Category !! Example items
|-
| Mining || Cobblestone, stone, deepslate, iron ingot, gold ingot, diamond, coal, redstone, lapis lazuli, copper ingot
|-
| 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
|}

Each item has a maximum buy price based on the server's market data. The system will not overpay — if a shop prices above the fair range, the system skips it.

== Demand governor ==
The system has built-in controls to prevent it from dominating the market:

; Daily spending cap
: The bank has a maximum daily spend limit across all purchases. Once the cap is reached, the system pauses until the next day.

; Per-shop cooldowns
: After buying from a shop, the system waits before buying from the same shop again.

; Per-owner caps
: No single shop owner receives more than a set percentage of the daily budget.

; Intensity profiles
: Activity levels adjust based on time of day and player count. During peak hours with many real buyers, the system backs off. During off-peak hours, it increases activity to keep the market moving.

== Relationship to the economy ==
Simulated ChestShop activity is tracked separately from real player-to-player trades in the server's economic monitoring systems:

* Simulated transactions are marked with a <code>simulated: true</code> flag in the transaction log.
* The [[Economy|CPI (Consumer Price Index)]] calculation '''excludes''' simulated transactions. CPI reflects real player-to-player prices only.
* The [[Economy|monetary policy engine]] classifies bank-to-player payouts as transfers from the public reserve, not new money creation. The money was already created when an admin funded the CentralBank.

This separation prevents a feedback loop where the bank's buying activity inflates the CPI, which then causes the bank to buy at higher prices.

== Visibility ==
The system is intentionally invisible to players:

* No public <code>/market</code> command reveals the bank's exact buy prices or shopping list.
* Transaction log entries use randomized persona names.
* The [[Economy|/market command]] shows real player-to-player CPI data only, not bank activity.
* Shop owners see normal sale notifications — they cannot distinguish a simulated purchase from a real one.

Admins can monitor and configure the system through the <code>/simshop</code> command (staff only).

== Admin commands ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/simshop status</code> || View bank balance, daily spend, and pause state
|-
| <code>/simshop pause</code> || Temporarily pause all activity
|-
| <code>/simshop resume</code> || Resume activity
|-
| <code>/simshop refill <amount></code> || Add funds to the CentralBank
|}

These commands require staff permissions and are not available to regular players.

== See also ==
* [[Economy]] — how the economy works, including money flow and inflation
* [[ChestShop]] — how to create player shops
* [[Admin shop]] — the server-run shop (separate system)
* [[Trading]] — trading methods and price discovery
* [[Getting started]] — includes shop setup guide

[[Category:Plugins]]

Main Page

2026-05-27T15:05:32Z

Maintenance script: Expand quick links with new pages

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

Titles

2026-05-27T15:04:26Z

Maintenance script: Initial content

'''Titles''' are chat prefixes that display before a player's name in chat and the tab list. They are earned through [[Jobs|job leveling]] and the [[Prestige|prestige system]].

== Job titles ==
Every 10 [[Jobs|job levels]], a new title unlocks. Titles are job-specific — each career has its own title progression.

=== Miner titles ===
{| class="wikitable"
|-
! Level !! Title
|-
| 1 || Stonehand
|-
| 10 || Cavehand
|-
| 20 || Chartered Miner
|-
| 30 || Deepworks Operator
|-
| 40 || Master Prospector
|-
| 50 || Titan of the Deep
|}

=== Other job titles ===
Each of the six jobs ([[Miner]], [[Farmer]], [[Builder]], [[Woodcutter]], [[Hunter]], [[Fisherman]]) has its own progression of six titles at levels 1, 10, 20, 30, 40, and 50. View your current title via <code>/jobs info</code>.

== Prestige titles ==
[[Prestige]] titles outrank all regular job titles. When a player prestiges, their chat prefix changes to reflect the prestige tier.

{| class="wikitable"
|-
! Tier !! Title prefix !! Color !! Example
|-
| P1 || Reborn || Gold || [Reborn Miner]
|-
| P2 || Twice-Forged || Dark purple || [Twice-Forged Miner]
|-
| P3 || Thrice-Forged || Pink || [Thrice-Forged Miner]
|-
| P4 || Mythic || Red || [Mythic Miner]
|-
| P5 || Eternal || Dark red || [Eternal Miner]
|}

Prestige titles combine the tier prefix with the job name. A player with multiple prestige jobs displays the title of their currently-held job.

== How titles display ==
Titles appear in:
* Chat messages (before the player name)
* Tab list (player list when pressing Tab)
* Name tags above the player's head

The title system uses LuckPerms prefixes. Titles update automatically on level-up and prestige without requiring a relog.

== See also ==
* [[Jobs]] — leveling and title unlocks
* [[Prestige]] — prestige tier titles
* [[Getting started]] — new player guide

[[Category:Gameplay]]

Stipends

2026-05-27T15:04:09Z

Maintenance script: Initial content

'''Stipends''' are random bonus item drops that [[Jobs|job]] workers receive while performing their job's actions. They supplement the crafting economy by providing useful materials that might otherwise be scarce.

== How stipends work ==
While performing job-qualifying actions, there is a small chance per action to receive a bonus item. Stipends drop directly into the player's inventory with an action bar notification.

Stipends only drop in the resource world, nether, and end — not in the main world.

== Stipend table ==
{| class="wikitable" style="width:100%;"
|-
! Job !! Trigger !! Drop !! Chance !! Purpose
|-
| [[Miner]] || Breaking stone or ore || 1 gunpowder || 20% || Supplies TNT and firework rocket crafting
|-
| [[Farmer]] || Harvesting crops || 1 bone meal || 7% || Crop growth acceleration
|-
| [[Hunter]] || Killing hostile mobs || 2 arrows || 10% || Ranged combat supply
|}

[[Builder]], [[Woodcutter]], and [[Fisherman]] do not currently have stipend drops.

== Cooldowns ==
Farmer and Hunter stipends have a 2-second per-player cooldown to prevent burst drops from automated systems or AOE tools. The Miner stipend has no cooldown — each block in a [[Drills and harvesters|drill]] swing rolls independently, so a single drill swing can produce multiple gunpowder drops.

== Economy role ==
Stipends act as a passive supply faucet for materials that are important to the [[Economy]] but not directly farmable through normal job actions. Gunpowder in particular supports both firework rocket production (elytra flight fuel) and TNT crafting.

== See also ==
* [[Jobs]] — job system overview
* [[Miner]] — gunpowder stipend details
* [[Economy]] — how stipends fit into the money flow

[[Category:Gameplay]]

Trading

2026-05-27T15:03:46Z

Maintenance script: Initial content

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

=== Direct payment ===
Use <code>/pay <player> <amount></code> to send money directly. Useful for custom deals, service payments, or trades negotiated in chat.

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

== Price discovery ==
; /market command
: Run <code>/market <item></code> to see the median unit price based on recent player-to-player [[ChestShop]] transactions. 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.
# 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.

== 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.
* There is no trade window or escrow system. For high-value trades, use <code>/pay</code> and item handoff in person, or set up matching ChestShop signs.

== See also ==
* [[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]]

Resource world

2026-05-27T15:03:22Z

Maintenance script: Initial content

The '''resource world''' is a separate world on Prosperity SMP dedicated to mining, farming, and gathering. It exists to keep the main world clean while providing renewable resources for the [[Economy|economy]].

== Accessing the resource world ==
* Run <code>/rtp</code> to teleport to a random location in the resource world.
* Use the resource world portal at spawn.
* Set a <code>/sethome</code> in the resource world to return to a specific spot.

== Rules ==
{| class="wikitable"
|-
! Rule !! Status
|-
| No claims or permanent builds || Enforced — resource world is for extraction only
|-
| Keep inventory on death || '''Off''' — you drop items on death in the resource world
|-
| AFK farming || Prohibited server-wide
|-
| Spawner breaking || Prohibited — spawners are protected
|-
| PvP || Allowed (default vanilla rules)
|}

== What to gather ==
The resource world contains all vanilla biomes and resources:
* Stone, deepslate, and ores (primary [[Miner]] income)
* Trees and logs ([[Woodcutter]])
* Crops and farmland ([[Farmer]])
* Hostile mobs ([[Hunter]])
* Fishing spots ([[Fisherman]])

== Nether and End ==
The nether and end are accessible through portals in the resource world:
* '''Nether:''' contains nether-exclusive resources including ancient debris, glowstone, and quartz. Access via nether portal.
* '''The End:''' contains end cities, shulker boxes, and elytra. Access via the stronghold.

== Tips ==
* Always carry a bed to set your spawn point in the resource world. Dying without a bed sends you back to the main world spawn.
* Bring food and basic tools before exploring. Keep inventory is off — death costs you everything on you.
* Use <code>/sethome resource</code> near a good mining area to return easily.
* [[Drills and harvesters|Drills]] work in the resource world, nether, and end but not in the main world.

== See also ==
* [[Getting started]] — includes resource world introduction
* [[Miner]] — primary resource world career
* [[Drills and harvesters]] — AOE tools for the resource world
* [[Server rules]] — resource world conduct rules

[[Category:Gameplay]]

Drills and harvesters

2026-05-27T15:02:53Z

Maintenance script: Initial content

'''Drills''' and '''harvesters''' are custom 3x3 AOE tools on Prosperity SMP. Drills break a 9-block area of stone and ore for [[Miner|Miners]]; harvesters break a 9-crop area with auto-replant for [[Farmer|Farmers]]. They are the primary upgrade path for both careers.

== Drills ==
Drills are AOE pickaxes purchased with <code>/buydrill</code>. They require a minimum [[Jobs|Miner level]] to purchase.

{| class="wikitable" style="width:100%;"
|-
! Tier !! Name !! Level !! Price !! Base material !! Efficiency !! Unbreaking !! Fortune !! Effective blocks
|-
| 1 || Compact Drill || 15 || $1,000 || Iron pickaxe || III || IV || — || ~11,250
|-
| 2 || Industrial Drill || 30 || $4,000 || Diamond pickaxe || IV || III || I || ~56,000
|-
| 3 || Apex Drill || 45 || $6,500 || Netherite pickaxe || V || IV || II || ~91,000
|}

=== How drills work ===
* Each swing breaks the center block normally plus 8 surrounding blocks.
* Only the center block consumes durability. The surrounding blocks are free.
* [[Jobs]] wages are paid only for the center block. Drill value comes from 9x material yield, not wage multiplication.
* Fortune enchants apply to all 9 blocks.
* Drills only activate in the resource world, nether, and end. They are disabled in the main world to prevent plot damage.

=== Repairing ===
Drills are repairable via standard anvil using the matching ingot (iron for Compact, diamond for Industrial, netherite for Apex). [[Master Smith]] books can also be applied to drills through the anvil.

== Harvesters ==
Harvesters are AOE hoes purchased with <code>/buyharvester</code>. They require a minimum [[Jobs|Farmer level]].

{| class="wikitable" style="width:100%;"
|-
! Tier !! Name !! Level !! Price !! Base material !! Efficiency !! Unbreaking
|-
| 1 || Compact Harvester || 15 || $1,000 || Iron hoe || III || III
|-
| 2 || Industrial Harvester || 30 || $2,500 || Diamond hoe || IV || III
|-
| 3 || Apex Harvester || 45 || $5,000 || Netherite hoe || V || III
|}

=== How harvesters work ===
* Each swing harvests the center crop plus 8 surrounding crops.
* Harvested crops are auto-replanted.
* Only fully-grown crops trigger the harvester. Breaking unripe crops does not pay wages.
* Harvesters work anywhere the player has block-break permissions.

== Prestige tools ==
At [[Prestige|prestige]] P1, each career receives a prestige-tier version of their AOE tool:

{| class="wikitable"
|-
! Job !! Tool !! Enchants
|-
| Miner || Reborn Drill (P1) through Eternal Drill (P5) || Efficiency V, Fortune III, Unbreaking V
|-
| Farmer || Reborn Harvester (P1) through Eternal Harvester (P5) || Efficiency V, Unbreaking V
|}

Prestige tools are soulbound (never drop on death) and use a netherite base. The tool name and color escalate per prestige tier but the base enchants are the same. Further upgrades come from [[Master Smith]] books.

== Value comparison ==
{| class="wikitable"
|-
! Drill !! Cost !! Effective blocks !! Cost per block
|-
| Compact || $1,000 || ~11,250 || $0.089
|-
| Industrial || $4,000 || ~56,000 || $0.071
|-
| Apex || $6,500 || ~91,000 || $0.071
|-
| Prestige (any tier) || free || ~110,000 || —
|}

Industrial and Apex have identical cost-per-block, but Apex additionally has Fortune II and higher Efficiency, making it significantly better for ore mining.

== Commands ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/buydrill <1 or 2 or 3></code> || Purchase a drill
|-
| <code>/buyharvester <1 or 2 or 3></code> || Purchase a harvester
|}

== See also ==
* [[Miner]] — Miner career path
* [[Farmer]] — Farmer career path
* [[Master Smith]] — enchant upgrade station (books work on drills)
* [[Prestige]] — prestige-tier tools
* [[Jobs]] — job system overview

[[Category:Gameplay]]

Master Smith

2026-05-27T15:02:22Z

Maintenance script: Initial content

The '''Master Smith''' is an upgrade station at the Job Center on Prosperity SMP. It allows [[Miner|Miners]] to apply elevated enchant levels to pickaxes and purchase enchanted books above the vanilla cap.

== Location ==
The Master Smith is a clickable sign at the Job Center building. Right-click the <code>[Master Smith]</code> sign or run <code>/smithy</code> from anywhere.

== Services ==

=== Direct pickaxe upgrades ===
Hold a vanilla pickaxe (not a [[Drills and harvesters|drill]]) and apply an upgrade directly.

{| class="wikitable"
|-
! Enchant !! Skill tree node required !! Cost
|-
| Efficiency VII || <code>efficiency_path</code> (Miner L35+) || $5,000 + 3 diamond blocks + 8 iron blocks
|-
| Fortune V || <code>prospector_path</code> (Miner L45+) || $5,000 + 3 diamond blocks + 8 gold blocks
|}

Direct upgrades preserve all existing enchants on the pickaxe.

=== Enchanted books ===
Books can be applied to any pickaxe (including [[Drills and harvesters|drills]]) via standard anvil.

{| class="wikitable"
|-
! Tier !! Book !! Gate !! Cost
|-
| rowspan="2" | 1 || Efficiency VII || [[Skill trees|Skill tree]] node || $10,000 + 5 diamond blocks
|-
| Fortune V || Skill tree node || $12,000 + 5 diamond blocks
|-
| rowspan="2" | 2 || Efficiency VIII || [[Prestige]] P2 (Twice-Forged) || $35,000 + 12 diamond blocks
|-
| Fortune VI || Prestige P2 || $40,000 + 12 diamond blocks
|-
| rowspan="2" | 3 || Efficiency IX || Prestige P4 (Mythic) || $100,000 + 20 diamond blocks
|-
| Fortune VII || Prestige P4 || $120,000 + 20 diamond blocks
|}

Efficiency IX allows instamining deepslate.

== Drill interaction ==
Direct <code>/smithy upgrade</code> is blocked for drills and prestige tools. However, books purchased from the Master Smith ''can'' be applied to drills via the standard anvil. This is an intentional design — the book cost ($10,000+) plus anvil XP provides natural enforcement.

== Commands ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/smithy</code> or <code>/mastersmith</code> || Open the upgrade menu
|-
| <code>/smithy upgrade efficiency</code> || Apply Efficiency VII to held pickaxe
|-
| <code>/smithy upgrade fortune</code> || Apply Fortune V to held pickaxe
|-
| <code>/smithy book efficiency [tier]</code> || Buy an Efficiency book (tier 1-3)
|-
| <code>/smithy book fortune [tier]</code> || Buy a Fortune book (tier 1-3)
|}

== See also ==
* [[Miner]] — Miner career with Master Smith integration
* [[Drills and harvesters]] — AOE tools that benefit from books
* [[Prestige]] — unlocks Tier 2 and Tier 3 books
* [[Skill trees]] — unlocks Tier 1 books and direct upgrades
* [[Economy]] — Master Smith as a money sink

[[Category:Gameplay]]

MediaWiki:Sidebar

2026-05-27T15:01:36Z

Maintenance script: Configure sidebar navigation

Main Page

2026-05-27T14:58:01Z

Maintenance script: Add new page links

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:50%;" | Gameplay
! style="width:50%;" | Reference
|-
|
* [[Getting started]] — first steps on the server
* [[Jobs]] — how to earn money
* [[Economy]] — how the economy works
* [[Contracts]] — civic delivery quests
* [[Real estate]] — buying land
* [[Prestige]] — endgame progression
|
* [[Server rules]] — what you need to know
* [[Commands]] — player-facing command list
* [[Frequently asked questions|FAQ]] — common issues and fixes
* [[Zoning regulations]] — plot types and building rules
* [[Skill trees]] — per-job perk unlocks
* [[Crates]] — loot from job progression
|}

== Jobs ==
{| class="wikitable" style="width:100%;"
|-
! Job !! Pays for !! Key unlocks
|-
| [[Miner]] || Breaking stone, ores, deepslate || Drills, Master Smith upgrades
|-
| [[Farmer]] || Harvesting crops || Harvesters, auto-replant tools
|-
| [[Builder]] || Placing blocks || Civic contracts (primary income)
|-
| [[Woodcutter]] || Chopping logs || Tree-felling upgrades
|-
| [[Hunter]] || Killing hostile mobs || Dungeon access, combat gear
|-
| [[Fisherman]] || Catching fish || Rod enchants, rare-fish perks
|}

== Plugins ==
These plugins power the server's core systems.

{| class="wikitable" style="width:100%;"
|-
! Plugin !! Purpose
|-
| [[ChestShop]] || Player-owned shops (buy and sell signs)
|-
| [[Admin shop]] || Server shop (<code>/shop</code>)
|-
| [[BOLT]] || Automatic chest and door locking
|-
| [[Essentials]] || Homes, teleportation, mail, economy commands
|-
| [[Simple Voice Chat]] || Proximity voice chat (Java mod)
|-
| [[CoreProtect]] || Block inspection for grief checking
|-
| [[Plot rental]] || Renting and buying land plots (ARM)
|-
| [[Bedrock setup]] || Connecting from Bedrock Edition
|}

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

Plot rental

2026-05-27T14:57:35Z

Maintenance script: Initial content

'''Plot rental''' on Prosperity SMP is managed by the AdvancedRegionMarket (ARM) plugin. Players rent or purchase plots by clicking signs at available plots.

== Finding plots ==
Available plots display signs showing the plot name (e.g., R001, C015), zone type, price, and status. Look for them in the city and surrounding areas.

== Renting ==
# Find an available plot sign.
# Right-click the sign to view details.
# Click to confirm the rental.
# Build within the plot boundaries.

Rent is charged on a recurring basis. If rent is not paid, the plot returns to available status.

== Extending rent ==
Rent auto-renews as long as you have sufficient balance. There is a maximum extension time per plot.

== Plot rules ==
* Build only within your boundaries.
* Follow [[Zoning regulations]] for your plot type.
* Abandoned plots may be reclaimed by staff after extended inactivity plus missed rent.

== See also ==
* [[Real estate]] — plot types and zones
* [[Zoning regulations]] — building restrictions
* [[BOLT]] — protecting builds

[[Category:Plugins]]

Essentials

2026-05-27T14:57:26Z

Maintenance script: Initial content

'''Essentials''' provides core utility commands on Prosperity SMP, including homes, teleportation, messaging, and mail.

== Homes ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/sethome <name></code> || Save current location as a named home
|-
| <code>/home <name></code> || Teleport to a saved home
|-
| <code>/homes</code> || List all saved homes
|-
| <code>/delhome <name></code> || Delete a saved home
|}

You start with a limited number of home slots. Additional slots can be earned through vouchers from [[Crates|prestige crates]].

== Teleportation ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/spawn</code> || Teleport to spawn
|-
| <code>/tpa <player></code> || Request to teleport to a player
|-
| <code>/tpahere <player></code> || Request a player to teleport to you
|-
| <code>/tpaccept</code> || Accept a teleport request
|-
| <code>/tpdeny</code> || Deny a request
|-
| <code>/rtp</code> || Random teleport to resource world
|-
| <code>/back</code> || Return to last location
|}

Teleport requests expire after 60 seconds.

== Economy ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/balance</code> (or <code>/bal</code>) || Check balance
|-
| <code>/pay <player> <amount></code> || Send money
|-
| <code>/baltop</code> || Balance leaderboard
|}

== Messaging ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/msg <player> <message></code> || Private message (online players)
|-
| <code>/r <message></code> || Reply to last message
|-
| <code>/mail send <player> <message></code> || Send mail (works offline)
|-
| <code>/mail read</code> || Read mail
|-
| <code>/mail clear</code> || Clear read mail
|}

== Utility ==
{| class="wikitable"
|-
! Command !! Description
|-
| <code>/seen <player></code> || When a player was last online
|-
| <code>/list</code> || Who is online
|-
| <code>/near</code> || Nearby players
|-
| <code>/ping</code> || Connection latency
|}

== See also ==
* [[Commands]] — full reference
* [[Getting started]] — new player guide

[[Category:Plugins]]

Economy

2026-05-27T14:57:08Z

Maintenance script: Initial content

The '''economy''' on Prosperity SMP is player-driven. Money enters through [[Jobs|job wages]], [[Contracts|contracts]], and crate rewards. Money leaves through the [[Admin shop]], land purchases, [[Prestige|prestige costs]], and tool upgrades. Player-to-player trading via [[ChestShop]] forms the backbone of the market.

== Money sources ==
{| class="wikitable" style="width:100%;"
|-
! Source !! How it works !! Typical income
|-
| [[Jobs|Job wages]] || Automatic pay per action || $300-400/hr at L1, $1,200+/hr at L50 with tools
|-
| [[Contracts|Civic contracts]] || Deliver materials for cash || 1.5-3x material value
|-
| [[Crates]] || Random loot from job progression || $75 (apprentice) to $2,000+ (prestige)
|-
| [[Admin shop]] sell || Sell to server shop || Floor price, guaranteed buyer
|-
| Stipends || Bonus drops while working || Gunpowder (Miner), bone meal (Farmer), arrows (Hunter)
|}

== Money sinks ==
{| class="wikitable" style="width:100%;"
|-
! Sink !! Cost range
|-
| [[Real estate|Plot purchases]] || Varies by auction
|-
| Drill and harvester purchases || $1,000-6,500 per tool
|-
| [[Miner#Master Smith|Master Smith]] books || $10,000-120,000 per book + diamond blocks
|-
| [[Prestige]] costs || $25,000-1,000,000 per tier + materials
|-
| [[Admin shop]] purchases || Market-rate pricing
|}

== Market prices ==
Run <code>/market <item></code> to check the median price for any item based on recent trades.

== Tips for building wealth ==
# '''Join a job first.''' Job wages are the most reliable income.
# '''Sell to players, not the admin shop.''' Player shops almost always pay more.
# '''Complete contracts.''' They pay 1.5-3x the material value.
# '''Upgrade your tools.''' Drills and harvesters pay for themselves within hours.
# '''Invest in land.''' Commercial plots let you run a [[ChestShop]] that earns money while offline.
# '''Check /market before pricing.''' Price competitively against existing sellers.

== Inflation ==
The server monitors money supply and prices through an automated economic dashboard. Gradual price increases are normal as money enters through wages. Hoarding cash loses value slowly; investing in tools, land, and inventory preserves wealth.

== See also ==
* [[Jobs]] — primary income source
* [[ChestShop]] — player-to-player trading
* [[Prestige]] — endgame money sink
* [[Contracts]] — bonus income

[[Category:Gameplay]]

Prestige

2026-05-27T14:53:39Z

Maintenance script: Initial content

The '''prestige system''' allows players who reach level 50 in a [[Jobs|job]] to reset to level 1 in exchange for permanent bonuses, exclusive titles, and a prestige-tier tool. Players can prestige each job independently up to five times (P1 through P5).

== How to prestige ==
# Reach level 50 in any job.
# Gather the required money and materials for the next prestige tier.
# Run <code>/prestige <job></code>.
# Your job level resets to 1. All bonuses from the prestige are permanent.

== Prestige costs ==
{| class="wikitable" style="width:100%;"
|-
! Tier !! Money !! Diamond blocks !! Iron blocks !! Gold blocks !! Emerald blocks !! Netherite ingots !! Title
|-
| P1 || $25,000 || 3 || 16 || 8 || — || — || Reborn
|-
| P2 || $75,000 || 8 || 32 || 16 || 8 || — || Twice-Forged
|-
| P3 || $200,000 || 16 || 64 || 32 || 16 || 1 || Thrice-Forged
|-
| P4 || $500,000 || 32 || 128 || 64 || 32 || 3 || Mythic
|-
| P5 || $1,000,000 || 64 || — || — || 64 || 8 || Eternal
|}

Material costs use blocks (not raw ingots) for iron, gold, emerald, and diamond. Total cost to P5 in one job is approximately $1.8 million plus significant material investment.

== Prestige bonuses ==
Each tier grants cumulative bonuses that persist through the reset:

{| class="wikitable"
|-
! Tier !! Income bonus !! XP bonus !! Total income !! Total XP
|-
| P1 || +5% || +10% || +5% || +10%
|-
| P2 || +5% || +10% || +10% || +20%
|-
| P3 || +5% || +10% || +15% || +30%
|-
| P4 || +5% || +10% || +20% || +40%
|-
| P5 || +5% || +10% || +25% || +50%
|}

== Prestige titles ==
Prestige titles replace the regular job title in chat and the tab list. They outrank all standard level titles.

{| class="wikitable"
|-
! Tier !! Title !! Color
|-
| P1 || Reborn || Gold
|-
| P2 || Twice-Forged || Dark purple
|-
| P3 || Thrice-Forged || Pink
|-
| P4 || Mythic || Red
|-
| P5 || Eternal || Dark red
|}

The title displays as <code>[Reborn Miner]</code>, <code>[Eternal Farmer]</code>, etc., combining the prestige prefix with the job name.

== Prestige tools ==
Each prestige grants a named tool specific to the job. All prestige tools share the same base enchants (the tool name and color change per tier, but stats are identical):

{| class="wikitable"
|-
! Job !! Tool type !! Enchants !! Special
|-
| [[Miner]] || Netherite pickaxe || Efficiency V, Fortune III, Unbreaking V || 3x3 AOE mining
|-
| [[Farmer]] || Netherite hoe || Efficiency V, Unbreaking V || 3x3 AOE farming + auto-replant
|-
| [[Builder]] || Netherite shovel || Efficiency V, Unbreaking V || —
|-
| [[Woodcutter]] || Netherite axe || Efficiency V, Sharpness IV, Unbreaking V || —
|-
| [[Hunter]] || Bow || Power V, Infinity, Unbreaking V || —
|-
| [[Fisherman]] || Fishing rod || Luck of the Sea III, Lure III, Unbreaking V || —
|}

Prestige tools are '''soulbound''' (never drop on death) and '''tradeable''' (the original owner's name stays engraved as cosmetic provenance).

The real stat progression beyond the base prestige tool comes from [[Miner#Master Smith|Master Smith]] book tiers, which unlock at P2 (Tier 2 books) and P4 (Tier 3 books) for the Miner career.

== Prestige crates ==
At P1, the player also receives a job-specific prestige crate. At P2 through P5, an advanced prestige crate is given instead. See [[Crates]] for details on prestige crate contents, including the master tool roll (42% at P1) and the +1 enchant upgrade slot (5% at P2-P5).

== Multiple jobs ==
Players can prestige each job independently. A player might hold Miner P5 and Farmer P3 simultaneously. Prestige bonuses apply only to the job they were earned in.

== See also ==
* [[Jobs]] — job system overview
* [[Crates]] — prestige crate contents
* [[Miner]] — Miner-specific prestige details and Master Smith books
* [[Skill trees]] — per-job perk unlocks

[[Category:Gameplay]]

Lore

2026-05-27T14:49:01Z

Maintenance script: Initial content

The world of '''Prosperity SMP''' spans multiple biomes connected by trade routes and frontier paths. This page documents the server's lore and region naming.

== The frontier ==
Prosperity SMP is set on a frontier — a recently discovered landmass where settlers have established a growing economy. The server's tagline, "Build wealth. Shape the frontier," reflects this theme.

Players arrive as newcomers to the frontier, starting with nothing and building wealth through [[Jobs|labor]], [[Contracts|contracts]], and trade.

== Regions ==
The server consists of several distinct areas:

; Spawn and city center
: The starting area where new players arrive. Contains the job center, contract board, [[Admin shop]], and market district.

; Resource world
: A separate world dedicated to mining, farming, and gathering. Resources here regenerate periodically. Use <code>/rtp</code> to teleport to a random location.

; Nether
: Accessible via portals in the resource world. Contains nether-exclusive resources including ancient debris.

; The End
: Accessible via the stronghold in the resource world. Contains end cities, shulkers, and elytra.

== Economy lore ==
The frontier economy is player-driven. The [[Admin shop]] represents a baseline government exchange, while player [[ChestShop|shops]] form the real market. [[Contracts|Civic contracts]] represent the settlement's infrastructure needs — the government pays workers to supply materials for public works.

The prestige system represents mastery — a player who reaches [[Jobs#Prestige|Eternal]] status in a job has demonstrated deep expertise and invested significant resources into the frontier's growth.

== See also ==
* [[Getting started]] — new player guide
* [[Real estate]] — settling on the frontier
* [[Jobs]] — career paths

[[Category:Lore]]

Crates

2026-05-27T14:49:00Z

Maintenance script: Initial content

'''Crates''' are loot boxes earned through [[Jobs|job]] progression on Prosperity SMP. Each job has three crate tiers plus prestige crates for players who have completed the prestige system.

== Crate tiers ==
{| class="wikitable"
|-
! Tier !! Level range !! Average value !! Design role
|-
| Apprentice || 1-15 || ~$75 || Early-game progression help
|-
| Master || 16-35 || ~$300 || Mid-game gear
|-
| Legendary || 36-50 || ~$1,000 + soulbound chance || Endgame progression
|-
| Prestige || Prestige P1+ || ~$2,000 + master tool chance || Prestige payoff
|}

== How to obtain crates ==
Crates are earned in two ways:
# '''Level-up rewards''' — guaranteed crate of the matching tier when you level up.
# '''Random drops''' — small chance per dollar earned through job work to receive a crate of the matching tier.

== Opening crates ==
Right-click a crate key in your inventory to open it. The reward is determined by weighted random roll from the crate's loot table.

== Rarity tiers (per crate) ==
Each crate has four rarity tiers with different drop weights:

{| class="wikitable"
|-
! Rarity !! Typical weight !! Reward type
|-
| Common || 55-60% || Raw materials, basic resources
|-
| Uncommon || 25% || Mid-tier gear, refined materials
|-
| Rare || 12% || Enchanted gear, valuable items
|-
| Epic || 3-5% || High-value items, cash, soulbound utilities
|}

Legendary crates additionally have a 5% chance to roll a soulbound utility item (Ender Pouch, Healer's Stone, or Repair Hammer).

== Prestige crates ==
At prestige P1, players receive a job-specific prestige crate with a 42% chance to roll the job's master tool (the only source of Mending on the server). At P2 through P5, an advanced prestige crate is given with a 5% chance to upgrade an existing master tool's enchant level by +1.

== See also ==
* [[Jobs]] — job system and prestige
* [[Getting started]] — new player guide

[[Category:Gameplay]]

Skill trees

2026-05-27T14:49:00Z

Maintenance script: Initial content

Each [[Jobs|job]] on Prosperity SMP has a '''skill tree''' with nodes that unlock at specific levels. Players spend skill points to activate passive bonuses, utility perks, and access to advanced equipment.

== Accessing the skill tree ==
Run <code>/skills</code> to open the skill tree menu for your current job. The menu shows all available nodes, which ones you have unlocked, and what level is required for each.

== How it works ==
* You earn skill points as you level up your job.
* Each node costs one or more skill points to activate.
* Once activated, a node's benefits are permanent for that job (they persist through prestige).
* Some nodes are gated behind other nodes — you must unlock prerequisites first.

== Notable Miner nodes ==
{| class="wikitable"
|-
! Node !! Level !! Effect
|-
| Efficiency path || 35+ || Unlocks Efficiency VII at the [[Miner#Master Smith|Master Smith]]
|-
| Prospector path || 45+ || Unlocks Fortune V at the Master Smith
|}

These nodes do not directly grant the enchant — they grant permission to purchase the upgrade at the Master Smith station.

== Other jobs ==
Each of the six jobs (Miner, Farmer, Builder, Woodcutter, Hunter, Fisherman) has its own skill tree with job-specific nodes. The <code>/skills</code> menu adapts to whichever job you currently hold.

== See also ==
* [[Jobs]] — overview of all jobs
* [[Miner]] — Miner-specific skill tree details
* [[Commands]] — <code>/skills</code> command

[[Category:Gameplay]]

Zoning regulations

2026-05-27T14:48:18Z

Maintenance script: Initial content

'''Zoning regulations''' define what can be built and operated on each plot type on Prosperity SMP. All plots fall into one of three zones: residential (R), commercial (C), or industrial (I).

== Residential (R) ==
Residential plots are for personal homes and private builds.
* Players may build homes, gardens, and personal storage.
* Commercial activity (shops, paid services) is not permitted on residential plots.
* One residence per player unless additional plots are purchased.

== Commercial (C) ==
Commercial plots are for businesses, shops, and public services.
* Players must maintain a public-facing storefront, office, or service.
* [[ChestShop]] signs are encouraged on commercial plots.
* Residential use is permitted as a secondary purpose (e.g., living above a shop).

== Industrial (I) ==
Industrial plots are for large-scale production and farming.
* Automated crop farms, animal farms, and material processing are permitted.
* AFK farming remains prohibited per [[Server rules]].
* Industrial plots may be larger than residential or commercial plots.

== General rules ==
* Build only within your plot boundaries. Encroaching on roads, paths, or neighboring plots is prohibited.
* No offensive structures in any zone. See [[Server rules]].
* Plot owners are responsible for maintaining their builds. Abandoned plots may be reclaimed by staff after notice.

== See also ==
* [[Real estate]] — how to acquire plots
* [[Server rules]] — general conduct rules
* [[BOLT]] — protecting your builds

[[Category:Policies]]

Real estate

2026-05-27T14:48:17Z

Maintenance script: Initial content

'''Real estate''' on Prosperity SMP consists of purchasable land plots in three zone types. Plots are sold as bare land — players design and build their own structures within [[Zoning regulations|zoning rules]].

== Plot types ==
{| class="wikitable"
|-
! Prefix !! Zone type !! Purpose
|-
| R || Residential || Homes, personal builds
|-
| C || Commercial || Shops, market stalls, businesses
|-
| I || Industrial || Farms, factories, large-scale production
|}

Plots follow a 3-character prefix + 3-digit number naming scheme (e.g., R001, C015, I003).

== Acquiring a plot ==
Plots are sold through auctions or direct purchase depending on availability. Check the real estate board near spawn or ask staff on Discord for current listings.

== Building rules ==
All builds must comply with the [[Zoning regulations]] for their zone type. Key restrictions:
* Residential plots cannot operate commercial shops.
* Commercial plots must have a public-facing storefront or service.
* Industrial plots may contain large automated farms but must follow AFK farming rules.

See [[Zoning regulations]] for the complete ruleset.

== See also ==
* [[Zoning regulations]] — detailed building restrictions per zone
* [[Server rules]] — general conduct rules
* [[ChestShop]] — setting up a shop on a commercial plot

[[Category:Gameplay]]

Contracts

2026-05-27T14:48:17Z

Maintenance script: Initial content

'''Civic contracts''' are bulk delivery quests on Prosperity SMP. Players hand in specified materials to earn cash rewards. Contracts have cooldowns and daily caps to prevent exploitation.

== How contracts work ==
# Run <code>/contracts</code> to see all active contracts.
# Run <code>/contractinfo <id></code> to view details for a specific contract (material, quantity, reward, cooldown, daily cap).
# Gather the required materials in your inventory.
# Run <code>/deliver <id></code> to hand in the items and receive payment.

== Contract details ==
Each contract specifies:
; Material
: The item type to deliver (e.g., cobblestone, iron ingot, oak log).
; Quantity
: The number of items per delivery.
; Reward
: Cash payout per successful delivery. Contracts typically pay 1.5 to 3 times the raw material value.
; Cooldown
: Minimum time between deliveries (default: 30 minutes).
; Daily cap
: Maximum deliveries per day (default: 10).

== Pricing philosophy ==
Contract rewards are calibrated against the [[Jobs|job wage]] baseline of 25-175 per hour for new players. Contracts offer bonus income on top of regular job wages, especially for the [[Builder]] career where per-block wages are low.

== Sign interaction ==
Right-clicking a sign with <code>[Contract]</code> on line 1 and a contract ID on line 2 opens the contract info display for that contract.

== Commands ==
{| class=wikitable
|-
! Command !! Description
|-
| <code>/contracts</code> || List all active contracts
|-
| <code>/contractinfo <id></code> || View details for one contract
|-
| <code>/deliver <id></code> || Hand in items and get paid
|}

== See also ==
* [[Jobs]] — primary income source
* [[Getting started]] — includes contract introduction
* [[Commands]] — full command reference

[[Category:Gameplay]]

Fisherman

2026-05-27T14:47:42Z

Maintenance script: Initial content

The '''Fisherman''' is one of six [[Jobs|jobs]] on Prosperity SMP. Fishermen earn wages by catching fish.

== Joining ==
Run <code>/jobs join fisherman</code> or select Fisherman from <code>/jobs browse</code>.

== Pay rates ==
Fishermen earn approximately /usr/bin/bash.30 per fish caught. All vanilla fish types qualify. Treasure catches (enchanted books, saddles, nautilus shells) do not pay wages but are valuable as loot.

== Prestige tools ==
The Fisherman prestige tool is a fishing rod with Luck of the Sea III, Lure III, and Unbreaking V.

== Skill tree ==
The Fisherman skill tree includes perks for improved rod enchant levels, wage bonuses, and rare-fish detection. See [[Skill trees]] for details.

== See also ==
* [[Jobs]] — overview of all jobs
* [[Skill trees]] — Fisherman skill tree nodes

[[Category:Jobs]]

Hunter

2026-05-27T14:47:41Z

Maintenance script: Initial content

The '''Hunter''' is one of six [[Jobs|jobs]] on Prosperity SMP. Hunters earn wages by killing hostile mobs. The Hunter career path is combat-focused, designed around mob farming and future dungeon content.

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

== Pay rates ==
Hunters earn approximately /usr/bin/bash.50 per hostile mob killed. Pay varies slightly by mob type, with stronger mobs paying more.

== Stipends ==
While killing mobs, Hunters have a 10% chance per kill to receive 2 arrows as a stipend drop.

== Prestige tools ==
The Hunter prestige tool is a bow with Power V, Punch II, Infinity, and Unbreaking V.

== See also ==
* [[Jobs]] — overview of all jobs
* [[Skill trees]] — Hunter skill tree nodes

[[Category:Jobs]]

Woodcutter

2026-05-27T14:47:41Z

Maintenance script: Initial content

The '''Woodcutter''' is one of six [[Jobs|jobs]] on Prosperity SMP. Woodcutters earn wages by chopping logs.

== Joining ==
Run <code>/jobs join woodcutter</code> or select Woodcutter from <code>/jobs browse</code>.

== Pay rates ==
Woodcutters earn approximately /usr/bin/bash.025 per log chopped. All log types (oak, spruce, birch, jungle, acacia, dark oak, mangrove, cherry, bamboo) qualify.

== Prestige tools ==
The Woodcutter prestige tool is a netherite axe with Efficiency V, Sharpness IV, and Unbreaking V.

== See also ==
* [[Jobs]] — overview of all jobs
* [[Skill trees]] — Woodcutter skill tree nodes

[[Category:Jobs]]

Builder

2026-05-27T14:47:40Z

Maintenance script: Initial content

The '''Builder''' is one of six [[Jobs|jobs]] on Prosperity SMP. Builders earn wages by placing blocks. Unlike other jobs, Builder income relies heavily on [[Contracts|civic contracts]] rather than per-action wages, since the base placement wage is low by design.

== Joining ==
Run <code>/jobs join builder</code> or select Builder from <code>/jobs browse</code>.

== Pay rates ==
Builders earn approximately /usr/bin/bash.015 per block placed. This is intentionally lower than other jobs because Builder income is meant to come primarily from contracts.

== Contracts ==
Civic contracts at the contract board offer bulk material deliveries for bonus payouts. Builder-relevant contracts typically require stone bricks, glass, concrete, or other building materials. See [[Contracts]] for the full system.

== Titles ==
Each job has its own title progression at levels 1, 10, 20, 30, 40, and 50. Prestige titles outrank regular titles.

== Prestige tools ==
The Builder prestige tool is a netherite shovel with Efficiency V and Unbreaking V.

== See also ==
* [[Jobs]] — overview of all jobs
* [[Contracts]] — civic contract system
* [[Zoning regulations]] — building rules by plot type

[[Category:Jobs]]

Farmer

2026-05-27T14:47:18Z

Maintenance script: Initial content

The '''Farmer''' is one of six [[Jobs|jobs]] on Prosperity SMP. Farmers earn wages by harvesting crops. Higher levels unlock harvesters (3x3 AOE farming tools with auto-replant).

== Joining ==
Run <code>/jobs join farmer</code> or select Farmer from <code>/jobs browse</code>.

== Pay rates ==
Farmers earn per crop harvested. Wages increase by 1% per level.

{| class="wikitable"
|-
! Crop !! Base wage
|-
| Wheat, carrots, potatoes, beetroot || ~$0.030
|-
| Melon, pumpkin || ~$0.025
|-
| Sugar cane || ~$0.025
|-
| Nether wart || ~$0.030
|}

== Harvesters ==
Harvesters are 3x3 AOE hoes that break a 9-crop area with each swing and auto-replant the harvested crops. They are purchased with <code>/buyharvester</code>.

{| class="wikitable"
|-
! Tier !! Name !! Level !! Price !! Base !! Enchants
|-
| 1 || Compact Harvester || 15 || $1,000 || Iron hoe || Efficiency III, Unbreaking III
|-
| 2 || Industrial Harvester || 30 || $2,500 || Diamond hoe || Efficiency IV, Unbreaking III
|-
| 3 || Apex Harvester || 45 || $5,000 || Netherite hoe || Efficiency V, Unbreaking III
|}

Harvesters work anywhere the player has block-break permissions. They only activate on fully-grown crops — breaking unripe crops with a harvester does not pay wages.

== Stipends ==
While farming, Farmers have a 7% chance per crop harvested to receive 1 bone meal as a stipend drop.

== Prestige tools ==
Each prestige tier grants a named prestige harvester (Reborn Harvester, Twice-Forged Harvester, etc.) with Efficiency V and Unbreaking V on a netherite base. The tool includes 3x3 AOE farming with auto-replant.

== Titles ==
Each job has its own title progression at levels 1, 10, 20, 30, 40, and 50. Prestige titles (Reborn through Eternal) outrank regular titles.

== See also ==
* [[Jobs]] — overview of all jobs
* [[Skill trees]] — Farmer skill tree nodes
* [[Miner]] — the mining career path

[[Category:Jobs]]