Перейти к содержимому
Mineforgian

ChainVeinFabric

Automatically mines all connected blocks of the same type when one block is broken.

Загрузки
7K
Подписчики
9
Обновлён
8 августа 2026 г.
Лицензия
GPL-3.0-or-later

Опубликован 5 февраля 2026 г.

Исходный кодСообщить об ошибке

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 / 截图

Replace this with a description

Description: Mining mode configuration with block whitelist. 描述：连锁采集模式下的方块白名单管理界面。

image-1

Description: Action Bar feedback after chain mining blocks. 描述：连锁采集后的动作栏反馈信息。

image-2

Description: Chain Planting configuration showing the item whitelist (seeds/crops). 描述：连锁种植模式配置界面，展示种子/作物白名单。

image-3

Description: Chain Planting configuration showing the item whitelist (seeds/crops). 描述：连锁种植模式配置界面，展示种子/作物白名单。

image-4

Description: Chain planting carrots in a large area with a single click. 描述：一键在大范围内连锁种植胡萝卜。

image-5

Description: Chain Wax/Scrape/Strip configuration showing the "Applicable Blocks" whitelist. 描述：连锁打蜡/除锈/去皮模式配置界面，展示“适用方块”白名单。

image-6

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 许可证。

Ченджлог

4.0.1+26.1Релиз26.1, 26.1.1, 26.1.2 · 8 августа 2026 г.

ChainVeinFabric v4.0.1

修复 / Fixes

  • 移除跨操作保留五秒的挖掘坐标去重状态；连续快速执行多个重叠范围时，后续范围不再只破坏一部分，也会正常显示破坏数量
  • 服务端协议可用时恢复即时发送挖掘批次，确保开启“直接进入背包”后，玩家最先破坏的方块也进入背包而不是掉落在地
  • 配置界面只显示实际存在的说明翻译，不再显示 MaLiLib 自动生成的 Comment? 占位文本
  • 纯客户端回退模式继续遵循“发包间隔”，重复坐标会由服务端按空气方块安全忽略
  • Removed the five-second cross-operation mining-coordinate lock; rapidly chaining overlapping areas no longer leaves later areas partially mined, and the affected-block message is shown normally
  • Restored immediate mining-batch dispatch when the dedicated server protocol is available, so the initially broken block also honors Direct to Inventory instead of dropping on the ground
  • Config screens now show only real translated descriptions instead of MaLiLib's generated Comment? placeholders
  • Client-side fallback mode continues to honor Packet Interval, while duplicate coordinates are safely ignored as air by the server

兼容性 / Compatibility

  • 4.0.1 没有修改 4.x 网络协议、配置 schema 或公开 ChainVeinClientApi 方法签名，可与 4.0.0 服务端/客户端混用
  • Minecraft 26.2 与 26.1.x 均继续维护；Minecraft 1.21.x 继续使用 ChainVeinFabric 2.2.1
  • 4.x 与 1.x～3.x 的专用协议仍不兼容，混用时会安全退回纯客户端模式；直接进入背包和快捷潜影盒溢出收纳需要双方均为 4.x
  • 4.0.1 does not change the 4.x network protocol, config schema, or public ChainVeinClientApi method signatures and can interoperate with 4.0.0 clients/servers
  • Minecraft 26.2 and 26.1.x remain maintained; Minecraft 1.21.x remains on ChainVeinFabric 2.2.1
  • The 4.x dedicated protocol remains incompatible with 1.x–3.x; mixed versions safely fall back to client-side mode, while Direct to Inventory and Quick Shulker overflow require 4.x on both sides
4.0.0+26.2Релиз26.2 · 7 августа 2026 г.

ChainVeinFabric v4.0.0

[!IMPORTANT] 网络兼容性： 4.x 服务端专用协议与 1.x～3.x 明确不兼容。版本不匹配时不会发送或解码 ChainVein 专用数据包，客户端会自动退回纯客户端模式；直接进入背包和快捷潜影盒溢出收纳将不可用。

Network compatibility: The 4.x dedicated-server protocol is intentionally incompatible with 1.x–3.x. Mismatched versions do not send or decode ChainVein payloads and automatically fall back to client-side mode, where Direct to Inventory and Quick Shulker overflow are unavailable.

支持版本 / Supported versions

  • Minecraft 26.2：需要 MaLiLib 0.29.2 或更高版本；可选安装 Litematica 0.28.4 或更高版本、Quick Shulker 3.0.2-26.2 或更高版本
  • Minecraft 26.1.x：需要 MaLiLib 0.28.8 或更高版本；可选安装 Litematica 0.27.10 或更高版本、Quick Shulker 3.0.1-26.1 或更高版本
  • Minecraft 1.21.x 继续使用 ChainVeinFabric 2.2.1
  • Minecraft 26.2: requires MaLiLib 0.29.2 or newer; Litematica 0.28.4 or newer and Quick Shulker 3.0.2-26.2 or newer are optional
  • Minecraft 26.1.x: requires MaLiLib 0.28.8 or newer; Litematica 0.27.10 or newer and Quick Shulker 3.0.1-26.1 or newer are optional
  • Minecraft 1.21.x remains on ChainVeinFabric 2.2.1

相对 3.1.0 的变更 / Changes since 3.1.0

  • 新增可选的“背包满后存入潜影盒”：直接进入背包后仍无法容纳的掉落物会继续尝试放入随身潜影盒
  • 仅使用 Quick Shulker 的公开 API；未安装时不显示选项，也不会加载兼容实现
  • 玩家背包和潜影盒都无法容纳的剩余物仍会正常掉落，不会吞物品
  • 配置 schema 升级到 v4，并处理 v3 到 v4 的迁移；现有配置和配置预设默认关闭新功能
  • 服务端专用协议升级为 chainveinfabric:mine_v4 与 chainveinfabric:interact_v4；旧版本会安全退回纯客户端模式
  • ChainVeinClientApi 的公开方法签名保持不变
  • Added optional Overflow to Shulker Boxes storage after Direct to Inventory fills the player inventory
  • Uses only Quick Shulker's public API; the option and linked implementation stay unavailable when the mod is absent
  • Items that fit in neither the player inventory nor carried shulker boxes still drop normally
  • Upgraded the config schema to v4 with v3-to-v4 migration; existing configs and presets default the new feature to off
  • Versioned the dedicated-server protocol as chainveinfabric:mine_v4 and chainveinfabric:interact_v4; older versions safely fall back to client-side mode
  • Kept all public ChainVeinClientApi method signatures unchanged

升级须知 / Upgrade notes

  • 如需使用服务端专用发包、直接进入背包或快捷潜影盒溢出收纳，客户端与服务端必须同时升级到 4.x
  • 4.x 与 1.x～3.x 混用时不会断开连接，但只能使用纯客户端模式；纯客户端模式继续遵循发包间隔
  • v3 配置会在首次加载时自动迁移到 v4，新选项默认关闭；无需手动重建配置或预设
  • 快捷潜影盒仍是可选依赖；未安装时不会显示新选项，其他连锁功能不受影响
  • Both client and server must run 4.x to use the dedicated protocol, Direct to Inventory, or Quick Shulker overflow
  • Mixing 4.x with 1.x–3.x does not disconnect the player, but only client-side mode is available and continues to honor Packet Interval
  • v3 configurations migrate to v4 automatically on first load; the new option defaults to off, so configs and presets do not need to be recreated
  • Quick Shulker remains optional; without it the new option stays hidden and all other chaining features continue to work
3.1.0-26.2Релиз26.2 · 7 августа 2026 г.

ChainVeinFabric v3.1.0

[!IMPORTANT] 兼容性说明：3.x 及以后版本不再支持 Minecraft 1.21.x。 2.2.1 是 Minecraft 1.21.x 系列的最终版本。3.1.0 仅提供 Minecraft 26.2 与 26.1.x 构建。

Compatibility: Minecraft 1.21.x is no longer supported starting with the 3.x series. 2.2.1 is the final release for Minecraft 1.21.x. Version 3.1.0 is released only for Minecraft 26.2 and 26.1.x.

支持版本 / Supported versions

  • Minecraft 26.2：需要 MaLiLib 0.29.2 或更高版本；可选安装 Litematica 0.28.4 或更高版本

  • Minecraft 26.1.x：需要 MaLiLib 0.28.8 或更高版本；可选安装 Litematica 0.27.10 或更高版本

  • 未安装 Litematica 时，三个投影模式及其直达快捷键不会显示，其他功能不受影响

  • Minecraft 26.2: requires MaLiLib 0.29.2 or newer; Litematica 0.28.4 or newer is optional

  • Minecraft 26.1.x: requires MaLiLib 0.28.8 or newer; Litematica 0.27.10 or newer is optional

  • Without Litematica installed, the three schematic modes and their direct hotkeys remain hidden; all other features continue to work

主要更新 / Highlights

  • 新增“切换到下一个模式”快捷键；循环切换只经过当前可用的模式

  • 为六种模式分别新增直达快捷键，可一键切换至采集、种植、交互或任一投影模式

  • 快捷键页面新增“模式快捷键切换后开启连锁”开关，可在切换模式的同时立即启用连锁

  • 未安装 Litematica 时，不注册、不显示三个投影模式的直达快捷键，循环切换也会自动跳过这些模式

  • 种植模式下，目标白名单快捷键现在读取主手物品；只有可种植物品才能加入或移出白名单

  • GUI、白名单快捷键和实际连锁种植共用同一套可种植物品判定，避免配置与执行行为不一致

  • 配置界面改为响应式布局：高 GUI Scale 或较窄窗口下会自动压缩或折叠页眉与操作控件、为滚动条保留空间、调整列表宽度，并在空间不足时切换为单列表页签；预设页和长方块名称也会自适应可用宽度

  • 更新项目文档：默认 README 改为英文，并提供完整的简体中文版本

  • Added a Next Mode hotkey that cycles through currently available modes only

  • Added a direct hotkey for each of the six modes, allowing one-key switching to Mining, Planting, Utility, or any schematic mode

  • Added an Enable Chaining after Mode Hotkey option that can turn chaining on immediately when a mode hotkey is used

  • When Litematica is absent, the three schematic direct hotkeys are neither registered nor shown, and mode cycling skips those modes

  • In Planting mode, the target-whitelist hotkey now reads the main-hand item and accepts only plantable items

  • The GUI, whitelist hotkey, and actual chain-planting execution now share one plantable-item check so configuration and behavior remain consistent

  • Made the configuration GUI responsive: high GUI scales and narrow windows now compact or collapse header/action controls, reserve scrollbar space, resize lists, switch to a single-list tab layout when needed, and keep preset rows and long block names within the available width

  • Updated the project documentation with English as the default README and a complete Simplified Chinese version

3.0.0-26.2Релиз26.2 · 7 августа 2026 г.

ChainVeinFabric v3.0.0

[!IMPORTANT] 兼容性说明：3.x 及以后版本不再支持 Minecraft 1.21.x。 2.2.1 是 Minecraft 1.21.x 系列的最终版本。3.0.0 仅提供 Minecraft 26.2 与 26.1.x 构建。

Compatibility: Minecraft 1.21.x is no longer supported starting with the 3.x series. 2.2.1 is the final release for Minecraft 1.21.x. Version 3.0.0 is released only for Minecraft 26.2 and 26.1.x.

支持版本 / Supported versions

  • Minecraft 26.2：需要 MaLiLib 0.29.2 或更高版本；可选安装 Litematica 0.28.4 或更高版本

  • Minecraft 26.1.x：需要 MaLiLib 0.28.8 或更高版本；可选安装 Litematica 0.27.10 或更高版本

  • 未安装 Litematica 时，新增的三个投影模式不会显示，其他功能不受影响

  • Minecraft 26.2: requires MaLiLib 0.29.2 or newer; Litematica 0.28.4 or newer is optional

  • Minecraft 26.1.x: requires MaLiLib 0.28.8 or newer; Litematica 0.27.10 or newer is optional

  • Without Litematica installed, the three new schematic modes remain hidden and all other features continue to work

主要更新 / Highlights

  • 新增“投影：选区方块”“投影：多余方块”“投影：错误方块”三种模式

  • “投影：选区方块”使用 Litematica 木棍工具当前框选的区域，并匹配区域内实际存在的方块

  • “投影：多余方块”和“投影：错误方块”使用已启用的原理图放置区域，分别匹配投影中应为空气的多余方块，以及实际方块与投影方块不一致的位置

  • 三种投影模式拥有相互独立的白名单；既可手动编辑，也可一键扫描当前模式范围并覆盖当前白名单预设

  • 白名单导入采用分帧扫描，不等待未加载区块；未加载区块会被直接跳过并计入结果

  • 多余/错误方块模式新增“渲染层”开关，可选择是否遵循 Litematica 当前渲染层级限制

  • 配置 schema 升级至 v3，并提供从 v2 到 v3 的一次性迁移

  • 白名单统一保存和匹配物品 ID；方块变体会归一为对应物品，旧的 v2 配置会在迁移时自动转换

  • 精简投影白名单控件布局；新增共享客户端作业 API，统一处理挖掘、种植和交互任务的去重、排队、服务端批量发送及原版客户端回退

  • Added three modes: Schematic Selection Blocks, Schematic Extra Blocks, and Schematic Wrong Blocks

  • Schematic Selection Blocks uses the current area selected with Litematica's stick tool and matches actual blocks inside that area

  • Extra and Wrong modes use enabled schematic placements, matching unexpected blocks where the schematic expects air and placed blocks that differ from the schematic respectively

  • Each schematic mode has an independent whitelist that can be edited manually or overwritten by scanning the current mode scope

  • Whitelist imports are processed incrementally and never wait for unloaded chunks; unloaded chunks are skipped and reported

  • Extra and Wrong modes include a Layer toggle for optionally respecting Litematica's current render-layer restriction

  • Upgraded the configuration schema to v3 with a one-time v2-to-v3 migration

  • Whitelists now consistently store and match item IDs, normalizing block variants to their corresponding items during migration

  • Compacted the schematic whitelist controls and added a shared client job API for deduplicating, queuing, batching, and providing vanilla-client fallbacks for mining, planting, and interaction jobs

2.2.1-26.2Релиз26.2 · 13 июля 2026 г.

ChainVeinFabric v2.2.1

变更 / Changes

  • 修复在 BASIC/PRESETS 配置页修改配置后按 Esc 关闭导致客户端崩溃的问题

  • 白名单统一使用物品 ID 保存和匹配，不再区分方块状态；旧配置会在启动时自动迁移，墙上火把等方块变体将归一为对应物品

  • 修复部分方块变体无法从白名单移除，以及不同方块状态无法正确视为同类物品的问题

  • Fixed a client crash when pressing Esc to close the BASIC/PRESETS config tabs after changing settings

  • Whitelists now consistently store and match item IDs instead of block states; older configurations are migrated automatically on startup

  • Fixed block variants that could not be removed from the whitelist and ensured variants of the same item are treated consistently

2.2.0-1.21Релиз1.21 · 27 июня 2026 г.

ChainVeinFabric v2.2.0

变更 / Changes

  • 添加 MaLiLib 快捷键注册和独立快捷键配置页

  • 添加快捷开启/关闭连锁状态的快捷键

  • 添加将当前指向方块加入/移出当前白名单的快捷键

  • 添加白名单预设和配置预设管理功能

  • 修复重新打开配置界面后快捷键配置不保存的问题

  • 修复连锁采集方块数量被手持物品堆叠数量限制的问题

  • 将 Fabric Minecraft 依赖范围限制为当前 Minecraft 中版本（~<minecraft_version>）

  • Added MaLiLib hotkey registration and a dedicated hotkeys config tab

  • Added a hotkey for quickly toggling chain state

  • Added a hotkey for adding/removing the targeted block from the current whitelist

  • Added whitelist and config preset management

  • Fixed hotkey config persistence after reopening the config screen

  • Fixed chain mining block limits being capped by the held item stack size

  • Restricted the Fabric Minecraft dependency range to the current Minecraft line with ~<minecraft_version>

2.1.3-26.1Релиз26.1, 26.1.1, 26.1.2 · 5 июня 2026 г.

ChainVeinFabric v2.1.3-26.1

变更 / Changes

  • 修复连锁采集模式下无法将作物方块加入白名单的问题

  • 修复骨粉等客户端返回 PASS 的物品无法触发连锁的问题

  • 修复自定义包处理器在创造模式下消耗物品的问题

  • Fixed crop blocks not being addable to whitelist in Chain Mine mode

  • Fixed items like bone meal (which return PASS on client) not triggering chain actions

  • Fixed items being consumed in Creative mode when using the custom packet handler

2.1.2-26.1Релиз26.1, 26.1.1, 26.1.2 · 16 мая 2026 г.

变更 / Changes

  • GUI 左右两侧增加留白，修复因 MC 渲染问题导致的边缘显示不全

  • 高级设置中配置控件宽度缩减，不再撑满屏幕

  • 模式下拉菜单加宽，容纳完整中文标签

  • 描边按钮使用翻译文本替代硬编码 "OL" 前缀

  • 清理死代码

  • Added padding on both sides of the GUI to fix edge clipping caused by MC rendering bug

  • Reduced config control width in Advanced settings tab

  • Widened mode dropdown to fit full translated labels

  • Outline toggle button now uses translated text instead of hardcoded "OL" prefix

  • Cleaned up dead code

Комментарии

Загружаем…