🌐 中文文档

A high-performance chain-mining mod designed for GregTech: New Horizons (GTNH), running on Minecraft 1.7.10. Hold a key to mine in bulk — release to stop instantly.

1. Aim at the block you want to mine
2. Hold ` (grave / backtick, rebindable) — block outlines appear
3. Keep holding — blocks are chained and mined
4. Release the key — mining stops immediately
5. Scroll the mouse wheel to switch sub-modes
6. Press V to cycle main modes (Blast → Chain → Special)

Mines all blocks within a configurable radius around the target. 7 sub-modes, switchable with the mouse wheel:

Starting from the target block, automatically finds and mines all connected blocks of the same type. 2 sub-modes:

Non-mining utility functions. 3 sub-modes:

Two activation behaviours, configurable in the settings GUI:

• Hold (default): chain is active while the key is pressed
• Toggle: press once to start, press again to stop

While the chain key is held, the mouse wheel is locked from switching hotbar slots and is dedicated to cycling sub-modes. This can be disabled in the config.

While the chain key is held and you are aiming at a block, all blocks that would be included in the chain are highlighted with glowing outlines:

• Outlines are visible through walls — buried veins are fully visible
• Only blocks within render distance are shown to keep performance smooth
• Two render styles: Native (clean single-pass wireframe) and Modern (solid visible edges + translucent hidden edges)
• Can be turned off in the config

While the chain key is held, real-time info appears in the top-left corner:

[EZMiner] ■ Chain Active
  ○─ Blast Mode
  └─ Same Type
  └─ Chained Blocks: 128

• HUD hides automatically when the key is released
• Position can be set with /EZMiner hud pos <x> <y>
• Title animation can be set to Rainbow Bounce or Wave Highlight

All drops generated during a chain are collected and held back, then delivered in a single batch at the player's feet once the operation finishes — no entity-spam lag spikes.

Stack sizes always respect each item's maximum stack limit.

EZMiner's configuration is split into client and server parts:

Press E to open your inventory, then click the [EZMiner] Settings button on the left:

• Client Settings tab: preview, display, key mode, HUD animation, etc.
• Server Settings tab (OP only): radius, block limits, costs, preview caps, etc.

Numeric fields accept direct input; toggle options switch ON/OFF with a click.

All commands start with /EZMiner:

When Visual Prospecting is installed, EZMiner automatically records ore-vein data to the map overlay as it mines GT ore blocks — no need to manually right-click each ore. Works across all mining modes.

With LootGames installed, the Special mode's Minesweeper and Sudoku assistants can automatically solve puzzles for you.

When installed, EZMiner can optionally auto-hide the IGI HUD while its own HUD is visible to prevent overlap.

By default, GT and BartWorks ores only respond to Fortune III and below. EZMiner can lift this cap:

• When enabled, Fortune V, X, and higher enchantment levels work on GT/BW ores
• A configurable max Fortune level (up to 255)
• Option to treat player-placed ores as natural for Fortune bonuses

⚠️ This feature is injected via Mixin at game startup. Changes require a full game restart and cannot be applied through /EZMiner reloadConfig.

These server-side options control the trade-off between search speed and CPU/memory usage. All are configurable via the OP-only Server Settings tab in the in-game GUI or directly in EZMiner/EZMiner_Server.cfg.

Controls how often the background search thread checks for tick boundaries and cancellation. The search thread calls a cooperative yield check after processing this many positions — pausing until the next tick starts when the current tick has ended, and noticing chain cancellation promptly.

• 0 — check on every position (safest, legacy behaviour)
• N > 0 — check every N positions (searches run slightly faster but react to tick end / cancellation more coarsely)

Range: 0–4096. Most users should leave this at 0 unless profiling shows the yield check overhead is meaningful.

When enabled, chain-mode BFS uses two plain queues (current wave + next wave) instead of a single PriorityQueue ordered by distance from origin. This gives O(1) frontier operations instead of O(log n).

Trade-off: The wave-front expansion order differs from distance-ordered expansion. When a vein exceeds blockLimit, the set of blocks selected may differ between the two algorithms — both are valid subsets but they are not identical. If you rely on distance-prioritised selection (closest blocks mined first), keep this disabled.

⚠️ No profiling data is yet available for this flag. Test with Spark on your typical vein sizes before enabling in production.

When enabled, the visited-position tracking set uses fastutil's primitive LongOpenHashSet (behind a synchronised wrapper) instead of ConcurrentHashMap.newKeySet(). This avoids Long boxing overhead during large searches, potentially reducing GC pressure.

Trade-off: The synchronised wrapper has higher contention under heavy multi-threaded use than ConcurrentHashMap's lock-free design. The primitive set's initial capacity is capped at 65,536 (it grows as needed).

⚠️ No profiling data is yet available for this flag. Test with Spark before enabling in production.

Number of background worker threads for parallel block search during chain/blast operations. Higher values scan large radii faster but consume more CPU. Set to 0 to disable multi-threaded search entirely (falls back to single-thread). Range: 0–8.

Removes the per-tick block break limit so chains complete as fast as possible. A built-in safety cap still prevents server freezes. ⚠ May cause significant lag on extremely large veins.

Suppresses Hodgepodge's off-thread chunk-read warnings for EZMiner background threads (named EZMiner-*). The chunk-map snapshot still serves data safely from worker threads. Applied via Log4j2 filter at mod init — survives config reload without restart.

• Stops automatically before the tool would break (durability < 1)
• Hunger is consumed per block to prevent infinite free mining
• Never mines the block directly under the player's feet
• Ignores FakePlayer interactions to prevent exploits
• Immediately halts all operations when a player logs out
• Full error logging for easy troubleshooting

• Minecraft 1.7.10
• Forge 10.13.4.1614+
• Optimised for GregTech: New Horizons (GTNH) modpack