Auto Miner

Miner Types and Permissions

Miner types are defined in your config under autominer.types, and each is gated behind a permission node (default imperiummc.autominer.<type>). Only the types you have permission for appear in the menu or in /autominer buy. Every miner has a material icon, a display name, a cost, a currency, and a production_per_minutefigure that drives how much it generates.

The exact catalog depends on the server's config — admins can add or rebalance miner types without a plugin rebuild. Check the in-game menu to see what's currently available to you.

How to Get Started

1. Open the menu with /autominer or buy directly with /autominer buy <type>.
2. Confirm you have the right currency (most miners cost Auctoritas tokens) and a free slot.
3. Start the miner with /autominer start <type> or by clicking the lime dye in the menu.
4. Leave it running. Every minute it ticks once and adds to your pending rewards.
5. When you're ready, click the chest (or /autominer collect) to claim everything at once.

The Auto Miner Menu

The 27-slot GUI is built around three control items in the bottom row and a row of miner type icons up top. Knowing what each slot does makes the system fast to drive:

The chest (Collect) item also shows a live preview of your pending rewards in its lore, broken down by currency — so you can see how much is waiting before you claim.

Production and Rewards

A background task runs every 60 seconds (1200 ticks). For each online player with an active miner, it computes that miner's output as:

totalProduction = production_per_minute × minerCount

The result is then distributed across the miner's configured reward ratios. If a miner defines a rewards section (e.g. tokens: 1.0, beacons: 0.1), each currency gets totalProduction × ratio. If no rewards are configured, the entire output defaults to Auctoritas tokens. Generated rewards accumulate in your pending pool until you collect.

Because the task only iterates online players, your miner only produces while you're online — but pending rewards are never lost on logout. The plugin credits any unclaimed pending rewards to your balance automatically when you disconnect.

Slot Limits and Levels

You can own up to autominer.max_miners miners at once (default 5). Your total miner count also feeds a derived miner level reported by the autominer_level and autominer_efficiency placeholders:

Upgrading Miners

/autominer upgrade <type> pays the miner's configured upgrade_cost (default 5,000 tokens) to bump the miner's level. Internally the upgrade increments the stored count for that type — so each upgrade is effectively buying another unit of that miner, raising both your per-minute output and your total-miner level at once. Upgrading shares the same per-player cooldown as other vault actions.

The cost calculation is flat per upgrade (the configured upgrade_cost), not exponential — so unlike Automata, stacking upgrades on a single miner type is predictable and affordable. Buy the type you want, then pour upgrades into it.

Collecting Rewards

Clicking the chest item or running /autominer collect sweeps every pending currency into your balance (reason auto_miner:collect) and clears the pool. Each currency is credited separately and the chat message lists what you collected: e.g. "Collected: 12.4K tokens, 120 beacons."

• If nothing has accumulated yet, you'll see "No rewards to collect yet."
• Large claims (5,000+ Auctoritas) trigger an admin notification for fraud-monitoring.
• Right-clicking a banknote is unrelated — that's the Withdraw system.

Command Reference

PlaceholderAPI hooks: %imperiummc_autominer_status% (active type or INACTIVE), %imperiummc_autominer_count%, %imperiummc_autominer_level%, %imperiummc_autominer_pending%, plus per-type %imperiummc_autominer_count_<type>% and %imperiummc_autominer_cost_<type>%.

Auto Miner vs Automata

The two systems look similar but play differently. Pick the one that matches your loop — or run both, since they use different currencies.

Tips

1. Collect before you stop. Stopping a miner doesn't claim its pending rewards — collect first so nothing slips.
2. Log off safely. Pending rewards are auto-credited on quit, but collecting manually means the chat confirmation in case of a glitch.
3. Pick one type and stack upgrades. Flat upgrade costs reward concentration over breadth.
4. Watch the chest lore. It shows your pending breakdown — a quick way to see if a long AFK paid off.
5. Pair with an online play session. Auto Miner only ticks while online, so start it before sorting your vault or chatting, not before bed.
6. Combine with Automata. The two systems use different currencies — running both gives you a wider passive base.