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 <= 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. Vanilla Server (No Mod Installed):

   • The client performs the search (BFS) and sends standard packet requests.
   • Anti-Kick: Use Packet Interval to slow down the process if needed.
   • Direct to Inventory is disabled.
   • 原版服务器（未安装模组）：客户端进行 BFS 搜索计算，发送标准数据包。可以使用发包间隔来防止被踢出。不支持直接进入背包。

2. Modded Server (Mod Installed):

   • The client sends a single packet with the list of coordinates.
   • The server breaks them efficiently and supports Direct to Inventory.
   • Packet Interval is not required and will be disabled in config GUI.
   • 模组服务器（已安装模组）：客户端发送包含坐标列表的单一数据包。服务端高效执行并支持直接进入背包。无需设置发包间隔。

---

📝 License / 许可证

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