ChainVeinFabric

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 / 功能特性

* 防破坏基岩保护: Mine connected blocks of the same type automatically. * 防破坏基岩保护：自动采集相连的同类方块。 * 防破坏基岩保护: Quickly plant seeds on compatible soil. Supports wheat, carrots, potatoes, etc. * 防破坏基岩保护：在兼容的耕地上快速补种。支持小麦、胡萝卜、马铃薯等作物。 * 防破坏基岩保护: Batch process blocks using tools or items. Supports waxing copper, scraping rust, stripping logs, and tilling soil. * 防破坏基岩保护：使用工具或物品批量处理方块。支持铜块打蜡、除锈、原木去皮以及耕地。 * 防破坏基岩保护: Support for various search algorithms including Cube, Sphere, and Adjacency (Face, Edge, Corner connections). Now supports directional limits (Horizontal, Vertical, Upward, Downward). * 防破坏基岩保护：支持包括立方体（Cube）、球形（Sphere），以及相邻扩散（面、棱、顶点连接）在内的多种搜索模式，并新增各维度的蔓延方向限制（水平、垂直、向上、向下）。 * 防破坏基岩保护: Set packet intervals for vanilla servers to prevent "Too many packets" kicks. * 防破坏基岩保护：针对原版服务器可设置自定义发包间隔，防止因操作过快被服务器踢出。 * 防破坏基岩保护: Press `V` to open a user-friendly configurable, scrollable screen. Smart UI elements will enable/disable based on server environment. * 防破坏基岩保护：按 `V` 键打开友好、支持滚动的配置界面。UI 元素会根据服务器环境自动启用或禁用。 * 防破坏基岩保护: Per-mode whitelists for mining, crops, and utility interactions. * 防破坏基岩保护：针对采集、作物和工具交互分别提供独立的白名单。 * 防破坏基岩保护: 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点），防止工具损坏损坏。对空手与无耐久物品会自动正确豁免判定。 * 防破坏基岩保护: 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. 交互: Press 交互 to open the menu. Use the 交互 to switch between Mining, Planting, and Utility modes. * 交互：按 交互 键打开菜单。使用交互在采集、种植和交互模式间切换。 2. 交互: * 交互: Add blocks like `iron_ore` or `oak_log`. * 交互: Add items like `carrot` or `wheat_seeds`. * 交互: 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. 交互: * 交互: Break a whitelisted block. * 交互: Right-click soil with seeds. * 交互: Right-click with tools (Axe/Hoe) or items (Honeycomb). * 交互： * 交互：挖掘白名单方块。 * 交互：手持种子右键耕地。 * 交互：手持工具（斧、锄）或物品（蜜脾）右键目标方块。

---

⚙️ Configuration Options / 配置选项

| Option / 选项 | Description / 描述 | | :--- | :--- | | Direct to Inv / 直接进包 | Toggle between Mine (挖掘), Plant (种植), and Wax/Scrape/Strip (交互). | | Direct to Inv / 直接进包 | Max blocks/crops per action. | | Direct to Inv / 直接进包 | Toggle 12-way edge adjacency. (斜边连接模式). | | Direct to Inv / 直接进包 | Toggle 8-way corner adjacency. (斜角连接模式). | | Direct to Inv / 直接进包 | Ms delay between packets on vanilla servers. (原版服务器发包间隔). | | Direct to Inv / 直接进包 | Stops if durability <= 10. | | Direct to Inv / 直接进包 | Requires Mod on Server. Automatically disabled if not present. |

---

🤝 Compatibility / 兼容性机制

This mod uses a smart networking system to determine how to break blocks: 本模组使用智能网络系统来决定如何处理连锁操作：

1. 直接进入背包: * The client performs the search (BFS) and sends standard packet requests. * 直接进入背包: Use 直接进入背包 to slow down the process if needed. * 直接进入背包 is disabled. * 直接进入背包：客户端进行 BFS 搜索计算，发送标准数据包。可以使用直接进入背包来防止被踢出。不支持直接进入背包。

2. 发包间隔: * The client sends a single packet with the list of coordinates. * The server breaks them efficiently and supports 发包间隔. * 发包间隔 is not required and will be disabled in config GUI. * 发包间隔：客户端发送包含坐标列表的单一数据包。服务端高效执行并支持发包间隔。无需设置发包间隔。

---

📝 License / 许可证

This project is licensed under the GPL-3.0 License. 本项目采用 GPL-3.0 许可证。