ChainVeinFabric

ChainVeinFabric / 连锁采集 Fabric

Современный, эффективный и настраиваемый мод на цепную добычу и взаимодействие для Minecraft Fabric 1.21+. Совместим с ванильными серверами (режим клиента) и расширяется при установке на сервер.

一个适用于 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. 描述：连锁打蜡/除锈/去皮模式配置界面，展示“适用方块”白名单。

Описание: Мгновенно снимает кору со всего стака брёвен топором. 描述：使用斧头瞬间连锁去皮整堆原木。

🛠️ Использование / 使用说明

1. Открыть конфиг: Нажми V, чтобы открыть меню. Используй выпадающий список режимов, чтобы переключаться между режимами добычи, посадки и взаимодействия.

   • 打开配置：按 V 键打开菜单。使用模式下拉框在采集、种植和交互模式间切换。

2. Настроить списки:

   • Добыча: Добавь блоки вроде iron_ore или oak_log.
   • Посадка: Добавь предметы вроде carrot или wheat_seeds.
   • Взаимодействие: Добавь блоки, с которыми хочешь взаимодействовать, например oak_log (для снятия коры) или grass_block (для вспашки).

   • 设置名单：

     • 采集：添加如 iron_ore 或 oak_log 等方块。
     • 种植：添加如 carrot 或 wheat_seeds 等种子物品。
     • 交互：添加想要交互的方块，如 oak_log（去皮）或 grass_block（耕地）。

3. Выполнить:

   • Добыча: Сломай блок из списка.
   • Посадка: Нажми ПКМ семенами по грядке.
   • Взаимодействие: Нажми ПКМ инструментом (топор/мотыга) или предметом (пчелиные соты).

   • 执行：

     • 采集：挖掘白名单方块。
     • 种植：手持种子右键耕地。
     • 交互：手持工具（斧、锄）或物品（蜜脾）右键目标方块。

⚙️ Параметры конфигурации / 配置选项

🤝 Совместимость / 兼容性机制

Этот мод использует умную сетевую систему для определения способа ломания блоков: 本模组使用智能网络系统来决定如何处理连锁操作：

1. Ванильный сервер (мод не установлен):

   • Клиент выполняет поиск (BFS) и отправляет стандартные пакеты-запросы.
   • Анти-кик: Используй интервал пакетов, чтобы замедлить процесс при необходимости.
   • Прямо в инвентарь отключено.
   • 原版服务器（未安装模组）：客户端进行 BFS 搜索计算，发送标准数据包。可以使用发包间隔来防止被踢出。不支持直接进入背包。

2. Сервер с модом (мод установлен):

   • Клиент отправляет один пакет со списком координат.
   • Сервер эффективно их ломает и поддерживает прямо в инвентарь.
   • Интервал пакетов не требуется и будет отключён в GUI конфига.
   • 模组服务器（已安装模组）：客户端发送包含坐标列表的单一数据包。服务端高效执行并支持直接进入背包。无需设置发包间隔。

📝 Лицензия / 许可证

Этот проект распространяется под лицензией GPL-3.0. 本项目采用 GPL-3.0 许可证。