> ## Documentation Index
> Fetch the complete documentation index at: https://mbcz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Stonkz SMP

> A ready-made Economy SMP server setup with a live stock market, spawners, world events, seasons and a custom spawn.

**Stonkz SMP** is a complete Donut-style Economy SMP, packed as one zip. Copy it into a Paper server, paste your licence keys, and open. Everything is already configured to work together: a live stock-market economy, spawners, world events, 30-day seasons, an auction house, buy orders, crates, teams, bounties, an AFK lounge and a custom spawn called the **Stonkz Exchange**.

![The Stonkz Exchange spawn island with its copper dome](https://mintcdn.com/mbcz/QkWCVhRsXYrGqZUc/images/stonkz-smp/exchange-island.png?fit=max\&auto=format\&n=QkWCVhRsXYrGqZUc\&q=85\&s=ba09eaac44d367b7b8dbc260b6a5092c)

## Why it works

Most economy servers run on a static shop. One player builds the best farm, sells into a shop that pays forever, and by week two everyone is rich.

Stonkz SMP runs on a market that pushes back:

* **Prices move.** Buying drains stock and lifts the price. Selling floods it and cuts the payout.
* **Panic Mode.** A sell rush on one item halves its price for 5 minutes.
* **Spawner loot sells at live prices.** Big farms move the board instead of printing money.
* **Something is always happening.** World events roll in every 30 minutes, on top of a weekly calendar.
* **A finish line.** 30-day seasons with stats, a countdown and a leaderboard.

## What you get

> [card] [Four premium plugins](https://mbcz.mintlify.site/stonkz-smp/whats-inside.md)
>
> Stonkz, 3TSpawner, WorldEvents PRO and SeasonManager PRIME, keys included.

> [card] [The Stonkz Exchange](https://mbcz.mintlify.site/stonkz-smp/spawn.md)
>
> A floating-island spawn with live price boards, NPCs, crates and an AFK lounge.

> [card] [Donut-style features](https://mbcz.mintlify.site/stonkz-smp/economy.md)
>
> `/ah`, `/orders`, spawners, `/rtp`, teams, bounties, homes and combat tag.

> [card] [Ranks and branding](https://mbcz.mintlify.site/stonkz-smp/ranks.md)
>
> VIP, MVP and Admin ranks, a scoreboard, a tab list and one-click rebranding.

## Try it

Join the live demo server at `play.stonkz.space` to walk around the Exchange and try the market before you buy.

## Get Stonkz SMP

> [card] [Discord](https://discord.gg/kgHNjJsB2t)
>
> Claim your four licence keys and get support.

> [card] [Stonkz on BuiltByBit](https://builtbybit.com/resources/84623/)
>
> The market plugin at the heart of the setup.

The Stonkz SMP store link is added here when the store page is live.

## Compatibility

| Component | Requirement |
| - | - |
| Server software | Paper **26.1.2** (not included, [download from PaperMC](https://papermc.io/downloads/paper)) |
| Java | **25** |
| RAM | 4 GB or more |
| Licence keys | 4 keys from Discord, plus internet access for the licence checks |
| Current version | **1.0.1** (ships Stonkz 1.4.45) |

> [!WARNING]
>
> Use Paper 26.1.2. The bundled plugins are pinned to that version. Folia is not supported: several bundled plugins, such as EssentialsX and WorldGuard, do not run on Folia.

## Quick start

**1. Rebrand**

On Windows, double-click `rebrand.bat` and type your server's name and address. See [Rebranding](https://mbcz.mintlify.site/stonkz-smp/rebranding.md).

**2. Copy the server folder**

Copy everything from the package's `server` folder into your server's root folder. See [Installation](https://mbcz.mintlify.site/stonkz-smp/installation.md).

**3. Add your keys**

Claim four keys in Discord and paste them into the plugin configs. See [Licence keys](https://mbcz.mintlify.site/stonkz-smp/licence-keys.md).

**4. Open**

Restart, run `lp user <your name> parent set admin` in the console, then `/season start`.

## Documentation sections

> [card] [What's inside](https://mbcz.mintlify.site/stonkz-smp/whats-inside.md)
>
> Every plugin in the zip and what it does.

> [card] [Installation](https://mbcz.mintlify.site/stonkz-smp/installation.md)
>
> Requirements, copy steps, first boot and admin.

> [card] [Licence keys](https://mbcz.mintlify.site/stonkz-smp/licence-keys.md)
>
> `/verify`, `/claim` and where each key goes.

> [card] [Updating](https://mbcz.mintlify.site/stonkz-smp/updating.md)
>
> Move from 1.0 to 1.0.1.

> [card] [Commands](https://mbcz.mintlify.site/stonkz-smp/commands.md)
>
> Player and owner commands at a glance.

> [card] [Ranks](https://mbcz.mintlify.site/stonkz-smp/ranks.md)
>
> Default, VIP, MVP and Admin perks.

> [card] [Configuration](https://mbcz.mintlify.site/stonkz-smp/configuration.md)
>
> Where to change prices, events, crates, seasons and more.

> [card] [Rebranding](https://mbcz.mintlify.site/stonkz-smp/rebranding.md)
>
> Your name on the scoreboard, tab list and menu.

> [card] [Spawn](https://mbcz.mintlify.site/stonkz-smp/spawn.md)
>
> The Stonkz Exchange, its NPCs and price boards.

> [card] [Economy](https://mbcz.mintlify.site/stonkz-smp/economy.md)
>
> Market, spawners, auction house and buy orders.

> [card] [Crates and AFK](https://mbcz.mintlify.site/stonkz-smp/crates-and-afk.md)
>
> Three crate tiers and the AFK Lounge.

> [card] [World events](https://mbcz.mintlify.site/stonkz-smp/events.md)
>
> Random events and the weekly calendar.

> [card] [Seasons](https://mbcz.mintlify.site/stonkz-smp/seasons.md)
>
> 30-day seasons and starting a new map.

> [card] [FAQ](https://mbcz.mintlify.site/stonkz-smp/faq.md)
>
> Keys, versions, hosting and common questions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.