BetterVeinMiner

BetterVeinMiner is a configurable excavation mod for Hytale.

Instead of limiting mining to a simple ore vein, BetterVeinMiner lets you choose how blocks are excavated: classic freeform vein mining, cube mining, tunnels, walls, and even diagonal stair-style digging.

The mod is designed to stay simple to use in-game while still giving each player their own personal settings directly from chat.

Features

- Vein mining works on all block types

- Block drops are preserved

- Tool durability is consumed block by block

- Per-player toggle with `/bvm on` and `/bvm off`

- Per-player scan limit with `/bvm radius`

- Per-player excavation settings with `/bvm config`

- Multiple excavation patterns

- Multiple activation modes

- Multiple orientation modes

Excavation Patterns

- `free` / `freeform`

Classic vein mining. Follows connected matching blocks in any direction.

- `cube`

Excavates a 3x3x3 area.

- `tunnel1` / `t1`

Mines a 1x1 tunnel.

- `tunnel2` / `t2`

Mines a 1x2 tunnel.

- `tunnel3` / `t3`

Mines a 3x3 tunnel.

- `wall3` / `w3`

Mines a 3x3 wall.

- `wall5` / `w5`

Mines a 5x5 wall.

- `diagonal` / `diag`

Mines a diagonal staircase pattern.

Orientation Modes

- `block`

Aligns the pattern based on the side of the target block relative to the player.

- `player`

Aligns the pattern to the player's view direction.

Mining Modes

- `all`

BetterVeinMiner works on all blocks.

- `ores`

BetterVeinMiner only works on ore-like blocks.

- `off`

Excavation is disabled through config.

Activation Keys

- `walk`

Active while not crouching.

- `crouch`

Active while crouching.

- `always`

Always active.

Commands

Toggle

- `/bvm on`

Enables BetterVeinMiner for yourself.

- `/bvm off`

Disables BetterVeinMiner for yourself.

Radius

- `/bvm radius`

Shows your current scan limit.

- `/bvm radius <number>`

Sets the maximum number of blocks BetterVeinMiner can scan and process.

Default: `16`

Examples:

- `/bvm radius 32`

- `/bvm radius 64`

- `/bvm radius 128`

Chat Configuration

- `/bvm config`

Shows your current BetterVeinMiner settings.

- `/bvm config --mode <value> --pattern <value> --orientation <value> --key <value>`

Updates your personal excavation settings.

Available flags:

- `--mode`: `all`, `ores`, `off`

- `--pattern`: `free`, `cube`, `tunnel1` (`t1`), `tunnel2` (`t2`), `tunnel3` (`t3`), `wall3` (`w3`), `wall5` (`w5`), `diagonal` (`diag`)

- `--orientation`: `block`, `player`

- `--key`: `walk`, `crouch`, `always`

Examples:

- `/bvm config --mode all --pattern free --orientation block --key crouch`

- `/bvm config --mode all --pattern cube --orientation player --key always`

- `/bvm config --mode ores --pattern free --orientation block --key crouch`

- `/bvm config --pattern t3 --orientation player`

- `/bvm config --pattern w5 --key walk`

Notes

- Settings are stored per player.

- Current settings are kept in memory and reset when the server restarts.

- Large patterns may require a higher `/bvm radius` value.

Quick Start

1. Enable the mod with `/bvm on`

2. Set your scan limit with `/bvm radius 32`

3. Choose your config with `/bvm config --mode all --pattern free --orientation block --key crouch`

4. Start mining

Better Vein Miner