> 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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://edseries-plugins.gitbook.io/p/pinnaprison/introduction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.