Описание
# ChainVeinFabric / 连锁采集 Fabric
A modern, efficient, and configurable Chain Mining & Interaction mod for Minecraft Fabric 1.21+.
Compatible with vanilla servers (client-side mode) and enhanced when installed on the server.
一个适用于 Minecraft Fabric 1.21+ 的现代、高效且可高度配置的连锁采集与交互模组。
兼容原版服务器（客户端模式），并在服务端安装时提供增强功能。
---
## ✨ Features / 功能特性
* **Configurable Chain Mining**: Mine connected blocks of the same type automatically.
* **可配置的连锁采集**：自动采集相连的同类方块。
* **Chain Planting**: Quickly plant seeds on compatible soil. Supports wheat, carrots, potatoes, etc.
* **连锁种植**：在兼容的耕地上快速补种。支持小麦、胡萝卜、马铃薯等作物。
* **Chain Wax/Scrape/Strip**: Batch process blocks using tools or items. Supports waxing copper, scraping rust, stripping logs, and tilling soil.
* **连锁打蜡/除锈/去皮**：使用工具或物品批量处理方块。支持铜块打蜡、除锈、原木去皮以及耕地。
* **Multiple Search Shapes & Modes**: Support for various search algorithms including Cube, Sphere, and Adjacency (Face, Edge, Corner connections). Now supports directional limits (Horizontal, Vertical, Upward, Downward).
* **多种搜索算法与形状**：支持包括立方体（Cube）、球形（Sphere），以及相邻扩散（面、棱、顶点连接）在内的多种搜索模式，并新增各维度的蔓延方向限制（水平、垂直、向上、向下）。
* **Anti-Kick Protection**: Set packet intervals for vanilla servers to prevent "Too many packets" kicks.
* **防踢出保护**：针对原版服务器可设置自定义发包间隔，防止因操作过快被服务器踢出。
* **Visual Configuration GUI**: Press `V` to open a user-friendly configurable, scrollable screen. Smart UI elements will enable/disable based on server environment.
* **可视化配置界面**：按 `V` 键打开友好、支持滚动的配置界面。UI 元素会根据服务器环境自动启用或禁用。
* **Whitelist Management**: Per-mode whitelists for mining, crops, and utility interactions.
* **白名单管理**：针对采集、作物和工具交互分别提供独立的白名单。
* **Tool Protection**: Smartly calculates remaining durability. Instead of failing when durability is low, it now limits the max chain amount to your remaining durability (minus a safety buffer of 10) to prevent breaking. Properly ignores empty hands and zero-durability items.
* **工具保护**：智能计算剩余耐久。当耐久度低时非但不会直接失效，而是将最大连锁数量动态限制为剩余耐久值（保留10点），防止工具损坏损坏。对空手与无耐久物品会自动正确豁免判定。
* **Unbreakable Block Filter**: Automatically filters out unbreakable blocks (like Bedrock or Barriers) in survival mode, maintaining game balance even with incorrect whitelists.
* **防破坏基岩保护**：生存模式下自动过滤不可破坏方块（如基岩、屏障等），防止错误配置白名单导致的平衡性问题。
---
## 📸 Screenshots / 截图
> *Description: Mining mode configuration with block whitelist.*
> *描述：连锁采集模式下的方块白名单管理界面。*
> *Description: Action Bar feedback after chain mining blocks.*
> *描述：连锁采集后的动作栏反馈信息。*
> *Description: Chain Planting configuration showing the item whitelist (seeds/crops).*
> *描述：连锁种植模式配置界面，展示种子/作物白名单。*
> *Description: Chain Planting configuration showing the item whitelist (seeds/crops).*
> *描述：连锁种植模式配置界面，展示种子/作物白名单。*
> *Description: Chain planting carrots in a large area with a single click.*
> *描述：一键在大范围内连锁种植胡萝卜。*
> *Description: Chain Wax/Scrape/Strip configuration showing the "Applicable Blocks" whitelist.*
> *描述：连锁打蜡/除锈/去皮模式配置界面，展示“适用方块”白名单。*
> *Description: Stripping a whole stack of logs instantly using an axe.*
> *描述：使用斧头瞬间连锁去皮整堆原木。*
---
## 🛠️ Usage / 使用说明
1. **Open Config**: Press **`V`** to open the menu. Use the **Mode Dropdown** to switch between Mining, Planting, and Utility modes.
* **打开配置**：按 **`V`** 键打开菜单。使用**模式下拉框**在采集、种植和交互模式间切换。
2. **Setup Whitelists**:
* **Mining**: Add blocks like `iron_ore` or `oak_log`.
* **Planting**: Add items like `carrot` or `wheat_seeds`.
* **Utility**: Add blocks you want to interact with, like `oak_log` (for stripping) or `grass_block` (for tilling).
* **设置名单**：
* **采集**：添加如 `iron_ore` 或 `oak_log` 等方块。
* **种植**：添加如 `carrot` 或 `wheat_seeds` 等种子物品。
* **交互**：添加想要交互的方块，如 `oak_log`（去皮）或 `grass_block`（耕地）。
3. **Perform**:
* **Mine**: Break a whitelisted block.
* **Plant**: Right-click soil with seeds.
* **Interact**: Right-click with tools (Axe/Hoe) or items (Honeycomb).
* **执行**：
* **采集**：挖掘白名单方块。
* **种植**：手持种子右键耕地。
* **交互**：手持工具（斧、锄）或物品（蜜脾）右键目标方块。
---
## ⚙️ Configuration Options / 配置选项
| Option / 选项 | Description / 描述 |
| :--- | :--- |
| **Chain Mode / 模式** | Toggle between Mine (挖掘), Plant (种植), and Wax/Scrape/Strip (交互). |
| **Max Blocks / 数量上限** | Max blocks/crops per action. |
| **Diagonal Edge / 斜边方向** | Toggle 12-way edge adjacency. (斜边连接模式). |
| **Diagonal Corner / 斜角方向** | Toggle 8-way corner adjacency. (斜角连接模式). |
| **Packet Interval / 发包间隔** | Ms delay between packets on vanilla servers. (原版服务器发包间隔). |
| **Tool Protection / 工具保护** | Stops if durability