Aces OmniHarvest

Aces OmniHarvest is an all-in-one harvesting and mining quality-of-life mod for Hytale.

It combines vein mining, tree felling, terrain excavation, tunnelling, stair digging, and area harvesting into one configurable system.

The goal is to speed up repetitive gathering while still respecting tools, crop behaviour, natural trees, and vanilla farming mechanics.

Features

• Vein Mining
Mine connected ores and rocks using the correct tool.

• Tree Felling
Fell natural trees with a hatchet while protecting player-built wooden structures.

• Smart Mode
Harvest connected resources while still respecting the held tool and target type.

• Tunnel Modes
Use either a precise 1×1 tunnel or a faster 3×3 tunnel in the direction you are facing.

• Staircase Modes
Dig staircases upward or downward with enough headroom automatically cleared.

• Harvest Mode
Harvest only the exact same resource type you interacted with.

For example, harvesting corn only gathers nearby corn, and harvesting one flower type only gathers matching flowers.

• Harvest All Mode
Uses the original broad-family harvesting behaviour, allowing nearby related resources to be gathered together.

Harvest and Harvest All have their own independently configurable horizontal radius from 5 to 20 blocks, with vertical coverage included.

Large harvests are processed in batches to help reduce server stutter.

Harvest Radius

Harvest and Harvest All each have their own radius setting.

Both can be configured from 5 to 20 blocks using in-game commands.

• Harvest Radius
Controls the range used by the precise Harvest mode.

• Harvest All Radius
Controls the range used by the broader Harvest All mode.

Use:

/aoh radius status
/aoh radius harvest <5-20>
/aoh radius harvestall <5-20>

Radius settings are saved between server sessions.

Vanilla Crop Behaviour Preserved

Planted crops use Hytale’s normal farming systems.

Eternal / infinite-seed crops retain their normal post-harvest state instead of being removed.

Multi-block Eternal crops are handled as a single physical crop during area harvesting to prevent duplicate harvests and unwanted extra drops.

Wild crops are handled separately so naturally found crops can still be harvested correctly.

Tree Safety

OmniHarvest only treats natural trunks and logs with nearby foliage as trees.

Player-built wooden structures such as planks, beams, fences, stairs, and similar blocks are protected.

Quick Mode Switching

When OmniHarvest is set to On, hold your crouch key (CTRL) and use the mouse wheel to cycle through the modes available for your currently held tool.

A small HUD shows your current OmniHarvest mode.

Available modes are tool-specific:

• Hatchet
Normal → Smart → Harvest → Harvest All

• Shovel
Normal → Smart → Harvest → Harvest All

• Pickaxe
Normal → Smart → Tunnel 1×1 → Tunnel 3×3 → Staircase Up → Staircase Down → Harvest → Harvest All

• Hand / Other
Normal → Harvest → Harvest All

Your selected hotbar tool is automatically restored after cycling modes.

HUD

A small HUD shows your current OmniHarvest mode while the mod is enabled.

The HUD can be turned on or off independently of OmniHarvest functionality.

You can choose from preset positions or set a manual position.

HUD settings are saved per player.

Activation Modes

Off
Disables OmniHarvest.

On
Special mining modes activate while holding your crouch key.

Always
Normal mode is always active without requiring crouch.

Harvest and Harvest All use the normal interact key and do not require crouching.

Available Modes

• Normal
• Smart
• Tunnel 1×1
• Tunnel 3×3
• Staircase Up
• Staircase Down
• Harvest
• Harvest All

Commands

/aoh status
/aoh on
/aoh off
/aoh always
/aoh normal
/aoh smart
/aoh tunnel1
/aoh tunnel
/aoh up
/aoh down
/aoh harvest
/aoh harvestall

Harvest Radius Commands

/aoh radius status
Shows the current Harvest and Harvest All radius values.

/aoh radius harvest <5-20>
Changes the radius used by Harvest mode.

/aoh radius harvestall <5-20>
Changes the radius used by Harvest All mode.

HUD Commands

/aoh hud on
/aoh hud off
/aoh hud status

/aoh hud position topleft
/aoh hud position topcenter
/aoh hud position topright
/aoh hud position middleleft
/aoh hud position middleright
/aoh hud position bottomleft
/aoh hud position bottomcenter
/aoh hud position bottomright

/aoh hud position manual <x> <y>
/aoh hud position reset

Aliases

/acesomniharvest
/avm
/acesveinmine

Custom Tool Overrides

You can add or remove custom blocks from the Pickaxe, Hatchet, Shovel, and Hand categories using in-game commands.

Examples:

/aoh tool pickaxe add <block>
/aoh tool hatchet add <block>
/aoh tool shovel add <block>
/aoh tool hand add <block>

/aoh tool <tool> remove <block>
/aoh tool <tool> list

The older axe command remains available as a backwards-compatible alias for hatchet.

Custom mappings are saved between sessions.

Admin Debug Controls

Debug logging is disabled by default.

Server admins / OPs can enable it when needed with:

/aoh debug on
/aoh debug off
/aoh debug status

Multiplayer

Aces OmniHarvest is designed as a server-side Hytale plugin.

Compatibility

Hytale 0.6.x

Author

AcesGamingUK