Skip to content

JoinFreeMe/miningplus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mining+

Vein mining, tunnel boring, and excavation patterns for Hytale.

Break one ore - mine the entire vein. Dig tunnels with a single swing. Mining+ gives you powerful mining tools with a clean in-game config UI.

Features

  • Vein Mining - Mine one ore and all connected ores of the same type break automatically. Uses 26-directional adjacency so diagonal ores are included.
  • Targeted Block Mining - Vein-mine any block type, not just ores. Break one stone block and all connected stone breaks with it.
  • Tunnel Patterns - Dig 1x1, 2x1 (player height), or 3x3 tunnels in the direction you're facing.
  • Area Patterns - Break 3x3x3 or 5x5x5 cubes into the wall from the face you mine.
  • In-Game Config UI - Open with /mining+. No items needed.
  • Activation Keys - Always active, or require Crouch (Ctrl) / Walk (Alt) to be held.
  • Per-Player Settings - Each player's preferences are saved to disk and persist across restarts.
  • Server Limits - Admins set max blocks, search depth, and excluded blocks in config.json. Player values are capped at the server maximum.
  • Block Exclusion - Server admins can prevent specific blocks from being mined (bedrock excluded by default).
  • Smart Depth Capping - Tunnel depth auto-adjusts based on max blocks and pattern size so you never get weird partial tunnels.
  • Proper Drops - All mined blocks drop their correct items using the game's drop tables.

Installation

  1. Download the latest release JAR from CurseForge or the Releases page.
  2. Place the JAR in your server's Server/mods/ directory.
  3. Start the server. A MiningPlus/ folder will be created in mods/ with the default config.

Commands

Command Description
/mining+ Open the config UI

Aliases: /m+, /miningplus

Configuration

Server Config (mods/MiningPlus/config.json)

{
  "enabled": true,
  "maxBlocksPerAction": 128,
  "maxSearchDepth": 64,
  "excludedBlocks": ["bedrock", "rock_bedrock"]
}

These values are the server-wide maximums. Players can set their own values up to these limits via the in-game UI.

The excludedBlocks list prevents specific blocks from being broken by any mining pattern. Block names are case-insensitive.

Player Config (mods/MiningPlus/players/{uuid}.json)

Created automatically when a player first opens the config UI. Stores their personal preferences:

{
  "enabled": true,
  "activationMode": "walk",
  "pattern": "ORES_ONLY",
  "maxBlocksPerAction": 64,
  "maxSearchDepth": 32
}

Excavation Patterns

Pattern Description
Ores Only Flood-fill connected ores of the same type
Targeted Block Flood-fill any connected blocks matching the mined type
Tunnel 1x1 Single-block tunnel
Tunnel 2x1 Player-height tunnel (2 high, 1 wide)
Tunnel 3x3 Full 3x3 tunnel, centered on mined block
3x3x3 Cube 3x3 area, 3 blocks deep
5x5x5 Cube 5x5 area, 5 blocks deep

All patterns use block face detection - the tunnel extends in the direction away from where you're standing.

Building from Source

Requires Java 25 and access to the Hytale Maven repository.

./gradlew build

The built JAR will be at build/libs/MiningPlus-1.2.0.jar.

License

MIT

Links

About

A Hytale Plugin which allows you to mine vein ores & define different mining strategies

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages