XandeMiner

# ⛏️ XandeMiner !(https://img.shields.io/badge/Minecraft-1.21-success) !(https://img.shields.io/badge/Forge-Compatible-red) !(https://img.shields.io/badge/License-MIT-blue) =-=(PT-BR)=-= Um mod utilitário para Minecraft Forge focado em otimizar a coleta de recursos. O XandeMiner implementa uma mecânica inteligente de *Vein Mining*, permitindo que os jogadores quebrem veios inteiros de minérios de uma só vez, poupando tempo e mantendo o balanceamento do jogo. ## 🌟 Funcionalidades * **Mineração em Cadeia (Vein Miner):** Quebre um bloco de minério enquanto estiver agachado (Sneak/Shift) para minerar automaticamente todos os minérios idênticos conectados a ele. * **Algoritmo Otimizado:** Utiliza um sistema de busca em largura (BFS) seguro que vasculha os blocos em uma grade 3x3x3, com um limite rígido de 64 blocos por vez para garantir zero lag no servidor. * **Desgaste Realista de Ferramentas:** A quebra em cadeia calcula o dano exato que a sua picareta deve sofrer (1 de durabilidade por bloco quebrado). O sistema é 100% integrado ao Minecraft Vanilla e respeita perfeitamente o encantamento de **Inquebrável (Unbreaking)**. * **Compatibilidade Universal:** Desenvolvido utilizando as `Tags.Blocks.ORES` oficiais do Forge. Isso significa que o mod funciona automaticamente com qualquer minério adicionado por outros mods (Cobre, Estanho, Urânio, etc.), sem necessidade de configuração extra. * **Proteção contra Loops:** Possui um sistema interno de cache de memória (`activeMiners`) que previne loops infinitos de eventos de quebra de blocos. ## 🚀 Como Usar no Jogo 1. Equipe uma picareta (ou a ferramenta adequada para o bloco). 2. Segure a tecla de agachar (padrão: `Shift`). 3. Quebre qualquer bloco de minério. 4. Assista a todo o veio ser destruído instantaneamente e colete os seus drops! =-=(EN)=-= A utility mod for Minecraft Forge focused on optimizing resource gathering. XandeMiner implements an intelligent Vein Mining mechanic, allowing players to break entire ore veins at once, saving time while preserving game balance. ## 🌟 Features * **Chain Mining (Vein Miner): Break an ore block while sneaking (Sneak/Shift) to automatically mine all identical ores connected to it. * **Optimized Algorithm: Uses a safe breadth-first search (BFS) system that scans blocks in a 3×3×3 grid, with a strict limit of 64 blocks at a time to ensure zero server lag. * **Realistic Tool Wear: Chain breaking calculates the exact damage your pickaxe should take (1 durability per block broken). The system is 100% integrated with Vanilla Minecraft and fully respects the Unbreaking enchantment. * **Universal Compatibility: Developed using Forge’s official Tags.Blocks.ORES. This means the mod automatically works with any ores added by other mods (Copper, Tin, Uranium, etc.), without requiring extra configuration. * **Loop Protection: Includes an internal memory cache system (activeMiners) that prevents infinite block break event loops. ## 🚀 How to Use In-Game 1. Equip a pickaxe (or the appropriate tool for the block). 2. Hold the sneak key (default: Shift). 3. Break any ore block. 4. Watch the entire vein be instantly mined and collect the drops!