EcoMinions

What is EcoMinions?

EcoMinions adds placeable mining minions to your server. Players place a minion item in the world, and the minionmines a configured set of blocks into its own storage for the owner to collect, sell, or process automatically.

Features

  • Placeable minions - spawn a minion from an item, each type mining its own set of target blocks

  • Per-minion storage - mined items collect into the minion's own inventory rather than the world

  • Idle while offline - a minion only mines while its owner is online; when the owner logs back in, theoffline span is credited in one go

  • Upgrades - each upgrade is a config-authored libreforge effect holder, purchased tier by tier; theshipped set includes speed, efficiency, radius, height, fortune, capacity, auto-smelt, auto-sell, and experience,but any libreforge effect can be wired up as an upgrade

  • Compacting - a shared catalog of recipes that compress bulk drops into their block form; each miniontype opts into whichever recipes it wants, and each recipe is bought (and can be gated) independently

  • Fuel - minions consume fuel to stay active, with different fuel items burning for different durations

  • Item lookup integration - every minion's spawn item is available to any eco item lookup as ecominions:<id>

How does it work?

A minion is placed from an item and appears as an armor stand that mines nearby target blocks into its ownstorage. While its owner is online and its chunk is loaded, it mines on a timer, following the speed-ticks andefficiency-ticks set for its type and level.

When the owner logs out, or the minion's chunk unloads, the minion goes idle: it stops animating, stops mining,and stops emitting its full-storage particles. When the owner logs back in, the elapsed absence is credited inone go - cycles are simulated for the time that passed (scaled by unloaded-calculation.offline-efficiency),fuel is consumed for that simulated span rather than the whole wall-clock absence, and the resulting drops arecredited using each mined block's real drop table and passed through the minion's own effects in a singlebatch, so upgrades like fortune and auto-smelt still apply to offline mining. Mining then resumes live.

Every minion declares a type - miner, woodcutter or farmer - which decides what it does with the blocksit breaks: put them back, fell and replant them, or harvest and replant them. What each block is livesseparately in blocks/, so the same oak log is felled by a woodcutter and regenerated by a miner withouteither being configured for it. Custom blocks and items from ItemsAdder, Oraxen, Nexo and CraftEngine workanywhere a vanilla one does.

Upgrades, fuels, and compactor recipes extend what a minion can do - see the how-to pages below. Every minion'sspawn item is also registered with eco's item lookup system as ecominions:<id>, so shops, crates, and otherplugins that consume eco item lookups can reference or hand out a minion item directly.

Where to go next

  • Build a minion: How to Make a Minion walks through a full minion config.

  • Build an upgrade: How to Make an Upgrade covers upgrade tiers and costs.

  • Build a compactor recipe: How to Make a Compactor Recipe covers therecipe catalog and how a minion unlocks it.

  • Build a fuel: How to Make a Fuel covers fuel items and burn duration.

  • Plugin config: Plugin Config covers the plugin-wide settings.

  • Commands: Commands and Permissions lists every command and node.