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
