HyMinions

---

For issues or suggestions, please raise them in the HBL Nexus discord HERE

---

This plugin is in active development. It has been in extensive testing for some time now and is believed to be in a state for use. However, please note that as with anything it's not possible to test all edge cases.

Please report any issues or feedback in the Discord before leaving a review. We want to hear from you and make community suggestions heard.

---

Put your resources to work. HyMinions adds resource-generating NPC minions to Hytale that keep producing even when you are offline. Place one, come back later, collect your haul.

---

What Are Minions?

A minion is a small NPC you place in the world. It mines its assigned resource on a timer and stores the results. Walk up, interact with it, and collect everything it has built up since you last visited. Leave it running overnight and log in to a full storage ready to collect.

Each minion has five upgrade tiers. Higher tiers produce more per tick and hold more in storage. Upgrading requires you to hand over a quantity of the same resource the minion produces, so minions fund their own progression. The rarer the ore, the longer the grind to max tier.

---

9 Minion Types ( base to be extended )

additional minions configurable in minion-types.json

Minion	Produces	Rarity
Stone Minion	Stone	Common
Iron Minion	Iron Ore	Common
Copper Minion	Copper Ore	Common
Cobalt Minion	Cobalt Ore	Uncommon
Thorium Minion	Thorium Ore	Uncommon
Gold Minion	Gold Ore	Average
Silver Minion	Silver Ore	Average
Adamantite Minion	Adamantite Ore	Rare
Mithril Minion	Mithril Ore	Very Rare

Rarer ore types generate fewer resources per tick at the same tier. A Tier 5 Adamantite Minion is a genuine long-term goal.

Other minion types (coming soon)

We're looking into foraging minions, harvesting minions and combat minions, we want to work our way out of beta before expanding types.

Crafting and Upgrading

Everything goes through the Workbench. No commands needed for normal play.

Craft a Tier 1 minion:

• 1x Crude Pickaxe + 8x of the ore type

Upgrade to the next tier:

• 1x current tier minion item + N x of the ore type

Default upgrade costs:

Upgrade	Stone	All Ores
Tier 1 to Tier 2	500	500
Tier 2 to Tier 3	1,500	750
Tier 3 to Tier 4	4,000	1,000
Tier 4 to Tier 5	4,000	1,000

Pick up your minion at any time using the Pick Up button in its stats panel. Stored resources are collected automatically before it returns to your inventory.

---

The Stats Panel

Interact your minion NPC to open its stats panel. It shows:

• Minion type and tier
• Which resource it produces
• Current storage with a live animated progress bar
• Production rate (per tick and per minute)
• All-time resources generated
• Upgrade craft cost
• Collect Resources and Pick Up buttons

The storage bar updates every second in real time between production ticks.

---

Offline Production

Minions never stop. The tick calculation is time-based, not server-tick-based, so everything a minion should have produced while you were offline is calculated exactly when you next interact with it.

Log in after a long session away and your minions will have filled their storage. You get a notification on login telling you which ones are ready to collect.

---

Progression

Each player can place up to 4 minions at once by default. All values are configurable. Server operators can tune tick speed, tier rates, upgrade costs, and per-type production scales through two JSON files with no recompiling required.

---

Requirements

• Just a Hytale server running pre-release 2026.03.20-db226053c
• While there is a patch in-place so that it can run on the release patchline 2026.02.19-1a311a592 we do not recommend this and don't support that version

---

Support

This plugin is in beta. If you encounter any issues, please join the HBL Nexus Discord before leaving a review: https://discord.com/invite/aCE6HqfCHj