> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/pinnaprison/introduction.md).

# Introduction

Welcome to the PinnaPrison documentation!

<mark style="color:red;">**WARNING: PinnaPrison ONLY WORKS ON PAPER 1.20.4, 1.21.1, 1.21.4, 1.21.6 – 1.21.8, 1.21.10, 1.21.11 and 26.1+**</mark>

Welcome to the official documentation for **PinnaPrison** — a complete, high-performance prison core. This guide covers every feature, configuration file, command and placeholder available in the plugin.

PinnaPrison gives every player their own **packet-based private mine** (no real blocks, no lag — thousands of mines run at once), a fully customizable **prison pickaxe** with dozens of **custom enchants**, **prestige**, **rebirth**, **crystals**, **boosters**, **backpacks**, **autosell**, **bombs**, **drills**, **autominers**, **lucky blocks**, **abilities**, **attributes**, unlimited **currencies** and **leveling tracks**, and a powerful menu system — everything you need to build a modern prison server.

## ✨ Highlights

* **Private Mines** — packet-only mines (the server world is void, so there is zero block lag), per-player resets, expansions, mine types, visitors, tax and an invite system.
* **Custom Enchants** — 40+ ready-to-use enchants (animated AOE enchants, greed/currency enchants and passive effect enchants), each with chance scaling, cooldowns, prestige and per-player toggles.
* **Prestige & Rebirth** — re-max enchants for higher chances, and a server-wide rebirth skill tree.
* **Economy** — unlimited Vault-compatible currencies and leveling tracks, each with its own command.
* **Tools** — backpacks, autosell, bombs, drills, autominers, crystals, boosters, abilities and attributes.
* **Fully Configurable** — every GUI, item, message and number format is editable from YAML.

## 🚀 Installation

1. Download the latest version of the PinnaPrison plugin (`.jar` file).
2. Place the `PinnaPrison.jar` into your server's `plugins/` folder.
3. Install the required dependencies: [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/), [NBTAPI](https://modrinth.com/plugin/nbtapi/versions). [Vault](https://www.spigotmc.org/resources/vault.34315/) is recommended for economy integration.
4. Restart your server. PinnaPrison generates its default configuration files inside `plugins/PinnaPrison/`.

See the [Installation](/p/pinnaprison/getting-started/installation.md) page for full setup details.

## 🧭 Where to start

* New to the plugin? Read [Installation](/p/pinnaprison/getting-started/installation.md) → [Private Mines](/p/pinnaprison/core/private-mines.md) → [The Pickaxe](/p/pinnaprison/core/pickaxe.md).
* Setting up your mine schematic? See [Schematics & Mine Setup](/p/pinnaprison/core/schematics.md).
* Configuring economy? See [Currencies](/p/pinnaprison/core/currencies.md) and [Leveling](/p/pinnaprison/core/leveling.md).
* Looking for a command or placeholder? Jump to the [Reference](/p/pinnaprison/reference/commands.md) section.

## 💬 Support

Need help? Join the Discord: <https://discord.gg/7RapfdQ7VH>