> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/mantic-prisons.md).

# ManticPrisons

Client documentation for server owners and players using ManticPrisons.

A configurable prison core for Paper, with personal mines, pickaxe enchants, progression, rewards and player menus.

## Browse the guides

Choose a section to find setup, gameplay, administration, and integration guides:

* [Getting Started](https://docs.mantic.dev/mantic-prisons/getting-started.md)
* [Admin & Configuration](https://docs.mantic.dev/mantic-prisons/admin-and-configuration.md)
* [Mining & Pickaxes](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes.md)
* [Economy & Progression](https://docs.mantic.dev/mantic-prisons/economy-and-progression.md)
* [Multiplayer & Activities](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities.md)
* [Integrations & Migration](https://docs.mantic.dev/mantic-prisons/integrations-and-migration.md)

## Setup

1. Use Java and Paper versions supported by the current ManticPrisons build.
2. Install ManticLib and the ManticPrisons plugin JAR in the server's `plugins` folder.
3. Start the server once to generate `plugins/ManticPrisons/config.yml`. Set `license` to your ManticPrisons license key from [Mantic Discord](https://discord.mantic.dev), then restart. Keep the key private. Verification runs online before features start or the database opens. Allow outbound HTTPS to `auth.mantic.dev` on port 443; no incoming port needs opening. Once verified, local H2 storage is used by default.
4. Give administrators the `manticprisons.admin` permission. Operators have it by default.
5. Join as an administrator and run `/prisons setup`. Keep the default mine style and arrival point for a first setup, or preview your choices in the guide. Choose **Check This Draft**, then **Apply My Setup**. See [guided setup](https://docs.mantic.dev/mantic-prisons/admin-and-configuration/admin-tools.md#guided-setup).
6. Run `/prisons features` to check which features loaded and `/prisons health` to check for configuration issues.

If verification fails, read the licensing message in the server console. Check your key and network access, or wait for the displayed retry delay if requests were rate limited, then restart. License changes require a restart.

Admins can use `/prisons editor [feature]` to preview and safely change common settings, and `/prisons health` for diagnostics. See [admin tools](https://docs.mantic.dev/mantic-prisons/admin-and-configuration/admin-tools.md).

## First mining session

1. Join with a fresh player account to check [first-join rewards](https://docs.mantic.dev/mantic-prisons/getting-started/onboarding.md) and [starter pickaxe delivery](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/pickaxe-delivery.md).
2. Run `/mine` to enter your private mine and break a few blocks with the starter pickaxe. Use `/balance` to check currency rewards and `/sell` to sell eligible drops.
3. Open `/prison` to find your mine, enchant upgrades, backpacks and progression. Use `/rank` to browse ranks and `/rankup` when you meet the next rank's requirements.

Use `/prisons help` for command topics and `/pickaxe reclaim` if you lose your prison pickaxe.

Players can open `/economypreview` (or `/earnings`) to see recent earnings and estimated time to their next rank. Administrators can use `/prisonhistory` to search operation records and mark entries reviewed. Both have links on the default Balances & Payments page. See [economy preview](https://docs.mantic.dev/mantic-prisons/economy-and-progression/economy-preview.md) and [admin history](https://docs.mantic.dev/mantic-prisons/admin-and-configuration/admin-history.md).

Use `/rebirth` to review a rank/prestige reset for permanent bonuses, and `/ability` to activate mining skills with saved cooldowns. See [rebirth progression](https://docs.mantic.dev/mantic-prisons/economy-and-progression/rebirth.md) and [activated abilities](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/abilities.md).

Use `/crystals` to customise pickaxe sockets with removable crystals. See [crystals and sockets](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/crystals.md) for bonuses, unlocks and reward commands.

To package the plugin from source, run `./gradlew jar` with the project's configured Java toolchain. The plugin JAR is written to `build/libs/`.

## Enchant files

Tradable enchant books are disabled by default. See [enchant book setup](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/enchant-books.md) to enable them and issue single-use rewards.

See [enchant defaults and utility effects](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/enchants.md) for the Pickaxes and Hoes enchants, external rewards and setup examples.

Each enchant has its own YAML file, like each crate in ManticCrates:

```
plugins/ManticPrisons/features/enchants/
  lang.yml
  pickaxes/
    default.yml
  enchants/
    explosion.yml
    jackhammer.yml
    nuke.yml
    excavator.yml
    drill.yml
    laser.yml
    veinminer.yml
    slicer.yml
    double_layer.yml
    shockwave.yml
```

`pickaxes/` holds one file per pickaxe type. `lang.yml` holds messages.

To add an enchant, copy an existing enchant file to another `.yml` file in the `enchants` folder and give it a unique top-level `id`. IDs use 1–32 lowercase letters, digits or underscores. Keep an existing enchant's ID unchanged to retain players' saved levels. Renaming its file does not change its ID.

Example `enchants/explosion.yml`:

```yaml
id: explosion
enabled: true
type: SPHERE
display-name: '&cExplosion'
max-level: 100
base-chance: 0.01
chance-per-level: 0.001
radius:
  1: 2
  25: 3
  50: 4
  100: 5
```

* `enabled`: set to `false` to disable this enchant while keeping its file.
* `type`: `SPHERE` breaks a ball, `CUBE` breaks a cube, `LAYER` breaks the mine layer containing the original block, `COLUMN` breaks vertically above and below it, and `CROSS` breaks along both horizontal axes, `VEIN` selects matching block states in a ball, `WALL` clears a vertical Y/Z slice, `DOUBLE_LAYER` clears the original layer and the one below, and `DISC` clears a horizontal circle.
* `display-name`: the name shown in messages; quote names containing `&` colour codes.
* `max-level`: the highest enchant level.
* `base-chance` and `chance-per-level`: activation chance is `base-chance + chance-per-level * level`, capped at `1` (100%). Level zero does not activate an enchant.
* `radius`: level milestones and their radii. The example uses radius 2 through level 24 and radius 3 from level 25. Radii are limited to 0–32; `LAYER`, `WALL` and `DOUBLE_LAYER` ignore this setting.

Empty collections are written as `{}` for maps and `[]` for lists. Generated enchant `radius` and pickaxe `lore` comments include examples: replace the empty field with the example, remove its `#` comment markers, and keep the indentation. Use spaces rather than tabs. Leave `radius: {}` for `LAYER`, `WALL` and `DOUBLE_LAYER` enchants and `lore: []` for an item with no description.

After editing, run `/prisons reload enchants`. Check `/prisons features` and the server console if a configuration does not load. Missing default enchant files are added on startup and reload, Existing IDs and files are kept, including renamed files and disabled enchants. Disable unwanted defaults with `enabled: false` rather than deleting their files.

### Default enchants

There are 47 configurable enchants covering area mining, drops, currencies, buffs, finder rewards and tool protection. See the [full enchant catalogue and settings](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/enchants.md).

Vein Miner selects matching block states within its radius, including disconnected matching blocks; it does not spread through the whole mine. It only triggers on materials listed in `vein-blocks`: ores (including deepslate/nether ores), ancient debris, mineral storage blocks, raw metal blocks and amethyst blocks are allowed by default. Ordinary stone and dirt do not trigger it. To choose your own special blocks, edit `features/enchants/enchants/veinminer.yml`:

```yaml
vein-blocks:
  - DIAMOND_ORE
  - DEEPSLATE_DIAMOND_ORE
  - EMERALD_BLOCK
```

Replace the generated list with your selection. Use Minecraft block material names; invalid entries are logged and skipped. `vein-blocks: []` prevents Vein Miner from triggering. This field is ignored by other effect types. Run `/prisons reload enchants` after changing it.

Slicer clears a fixed Y/Z plane. Double Layer rolls independently on a player dig and does not require Jackhammer; at the mine floor it clears just the bottom layer. Shockwave clears one horizontal disc.

To customise a default or create another enchant, use the settings above; for example, `enchants/drill.yml`:

```yaml
id: drill
enabled: true
type: COLUMN
display-name: '&bDrill'
max-level: 100
base-chance: 0.02
chance-per-level: 0.001
radius:
  1: 3
  25: 5
  50: 8
  100: 12
```

Reload with `/prisons reload enchants`, give yourself a marked pickaxe with `/pickaxe give`, and grant a level with `/enchant set <player> drill 1`. The radius measures blocks in each direction from the original block. All shapes stop at mine boundaries and count overlapping blocks once.

## Pickaxe types

Each file in `features/enchants/pickaxes/` defines a tool type. Copy `default.yml` to a new `.yml` file and change its `id` to add another type, following the separate tool files in ManticPickaxes.

Example `pickaxes/ruby.yml`:

```yaml
id: ruby
enabled: true
material: NETHERITE_PICKAXE
display-name: '&cRuby Pickaxe'
lore:
  - '&7Made for {player}'
glow: true
custom-model-data: 12
permission: ''
```

* `id`: unique type name using 1–32 lowercase letters, digits or underscores. Keep it unchanged for existing items.
* `enabled`: set to `false` to stop giving this type and activating its enchants.
* `material`: a valid Minecraft item material, such as `DIAMOND_PICKAXE` or `NETHERITE_PICKAXE`.
* `display-name` and `lore`: appearance with `&` colour codes and live placeholders listed below.
* `glow`: show the enchanted-item shine.
* `custom-model-data`: resource-pack model number; `0` keeps the normal model.
* `permission`: permission required to activate enchants with this type; `''` allows everyone.

All prison pickaxes are unbreakable. Run `/prisons reload enchants` after editing. Give a type with `/pickaxe give <player> ruby`; omitting the type uses `default`. Type names are suggested by command completion. Keep a type with `id: default` if you want to use the command without specifying a type.

Existing marked pickaxes are recognised as the `default` type. Names and lore refresh on existing items when `live-lore: true`; material, glow and model settings apply to newly given items; removing or disabling a type prevents its existing items from activating enchants. Enchant levels still belong to each player and are shared across their tool types.

## Enchant commands

| Command                               | Purpose                                                                            | Permission            |
| ------------------------------------- | ---------------------------------------------------------------------------------- | --------------------- |
| `/pickaxe give [player] [type] [max]` | Give a marked pickaxe; `max` also maximises the recipient’s saved enchants and XP. | `manticprisons.admin` |
| `/enchant list`                       | Show your enchant levels and toggles.                                              | Available to players  |
| `/enchant toggle <id>`                | Toggle an owned enchant.                                                           | Available to players  |
| `/enchant set <player> <id> <level>`  | Set an online player's enchant level; zero removes the level.                      | `manticprisons.admin` |
| `/prisons reload enchants`            | Reload enchant settings and files.                                                 | `manticprisons.admin` |
| `/prisons features`                   | Show feature status.                                                               | `manticprisons.admin` |

Enchants use the levels saved for the player holding the marked pickaxe. Admins can give levels with `/enchant set`; players can then toggle them individually.

## Command completion

Press Tab to complete subcommands, online player names, enchant IDs, pickaxe types and enabled feature names. Suggestions follow the command branch and your permissions. `/enchant set` suggests level zero (remove), common levels and the selected enchant's maximum. `/mine pattern` and `/mine template` suggest choices you can use; console suggestions omit player-only actions.

## Pickaxe lore and menus

Right-click a usable prison pickaxe to open the prison overview by default. Choose Enchant Upgrades in `/prison settings` for a direct shortcut, or use `/enchant menu`. Use `/enchant toggle <enchant>` to toggle an owned enchant. The disenchanter button lists owned enchants and asks for confirmation before removal. Refund percentages are configurable globally in `menus.yml` and per enchant.

Pickaxe display templates live in `features/enchants/pickaxes/<type>.yml`. For example:

```yaml
live-lore: true
lore:
  - '&7Player: &f{player}'
  - '&7Blocks mined: &f{mined}'
  - '&7Mine level: &f{mine-level}'
  - '&7Blocks left: &f{remaining}/{volume}'
  - ''
  - '&bEnchants'
  - '{enchants}'
  - ''
  - '&b→ Right-click for your chosen menu'
```

`{type}` is also available. Put `{enchants}` on its own line: it expands into one line per owned enchant, including its level, maximum and on/off state. `pickaxe-enchant-line` and `pickaxe-no-enchants` in `features/enchants/lang.yml` control those lines. Displays use the holder's progress; tools do not carry separate enchant levels. `{mined}` is the holder's lifetime blocks-mined count, including mining in other players' mines. Mine level and remaining blocks describe their own mine.

Old empty lore templates are upgraded once to the new defaults. Custom lore is kept. Afterwards, `lore: []` keeps a type's lore empty. `live-lore: false` stops automatic name/lore updates for that type. Refreshes update marked pickaxes throughout each loaded player's inventory.

### Menu configuration

`features/enchants/menus.yml` contains all three screens: `enchants`, `disenchanter` and `confirmation`.

* `right-click-enabled`: enable or disable right-click opening for every player.
* `right-click-menu`: server default `MAIN_MENU`, `ENCHANTS` or `DISABLED`; players choose overrides in `/prison settings`.
* `require-sneak`: require sneaking while right-clicking.
* `permission`: access permission for the menus; `''` allows everyone with a usable pickaxe.
* `disenchant-permission`: an additional removal permission; `''` adds no requirement.
* `lore-refresh-ticks`: inventory display refresh interval. Use a positive whole number; `20` is one second.
* Each screen has `title`, `layout`, `filler`, `entry`, `unowned`, `empty` and `buttons` styling. `entry`, `unowned` and `empty` style the enchant lists.

Layouts contain 1–6 rows, each exactly 9 characters. `e` reserves enchant slots, `#` is filler, and button keys set button positions. The lists paginate automatically according to the number of `e` slots. Keep previous/next buttons when a screen needs more than one page. A button's key can appear more than once in the layout.

Buttons have a one-character `key`, an `item` section and an `action`. This example places a close button wherever `c` appears in the layout:

```yaml
buttons:
  - key: c
    item:
      material: BARRIER
      name: '&cClose'
      lore:
        - '&7Return to the game'
    action: CLOSE
```

Item styles use `material`, `name` and `lore`. Use `lore: []` for no tooltip. Available button actions are `NONE`, `PREVIEW`, `CLOSE`, `NEXT`, `PREVIOUS`, `ENCHANTS`, `DISENCHANTER`, `CONFIRM` and `CANCEL`. `PREVIEW` shows the held pickaxe with its current appearance. Keep both `CONFIRM` and `CANCEL` on the confirmation screen.

Menu titles and item text support the pickaxe placeholders. Enchant entries and confirmation text also support `{enchant}`, `{level}`, `{max-level}` and `{status}`; list screens support `{page}` and `{pages}`. Removal success and changed-level messages are configurable in `lang.yml`.

Run `/prisons reload enchants` after editing pickaxe or menu files. Open menus close during reload, and old pending clicks cannot modify the new feature state.

## Currency and backpacks

ManticPrisons includes saved configurable currencies, including coins and tokens, and upgradeable backpacks. Virtual backpacks use a permission; physical backpacks require the owner to carry their item. Both can be enabled together, and players with both can use both.

Run `/balance` to check balances and `/backpack` to open available storage. Mine rewards fill the inventory first, then eligible backpacks.

See [Currency setup and provider hooks](https://docs.mantic.dev/mantic-prisons/economy-and-progression/currency.md) and [Backpack setup](https://docs.mantic.dev/mantic-prisons/economy-and-progression/backpacks.md) for permissions, prices, commands and configuration examples.

Selling uses `/sell [all|inventory|virtual|physical]`. Players with `manticprisons.autosell` can use `/autosell on` or `/autosell off`. See [selling setup](https://docs.mantic.dev/mantic-prisons/economy-and-progression/selling.md) for item prices and permissions.

## Starter tools and progression

Players receive a starter pickaxe once and can use `/pickaxe reclaim` to replace a lost tool. See [pickaxe delivery and recovery](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/pickaxe-delivery.md) for types, permissions and cooldowns.

Use `/rank`, `/rankup`, `/rankup max` and `/prestige` for progression. Rank and prestige permissions can unlock mine patterns and templates. See [ranks and prestige](https://docs.mantic.dev/mantic-prisons/economy-and-progression/ranks.md) for prices, confirmation, rewards and reset rules.

Use `/mineupgrade` to review a paid mine level and `/mineupgrade confirm` to buy it. See [paid mine upgrades](https://docs.mantic.dev/mantic-prisons/admin-and-configuration/mine-upgrades.md) for prices, size milestones and confirmation settings.

Use `/top [board]` for saved leaderboards covering mined blocks, currencies, rank, prestige and mine levels. See [leaderboard setup](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/leaderboards.md) for board types and refresh settings.

## Mining robots

Open `/robot` or right-click your robot for its configurable control menu. Use `/robot buy` to purchase a personal mining robot, `/robot upgrade` to improve it, and `/robot on` or `/robot off` to control it. See [robot setup](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/robots.md) for prices, appearance, permissions and performance settings.

## Custom items

Pickaxes, physical backpacks, menu icons and robot equipment can use Nexo, ItemsAdder or Oraxen items, with a shared optional `custom-model-data` setting. See [custom item setup](https://docs.mantic.dev/mantic-prisons/admin-and-configuration/custom-items.md) for configuration examples and reload commands.

## Boosters

Use `/booster` for active timers, `/booster shop` to browse selling, token and mine-XP boosts, or right-click a booster item to redeem it. Boosters pause offline and queue safely by default. See [booster setup](https://docs.mantic.dev/mantic-prisons/economy-and-progression/boosters.md) for commands, permissions, prices, stacking rules and custom-item appearances.

## Quests

Use `/quests` to open the quest journal. Complete mining, selling, progression and feature goals, then click a completed quest to claim its currency reward. Daily quests reset at midnight UTC by default. See [the quests guide](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/quests.md) for commands and configuration.

## Gangs

Use `/gang create <name>` to start a gang, `/gang invite <player>` to invite friends and `/gang accept <name>` to join. Members can visit each other with `/gang visit <member>` while mine sharing is on. `/gang top` ranks gangs by blocks earned while in the gang. See [the gangs guide](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/gangs.md) for commands and configuration.

## PlaceholderAPI

Install PlaceholderAPI to use ManticPrisons stats in scoreboards and holograms. No eCloud expansion download is needed. Try `%manticprisons_mines_level%`, `%manticprisons_economy_balance_tokens_formatted%` or `%manticprisons_gangs_name%`. See [the placeholder reference](https://docs.mantic.dev/mantic-prisons/integrations-and-migration/placeholders.md) for all supported values and setup.

## First-join rewards

New players receive configurable welcome messages and starter items. Configure chat, title/actionbar, starting money minimums and extra items under `features/onboarding/`. Existing pickaxe and backpack delivery settings stay in their own feature folders. See [first-join setup](https://docs.mantic.dev/mantic-prisons/getting-started/onboarding.md) for examples.

Bonus-block and enchant-chance boosters are available alongside money, token and mine-XP boosters. Configure their items, prices and durations in `features/boosters/config.yml`; see [the booster guide](https://docs.mantic.dev/mantic-prisons/economy-and-progression/boosters.md).

## Vanilla advancements

Vanilla advancement awards, toast popups and chat announcements are suppressed by default in every world. Recipe unlocks, advancements in custom namespaces and previously saved progress are preserved. To allow vanilla advancements again, set `disable-vanilla-advancements: false` in `plugins/ManticPrisons/config.yml` and restart. Set it back to `true` and restart to enable suppression.

## Playtime and AFK

Use `/playtime` to view saved total/active time and the current session. Normal tracking can exclude vanished time; separate staff counters include it. AFK detection requires walking plus recent look-direction changes, or another qualifying action. Configure thresholds and messages in `features/playtime/`; PlaceholderAPI includes raw seconds, formatted durations and AFK status. See [playtime setup](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/playtime.md).

## Lucky Blocks

Private mines include configurable Lucky Blocks with weighted currency, item and console-command rewards. Configure one file per type under `features/luckyblocks/types/`, then use `/prisons reload luckyblocks`. Administrators can open rewards with `/luckyblock give <player> <type> [count]`. Saved opening counts include per-type and per-tier PlaceholderAPI values. See [Lucky Block setup](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/lucky-blocks.md).

## Developer integrations

Mines, economy, ranks, gangs and boosters expose Bukkit services. Mining has a cancellable pre-break event and an immutable completed-break summary; Lucky Blocks have a cancellable opening event. Completed-action events cover ranks/prestige, enchants, backpacks, robots, boosters, quests, gangs, economy, AFK and onboarding. See the [developer API guide](https://docs.mantic.dev/mantic-prisons/integrations-and-migration/developer-api.md) for setup and examples.

## Achievements

Use `/achievements` to browse 21 lifetime prison milestones and claim their rewards. Configure goals, currencies, messages and custom-item menu icons under `features/achievements/`. Includes saved progress, clickable completion messages, PAPI fields and developer events. See [achievement setup](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/achievements.md).

## Mining captchas

The `captcha` feature can show maths or item-selection checks after mining. It blocks further prison mining until the player answers, preserves the same challenge when closed and reopened, and ignores clicks during a configurable one-second grace period. Wrong answers and timeouts use configurable escalating punishments: one minute for the first failure, five minutes for the second and third, then fifteen minutes plus two minutes per further failure. Solving or clearing the captcha resets the count. Tiers can also send messages, run commands or kick the player. Staff can use `/prisoncaptcha force <player>` and `/prisoncaptcha clear <player>` with `manticprisons.captcha.admin`.

See [captcha setup](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/captcha.md) for chance, timing, bypass permissions, messages and reload instructions.

Quests also support weekly Monday resets, completed-sale item counts, rankups, prestiges and purchased enchant levels. See [Quest setup](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/quests.md).

Gangs include shared built-in currency banks, configurable role permissions and member-capacity upgrades purchased from bank funds. Use `/gang bank`, `/gang role` and `/gang upgrade`; see [Gang setup](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/gangs.md).

Timed mining competitions, community targets and reward periods are available through `/miningevent`. Configure automatic rotation, saved prizes and the menu in `features/miningevents/`; see [Mining events](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/mining-events.md).

Pickaxes now earn saved player-owned XP and levels. Use `/pickaxe stats` and configure optional enchant unlocks/caps in `features/enchants/progression.yml`; see [Pickaxe progression](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/pickaxe-progression.md). Automatic mining-event rotation defaults to enabled, with an hour between events.

Use `/prison` for the configurable central menu linking mines, enchants, backpacks, robots, ranks, balances and the other core features. Customize `features/prisonmenu/config.yml`; see [Prison menu setup](https://docs.mantic.dev/mantic-prisons/admin-and-configuration/prison-menu.md). `/enchant menu` also opens the pickaxe enchant menu directly.

## Migration

Console-only imports support PrisonTeam ranks/prestige and JetsPrisonMines block patterns, with previews, automatic backups of affected migration data and protection for existing progress. See the [migration guide](https://docs.mantic.dev/mantic-prisons/integrations-and-migration/migration.md) for mappings and commands.

Use `/prisons help` for clickable command topics and `/prison settings` for personal message, effect and pickaxe-shortcut preferences. Rank, prestige, pickaxe, mine-upgrade and playtime detail pages are available from `/prison`; `/top` opens paginated leaderboards. See [menus and settings](https://docs.mantic.dev/mantic-prisons/admin-and-configuration/prison-menu.md) and [help setup](https://docs.mantic.dev/mantic-prisons/getting-started/help.md). Menu and language files preserve custom styling; the menu guide explains how to regenerate selected default appearance files safely.

`/pickaxe reset <player>` clears the online player's saved enchants and pickaxe XP (admin only). Pickaxe lore uses `enchant-lore-limit: 8` per type to keep a max tool readable. Each enchant's own file contains its configurable `menu-item` icon and description. See [pickaxe setup](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/pickaxe-delivery.md) and [enchant setup](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/enchants.md).

The dedicated mines world is created empty when missing. `void-rescue-enabled: true` in `features/mines/config.yml` returns a falling player to the spawn of their viewed mine, including a visited mine. `void-rescue-depth: 16` sets the number of blocks below the mine bottom before rescue (1–32). Void damage also triggers a protected return. Other worlds are unaffected. Apply changes with `/prisons reload mines`.

See [pickaxe appearance](https://docs.mantic.dev/mantic-prisons/mining-and-pickaxes/pickaxe-appearance.md) for the progression-style tool template, XP bar and readable enchant display names.

Global boosters are available through `/booster global`, with admin start/clear controls in its menu and console support. They reuse configured booster types, save their server queue, stack with personal boosts and expose PlaceholderAPI values. See [boosters](https://docs.mantic.dev/mantic-prisons/economy-and-progression/boosters.md#global-server-boosters).

The default prison navigation includes mine management, both backpacks, payments and gang management. Commands requiring arguments offer a clickable command to fill in. Mine Upgrades shows its purchase steps and current/next-level size; see [gameplay navigation](https://docs.mantic.dev/mantic-prisons/admin-and-configuration/prison-menu.md#gameplay-navigation).

Gameplay setup: [bombs, daily rewards, skins, enchant prestige and the season pass](https://docs.mantic.dev/mantic-prisons/economy-and-progression/gameplay.md). Open `/prison gameplay` to browse their default menus.

Use `/prisonreward` or `/prisons editor rewards` to create reusable currency, item, command, bomb, booster and skin rewards. Daily rewards, season tiers, quests, achievements, Lucky Blocks, starter rewards and mining events accept their IDs. Deferred Lucky Block and event prizes use a saved delivery queue. See [shared rewards](https://docs.mantic.dev/mantic-prisons/economy-and-progression/rewards.md).

Administrators can open `/prisons editor` to choose common settings, mine block mixes, enchants, progression or shared rewards. The mine-pattern creator previews block proportions, saves a backup and reloads the configuration. See [Admin tools](https://docs.mantic.dev/mantic-prisons/admin-and-configuration/admin-tools.md).

Gangs can work together on daily contracts, weekly goals and permanent bank-funded projects. Use `/gang goals` to open the shared menus, or `/gang projects` for member-slot and permission unlocks. Configure the catalogue and menus in `features/gangs/goals.yml`; see [Gangs](https://docs.mantic.dev/mantic-prisons/multiplayer-and-activities/gangs.md#contracts-weekly-goals-and-shared-projects).
