> 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/tools-and-items/autominers.md). # Autominers Autominers are NPC miners a player can summon into their mine. They mine automatically, draining a shared **battery** that the player charges by mining themselves. Each miner has its own upgradeable **enchants**. Configured in `autominers.yml`. ```yaml settings: interval-ticks: 2 max-miners: 4 default-slots: 1 npc: name: '&aMiner #{miner}' # 16 chars max skin-name: '' # copy a player's skin by name ({player}/%player_name% = owner) skin-texture: '' skin-signature: '' hand-item: DIAMOND_PICKAXE dig-radius: 2 battery: max: 100 per-block-mined: 0.02 # % charge per block the OWNER mines drain-per-second: 0.05 # % drained per second while any miner is out bar-segments: 20 bar-symbol: '|' bar-filled-color: '&a' bar-empty-color: '&c' mine-delay-ms: 1000 # base time between a miner's breaks min-mine-delay-ms: 150 # fastest possible (with the Speed enchant) ``` ## `settings` | Key | Description | | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | `interval-ticks` | The autominer tick rate. | | `max-miners` | Max miners a player can own. | | `default-slots` | Slots everyone starts with (buy more with `/autominers give`). | | `npc.name` | Name above each miner's head. `{miner}` = miner number. | | `npc.skin-name` | Copy a player's skin by name. `{player}` / `%player_name%` = owner, `{miner}` = number. Overrides the texture/signature below. | | `npc.skin-texture` / `npc.skin-signature` | A base64 textures value + Mojang signature (used when `skin-name` is empty). | | `npc.hand-item` | Item held in the miner's hand. | | `npc.dig-radius` | The miner breaks blocks within this radius around itself, then drops to the column beneath it. | | `mine-delay-ms` | Base delay between a miner's breaks (`1000` = one block/second). The Speed enchant lowers it. | | `min-mine-delay-ms` | The floor the delay can be reduced to. | ## Battery Miners run on a shared battery. You **charge it up by mining yourself, then spend it** by summoning miners. | Key | Description | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `battery.max` | Battery capacity (%). | | `battery.per-block-mined` | % gained per block the **owner** mines. Only charges while **no** miners are summoned (and is scaled by the Charge Boost upgrade). | | `battery.drain-per-second` | % drained per second while at least one miner is out (flat, regardless of miner count). | | `battery.bar-*` | The battery bar display (segments, symbol, colours). | ## Stats ```yaml stats-format: ' &5┃ &f{name}: &d{amount}' stats: money: 'Money' tokens: 'Tokens' blocks: 'Auto Miner Blocks' pickaxexp: 'Mine Exp' ``` Lifetime totals tracked per player. `stats-format` is the line template (`{name}`, `{amount}`); `stats` maps each tracked key to a display name. ## Enchants (per miner) Enchant **levels are per miner**, bought with the configured currency. Each enchant under `enchants:`: ```yaml enchants: speed: name: '&7&lSpeed &8&lEnchant' max-level: 5 cost-currency: 'shards' base-cost: 500 delay-reduction-per-level: 150 # ms shaved off the break delay (mines faster) ``` | Enchant | Effect | | --------------- | ---------------------------------------------------------------------------------------------- | | `speed` | Shortens the break delay (`delay-reduction-per-level` ms/level), down to `min-mine-delay-ms`. | | `charge` | `chance-per-level`% chance per cycle to slow the battery drain; banks `battery-per-proc`%. | | `invincibility` | `chance-per-level`% chance to go invincible (no battery drain) for `duration-seconds`. | | `expfinder` | Pays `currency` `exp-per-block-per-level` per block per level (default `pickaxexp`). | | `frenzy` | `chance-per-level`% chance to start a frenzy: ×`multiplier` sell gains for `duration-seconds`. | | `expmagnet` | Multiplies the Mine EXP Finder gains by `multiplier-per-level` per level. | Common keys: `name`, `max-level`, `cost-currency`, `base-cost`, plus the per-enchant tuning shown above. ## Usage * **`/autominers`** (aliases `/autominer`, `/miners`) — open the autominers menu (summon/recall miners, view battery and stats; upgrade menu in `guis/autominer-upgrade.yml`). * Admins: * `/autominers give ` — give miner slots. * `/autominers battery ` — set a player's battery. * `/autominers chargeboost ` — add a permanent charge multiplier (used by the rebirth tree). --- # 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/tools-and-items/autominers.md?ask= ``` 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.