# VeinStorm
**Vein mining done right.** Hold one key to mine a whole ore vein, fell an entire tree, dig a tunnel or harvest a field of crops. Works on **Fabric** and **NeoForge**, needs no library mods, and every setting can be changed in game.
---
## ✨ Features
- **Real block breaking** – every block in the vein goes through the normal vanilla break logic. Fortune, Silk Touch, Unbreaking, statistics and other mods' break events all work. If a claim/protection mod protects a block, it is not broken.
- **No lag** – blocks break over a few ticks, spreading outward from the first block like a wave.
- **Shapes** – Vein, Tunnel 1×2, Tunnel 3×3, Area 3×3, Stairs up and Stairs down. Hold the vein key and scroll the mouse wheel to switch.
- **Smart tree felling** – natural trees are recognized by their leaves. Only the logs above the cut are felled and the leaves drop right away. Log houses are never treated as trees.
- **Crop harvesting** – mature crops are harvested and replanted with one of their own seeds. Growing crops are left alone.
- **Right-click area actions** – while holding the key, an axe strips a whole log column, a shovel makes paths and a hoe tills soil (following the selected shape).
- **Drops go to your inventory** – items and XP are collected straight into your inventory. You can also have them dropped together in one spot or at each block.
- **Live preview** – the blocks that will break get one clean outline, faintly visible through walls. The HUD shows the shape and block count.
- **Undo** – undo your last action with `/veinstorm undo` or a key. It is designed so items can never be duplicated.
- **Tool tier limits (optional)** – a wooden pickaxe breaks fewer blocks than a netherite one.
- **Vein Miner enchantment** – in *Bonus* mode, enchanted tools work on ores and trees without the key. In *Required* mode, vein mining only works with an enchanted tool.
- **Statistics and 7 advancements** – First Vein, Mother Lode, Diamond Hunter, Lumberjack, Farmer, Underground Master.
- **In-game settings** – admins change the server settings, every player changes their own personal settings. No config file editing needed.
- **Server friendly** – players without VeinStorm can still join; they just can't vein mine. FTB Ultimine and Liteminer block/tool tags are also read.
---
## 🎮 How to use
| Action | How |
|---|---|
| Vein mine | Hold **`** (the key left of 1) and mine |
| Switch shape | Hold **`** and scroll the mouse wheel |
| Area right-click | Hold **`** and right-click with an axe, shovel or hoe |
| Undo | `/veinstorm undo`, or bind "Undo last action" in Controls |
| Settings | `/veinstorm`, or the config button in the mod list (NeoForge, or Fabric with Mod Menu) |
| Auto modes | Ores (and trees with an axe) without the key. Sneak to pause. |
All keys can be changed in **Options → Controls → Key Binds → VeinStorm**.
---
## ⚙️ Settings
**Personal (every player):** key mode (hold/toggle), shape, auto on ores, auto on trees, where drops go, tool protection, personal block limit, break effects, preview outline, see-through outline, HUD.
**Server (admins only, OP level 2 or the singleplayer world owner):**
- **General:** enable/disable, max blocks (1–1024), blocks per tick, max distance, diagonal blocks, match ore variants, require correct tool
- **Hunger:** hunger cost per block, minimum food level
- **Features:** allow inventory drops, allow auto ores, smart tree felling, allow auto trees, fast leaf decay, replant crops, right-click area actions, enchantment mode, undo time
- **Shapes:** enable/disable each shape, tunnel length
- **Tool tier limits:** limits for hand, wood, stone, gold, iron, diamond and netherite
Server admins can also use commands, including from the server console:
```
/veinstorm config list all server settings
/veinstorm config <setting> show one setting
/veinstorm config <setting> <value> change a setting, e.g. /veinstorm config maxBlocks 128
/veinstorm reload reload config/veinstorm/server.json
```
---
## ↩️ Undo rules
Undo is built so it can never be used to duplicate items:
- In survival, every item you got from the action must still be available (in your inventory or on the ground).
- Mining that gave XP (coal, diamond, redstone…) can't be undone, so XP and Mending can't be farmed.
- Blocks with contents (chests etc.) can't be undone.
- If any of the blocks changed afterwards, nothing is undone.
- Tool durability and hunger are not refunded.
---
## 📦 Compatibility
| | Minecraft | Requirements |
|---|---|---|
| **NeoForge** | 1.21, 1.21.1 | NeoForge 21.0.143 or newer (all 21.1.x versions) |
| **Fabric** | 1.21, 1.21.1 | Fabric Loader 0.16.0+, Fabric API 0.100.1+, Mod Menu optional |
Install VeinStorm on **both the client and the server**. Players without it can still join the server.
Data pack tags: `veinstorm:excluded_blocks`, `veinstorm:block_whitelist`, `veinstorm:excluded_tools`.
---
## ❓ FAQ
**Does it work in singleplayer?** Yes. In singleplayer you are the admin and can change every setting.
**Will it break my house when I chop a tree?** No. Smart tree felling only works on natural trees with natural leaves. Logs placed by players are never treated as a tree in auto mode.
**Can admins limit it?** Yes. Admins can turn off any feature or shape, lower the block limit, enable hunger costs or tool tier limits, or require the Vein Miner enchantment.
**Languages:** English, Turkish.
# VeinStorm
**Damar kazma, doğru şekilde.** Tek bir tuşu basılı tutarak bütün cevher damarını kaz, ağacı tek seferde kes, tünel aç ya da tarlayı hasat et. **Fabric** ve **NeoForge** ile çalışır, kütüphane modu gerektirmez ve bütün ayarlar oyun içinden değiştirilir.
---
## ✨ Özellikler
- **Gerçek kırma:** Damardaki her blok vanilla kırma yolundan geçer. Fortune, Silk Touch, Unbreaking, istatistikler ve diğer modların kırma olayları çalışır. Claim/koruma modunun koruduğu blok kırılmaz.
- **Lag yapmaz:** Bloklar birkaç tick'e yayılarak, ilk bloktan dışa doğru dalga gibi kırılır.
- **Şekiller:** Damar, Tünel 1×2, Tünel 3×3, Alan 3×3, Merdiven ↑ ve Merdiven ↓. Damar tuşu basılıyken fare tekerleğiyle değişir.
- **Akıllı ağaç kesme:** Doğal ağaçlar yapraklarından tanınır. Sadece kesilen yerin üstündeki kütükler kırılır, yapraklar hemen dökülür. Kütükten yapılmış evler ağaç sayılmaz.
- **Ekin hasadı:** Olgun ekinler hasat edilir ve kendi tohumuyla yeniden ekilir. Büyümekte olanlara dokunulmaz.
- **Sağ tık alan işlemleri:** Tuş basılıyken balta bütün kütük sütununu soyar, kürek yol açar, çapa toprak sürer (seçili şekle göre).
- **Eşyalar envantere:** Eşyalar ve XP doğrudan envantere gelir. İstersen tek bir noktada birleşerek ya da her blokta ayrı düşer.
- **Canlı önizleme:** Kırılacak bloklar tek parça dış çerçeveyle gösterilir, duvarların arkasından da soluk görünür. Ekranda şekil ve blok sayısı yazar.
- **Geri alma:** Son işlemi `/veinstorm undo` ya da bir tuşla geri al. Eşya kopyalamaya izin vermeyecek şekilde tasarlandı.
- **Alet seviyesine göre limit (isteğe bağlı):** Tahta kazma netherite kazmadan daha az blok kırar.
- **Damar Kazıcı büyüsü:** *Bonus* modunda büyülü aletler cevher ve ağaçlarda tuşsuz çalışır. *Zorunlu* modunda damar kazma sadece büyülü aletle olur.
- **İstatistikler ve 7 başarım:** İlk Damar, Ana Damar, Elmas Avcısı, Oduncu, Çiftçi, Yeraltı Ustası.
- **Oyun içi ayarlar:** Adminler sunucu ayarlarını, her oyuncu kendi ayarlarını oyundan değiştirir.
- **Sunucu dostu:** VeinStorm'u olmayan oyuncular da sunucuya girebilir, sadece damar kazamazlar. FTB Ultimine ve Liteminer tag'leri de okunur.
---
## 🎮 Kullanım
| Ne | Nasıl |
|---|---|
| Damar kazma | **`** tuşunu (1'in solundaki) basılı tut ve kaz |
| Şekil değiştirme | **`** basılıyken fare tekerleğini çevir |
| Sağ tık alan işlemi | **`** basılıyken balta, kürek ya da çapa ile sağ tıkla |
| Geri alma | `/veinstorm undo` ya da Kontroller'den "Son işlemi geri al" tuşunu ata |
| Ayarlar | `/veinstorm` ya da mod listesindeki ayar düğmesi (NeoForge, ya da Fabric'te Mod Menu ile) |
| Otomatik modlar | Cevherler (ve baltayla ağaçlar) tuşsuz. Eğilince (shift) durur. |
---
## 📦 Uyumluluk
| | Minecraft | Gereksinimler |
|---|---|---|
| **NeoForge** | 1.21, 1.21.1 | NeoForge 21.0.143 ve üstü (bütün 21.1.x sürümleri) |
| **Fabric** | 1.21, 1.21.1 | Fabric Loader 0.16.0+, Fabric API 0.100.1+, Mod Menu isteğe bağlı |
VeinStorm'u hem **istemciye** hem **sunucuya** kur. Modu olmayan oyuncular da sunucuya girebilir.
**Diller:** İngilizce, Türkçe.