Description
Gallery
Changelog
Versions
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
Vto 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 / 使用说明
- Open Config: Press
Vto open the menu. Use the Mode Dropdown to switch between Mining, Planting, and Utility modes.- 打开配置：按
V键打开菜单。使用模式下拉框在采集、种植和交互模式间切换。
- 打开配置：按
- Setup Whitelists:
- Mining: Add blocks like
iron_oreoroak_log. - Planting: Add items like
carrotorwheat_seeds. - Utility: Add blocks you want to interact with, like
oak_log(for stripping) orgrass_block(for tilling). - 设置名单：
- 采集：添加如
iron_ore或oak_log等方块。 - 种植：添加如
carrot或wheat_seeds等种子物品。 - 交互：添加想要交互的方块，如
oak_log（去皮）或grass_block（耕地）。
- 采集：添加如
- Mining: Add blocks like
- 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: 本模组使用智能网络系统来决定如何处理连锁操作：
-
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 搜索计算，发送标准数据包。可以使用发包间隔来防止被踢出。不支持直接进入背包。
-
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 许可证。
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 15d ago | 1 | ||||
| 26d ago | 1 | ||||
| 1mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 2mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 8mo ago | 1 | ||||
| 8mo ago | 1 | ||||
| 9mo ago | 1 |
[4.1.2+26.3] ChainVeinFabric 4.1.2+26.3
by water2004 on Oct 14, 2026
Download
## ChainVeinFabric v4.1.2
### 补丁修复 / Patch fixes
### 补丁修复 / Patch fixes
- 修复 Minecraft 26.3 中按住 Ctrl 点击主开关无法进入 AUTO 模式的问题，并同步修正退出 AUTO 的左键判断
- 使用 Minecraft 的左键常量处理开关点击，新增实际 Ctrl+鼠标点击的客户端回归测试
- Fixed Ctrl-clicking the main toggle failing to enter AUTO mode in Minecraft 26.3 and corrected the left-click check for exiting AUTO
- Used Minecraft's left-button constant for the toggle and added client regression coverage through actual Ctrl and mouse input
[4.1.1+26.3] ChainVeinFabric 4.1.1+26.3
by water2004 on Oct 03, 2026
Download
## ChainVeinFabric v4.1.1
### 补丁修复 / Patch fixes
### 补丁修复 / Patch fixes
- 修复 Minecraft 26.3 配置界面中 Add 和 Remove 主按钮点击无响应的问题
- Fixed unresponsive Add and Remove primary buttons in the Minecraft 26.3 configuration screen
[4.1.0+26.2] ChainVeinFabric 4.1.0+26.2
by water2004 on Sep 04, 2026
Download
## ChainVeinFabric v4.1.0
> [!CAUTION]
> **自动挖掘安全提示：** 自动挖掘会在玩家周围批量搜索并破坏方块。启用前请确认当前模式、白名单、搜索算法与范围；每次左键只触发一轮搜索，并受冷却时间限制。
>
> **Automatic mining safety:** Automatic mining searches for and breaks blocks around the player. Check the active mode, whitelist, algorithm, and range before arming it. Each left click triggers one search cycle and is subject to the configured cooldown.
### 受控自动挖掘与异步搜索 / Guarded Automatic Mining and Async Search
### 纯客户端模式 / Client-side Mode
### 服务端调度与限制 / Server Scheduling and Limits
> [!CAUTION]
> **自动挖掘安全提示：** 自动挖掘会在玩家周围批量搜索并破坏方块。启用前请确认当前模式、白名单、搜索算法与范围；每次左键只触发一轮搜索，并受冷却时间限制。
>
> **Automatic mining safety:** Automatic mining searches for and breaks blocks around the player. Check the active mode, whitelist, algorithm, and range before arming it. Each left click triggers one search cycle and is subject to the configured cooldown.
### 受控自动挖掘与异步搜索 / Guarded Automatic Mining and Async Search
- 所有挖掘模式均支持自动挖掘：按住 Ctrl 点击主开关进入 **AUTO**，之后每次左键触发一轮以玩家为中心的搜索；点击 **AUTO** 即可关闭
- 自动挖掘继续使用当前模式的“白名单 × 搜索算法”规则；相邻同类算法以玩家脚下方块为起点，Litematica 模式仍遵循各自的选区、投影和渲染层限制
- 新增可配置的自动挖掘冷却，以及醒目的屏幕边缘警示与状态提示，避免误触后持续运行
- 预览、手动连锁与自动挖掘统一使用带优先级的异步搜索线程，减少大范围搜索对客户端主线程的影响
- Automatic mining is available in every mining mode: Ctrl-click the main toggle to arm **AUTO**, then left-click once for each player-centered search cycle; click **AUTO** to disarm it
- Automatic mining keeps the active mode's whitelist × search-algorithm rules. Same-type adjacency starts from the block beneath the player, while Litematica modes retain their area, placement, and render-layer restrictions
- Added a configurable automatic-mining cooldown plus a prominent screen-edge warning and status indicator to make accidental activation obvious
- Preview, manual chaining, and automatic mining now share one prioritized asynchronous search worker, reducing client-thread work during large searches
### 纯客户端模式 / Client-side Mode
- 未安装服务端模组时，挖掘会按原版破坏进度逐个完成方块，不再依赖同 tick 发送开始与结束包
- 顶部状态区会显示当前方块和整份请求的进度，并避开打印机类模组常用的准星进度位置
- 新请求会等待当前方块处理完成后替换尚未开始的旧任务；玩家再次手动挖掘会立即丢弃剩余任务
- 公开客户端 API 与界面操作会自动选择服务端协议或纯客户端路径，直接进入背包与潜影盒溢出收纳仍只在服务端安装模组时可用
- Without the server mod, blocks are now completed one at a time using vanilla breaking progress instead of relying on same-tick start/stop packets
- The top status area shows progress for both the current block and the complete request, away from crosshair progress displays commonly used by printer mods
- A newer request waits for the current block, then replaces the unstarted remainder; another manual mining action immediately discards all remaining fallback work
- Public client API calls and UI actions automatically select the dedicated protocol or client-side path. Direct to Inventory and shulker overflow still require the server mod
### 服务端调度与限制 / Server Scheduling and Limits
- 单个协议请求固定最多包含
2048个位置，并在解码阶段拒绝超限负载 /chainvein maxBlocks [1..2048]现在表示全服每 tick 合计处理上限，默认256；同一 tick 的活动玩家公平分享预算，未用份额会重新分配- 每名玩家每 tick 只接受第一份挖掘或交互请求；服务端先处理已有请求，再以新请求替换尚未开始的剩余部分，因此不会形成无限增长的队列
/chainvein pickupRadius [0..64]控制直接进入背包及快捷潜影盒收纳的拾取半径，默认10；设为0可关闭服务端掉落捕获- 服务端协议挖掘不再额外限制玩家距离，但不会加载未加载区块；交互统一使用原版服务端的方块交互距离判定
- 玩家下线、重生、切换维度或服务器时会清除过期任务
- Each protocol request is hard-limited to
2048positions at decode time /chainvein maxBlocks [1..2048]now controls the server-wide processed-position budget per tick and defaults to256; active players share it fairly and unused shares are redistributed- Only the first mining or interaction request fr
[4.1.0-alpha.3-26.1] ChainVeinFabric 4.1.0-alpha.3-26.1
by water2004 on Aug 31, 2026
Download
### 服务端调度 / Server Scheduling
- 服务端协议单个请求固定最多携带
2048个坐标；该限制在解码阶段执行 /chainvein maxBlocks现在表示全服单 tick 合计处理上限，默认仍为256，现有配置值会直接作为 tick 预算使用- 同一 tick 内，各玩家的活动请求公平分享全局预算；短请求未使用的份额会重新分配，除不尽的余数会轮换
- 每名玩家每 tick 只接受第一份挖掘或交互请求；先处理手上的旧请求，再用新请求替换旧请求尚未开始的部分
- 服务端不会形成可无限增长的请求队列；玩家下线、重生或切换维度后，旧请求会被丢弃
- A dedicated-server request is hard-limited to
2048positions at decode time /chainvein maxBlocksnow controls the server-wide total processed per tick. Its default remains256, and existing configured values become tick budgets directly- Active players share the global budget fairly each tick; unused capacity from short requests is redistributed and indivisible remainders rotate between players
- Only the first mining or interaction request from each player is accepted in a tick. The current request is processed first, then its unstarted remainder is replaced by the new request
- No unbounded request queue is created; stale work is discarded when a player disconnects, respawns, or changes dimensions
### 性能与正确性 / Performance and Correctness
- 连续同类掉落会批量写入快捷潜影盒，并按玩家背包中的盒子顺序按需解析和填充
- 只有最终无法进入背包或潜影盒的掉落物才会创建实体；满盒时仍在原位置正常掉落
- 优化了 Quick Shulker 新 API、强制旧适配器和稳定版兼容路径（26.2 为 3.0.2，26.1 为 3.0.1），保持部分接收及
64/16/1堆叠上限 - 手动连锁挖掘会将点击原点与异步搜索余量分到不同 tick 发送，并阻止原版完成包抢先破坏原点；开启直接进入背包时，第一个方块与后续方块现在走同一服务端掉落路径
- 修复配置界面切换到 Advanced 时可能因下拉框构造顺序导致的崩溃
- 配置页、白名单、快捷键和四个配置分页均增加客户端回归测试
- Consecutive equal drops are inserted into Quick Shulker in batches, resolving and filling carried boxes lazily in inventory order
- Item entities are now created only for final overflow that fits in neither inventory nor shulker storage; full-box overflow still drops at its original position
- Optimized the Quick Shulker direct API, forced legacy adapter, and stable compatibility paths (3.0.2 on 26.2 and 3.0.1 on 26.1) while preserving partial insertion and
64/16/1stack limits - Manual chain mining now sends the clicked origin and asynchronous remainder in separate ticks and prevents the vanilla completion packet from breaking the origin first; with Direct to Inventory enabled, the first and subsequent blocks use the same server drop path
- Fixed a configuration-screen crash when opening Advanced caused by dropdown initialization order
- Added client regression coverage for configuration pages, whitelists, hotkeys, and all four configuration tabs
[4.1.0-alpha.2-26.2] ChainVeinFabric 4.1.0-alpha.2-26.2
by water2004 on Aug 30, 2026
Download
- 自动挖掘不再是独立模式：在任意挖掘模式中按住 Ctrl 点击主开关即可待命，每次左键只触发一轮以玩家为中心的搜索与挖掘；点击 **AUTO** 可直接解除
- 新增自动挖掘冷却与高可见度危险提示 HUD；同类相邻算法以玩家脚下方块为目标，其余白名单与形状算法继续复用统一异步搜索路径
- 新增持久化的权限等级 4 命令：
/chainvein maxBlocks [1..2048]（默认256）与/chainvein pickupRadius [0..64]（默认10） - 服务端挖掘请求不再使用硬编码玩家距离，也不会为请求加载区块；连锁交互交由原版服务端交互距离判断
- 快捷潜影盒优先使用新的标准 Fabric Storage API：先解析随身存储槽位，再对整批溢出物全局合并已有堆叠并使用空槽；装不下的剩余物仍正常掉落。旧公开 API 继续作为能力探测后的回退路径
- Minecraft 26.2 的可选 Litematica 最低兼容版本放宽至
0.28.3 - 纯客户端回退不再于同一 tick 发送开始与结束挖掘包；现在逐方块遵循原版挖掘进度、工具速度与方块间延迟
- 纯客户端挖掘会在状态 HUD 显示当前方块进度与请求进度，服务端批量挖掘路径不受影响
- 多次提交纯客户端挖掘请求时，会先完成当前已经开始的方块，再丢弃旧请求尚未开始的部分并切换到最新请求
- 稳定了纯客户端掉落测试场地，避免掉落实体滚出测试范围造成偶发误报
- Automatic mining is no longer a separate mode. Ctrl-click the main toggle in any mining mode to arm it; each left click triggers exactly one player-centered search-and-mine batch, and clicking **AUTO** disarms it directly
- Added an automatic-mining cooldown and a high-visibility hazard HUD. Same-type adjacency targets the block beneath the player, while the other whitelist and shape algorithms continue to use the shared asynchronous search path
- Added persistent permission-level-4 commands:
/chainvein maxBlocks [1..2048](default256) and/chainvein pickupRadius [0..64](default10) - Server mining requests no longer use a hard-coded player-distance limit and never load chunks for a request; chain interactions defer to the vanilla server interaction-range check
- Quick Shulker now prefers its standard Fabric Storage API: carried storage slots are resolved once, then the complete overflow set is merged globally into existing stacks before empty slots are used. Remainders that do not fit still drop normally, and the legacy public API remains a capability-selected fallback
- The minimum optional Litematica version for Minecraft 26.2 is now
0.28.3 - Client-only fallback no longer sends start and stop mining packets in the same tick. Blocks are now mined one at a time using vanilla progress, tool speed, and the vanilla delay between blocks
- Client-only mining now shows both current-block progress and request progress in the status HUD; the dedicated-server batch path is unchanged
- When multiple client-only mining requests arrive, the currently started block finishes first, then the unstarted remainder of the old request is discarded in favor of the latest request
- Stabilized the client-only drop fixture so item entities cannot roll outside the assertion area and cause intermittent false failures
[4.0.2+26.1] ChainVeinFabric 4.0.2+26.1
by water2004 on Aug 25, 2026
Download
## ChainVeinFabric v4.0.2
### 修复 / Fixes
### 修复 / Fixes
- 修复连锁种植将首次右键已消耗的物品重复计入限制，导致一组 64 个种子只能种下 63 个的问题；现在会正确种下全部 64 个
- Fixed chain planting counting the item already consumed by the initial vanilla interaction twice, which left one seed behind from a stack of 64; all 64 seeds are now planted
[4.0.1+26.1] ChainVeinFabric 4.0.1+26.1
by water2004 on Aug 08, 2026
Download
## ChainVeinFabric v4.0.1
### 修复 / Fixes
### 兼容性 / Compatibility
### 修复 / 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
ChainVeinClientApimethod 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] ChainVeinFabric 4.0.0+26.2
by water2004 on Aug 07, 2026
Download
## 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
### 相对 3.1.0 的变更 / Changes since 3.1.0
### 升级须知 / Upgrade notes
> [!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_v4andchainveinfabric:interact_v4; older versions safely fall back to client-side mode - Kept all public
ChainVeinClientApimethod 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] ChainVeinFabric 3.1.0-26.2
by water2004 on Aug 07, 2026
Download
## ChainVeinFabric v3.1.0
> [!IMPORTANT]
> **兼容性说明：3.x 及以后版本不再支持 Minecraft 1.21.x。**
>
> **Compatibility: Minecraft 1.21.x is no longer supported starting with the 3.x series.**
### 支持版本 / Supported versions
### 主要更新 / Highlights
> [!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] ChainVeinFabric 3.0.0-26.2
by water2004 on Aug 07, 2026
Download
## ChainVeinFabric v3.0.0
> [!IMPORTANT]
> **兼容性说明：3.x 及以后版本不再支持 Minecraft 1.21.x。**
>
> **Compatibility: Minecraft 1.21.x is no longer supported starting with the 3.x series.**
### 支持版本 / Supported versions
### 主要更新 / Highlights
> [!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] ChainVeinFabric 2.2.1-26.2
by water2004 on Jul 13, 2026
Download
ChainVeinFabric v2.2.1
### 变更 / Changes
### 变更 / 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] ChainVeinFabric 2.2.0-1.21
by water2004 on Jun 27, 2026
Download
## ChainVeinFabric v2.2.0
### 变更 / Changes
### 变更 / 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] ChainVeinFabric 2.1.3-26.1
by water2004 on Jun 05, 2026
Download
## ChainVeinFabric v2.1.3-26.1
### 变更 / Changes
### 变更 / 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] ChainVeinFabric 2.1.2-26.1
by water2004 on May 16, 2026
Download
### 变更 / 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
[2.1.0-26.1] ChainVeinFabric 2.1.0-26.1
by water2004 on May 15, 2026
Download
### 新增功能 / New Features
- 方块描边预览 / Block Outline Preview**
- 在基础设置中新增开关，开启后准星指向方块时会实时预览连锁操作将影响的范围
- 仅绘制外轮廓，相邻方块间的内部棱线自动隐藏（面剔除 + 棱合并）
- 不同模式使用不同颜色区分：采集=青色，种植=绿色，工具=黄色
- 支持所有搜索算法（相邻同种、相邻白名单、球形、平面正方形、长方体）
- 20 tick 自动刷新以响应世界变化，搜索结果缓存避免每帧重复计算
- 方块描边预览 / Block Outline Preview**
- Added a toggle in the Basic settings tab. When enabled, hovering your crosshair over a block shows a real-time wireframe preview of all blocks that would be affected by the chain operation.
- Only outer edges are drawn — internal edges between adjacent blocks and coplanar grid lines are automatically hidden (face culling + edge merging).
- Color-coded by mode: Cyan for mining, Green for planting, Yellow for utility.
- Supports all search algorithms (Adjacent Same, Adjacent Whitelist, Sphere, Square Plane, Cuboid).
- Cached search result with 20-tick periodic refresh to handle world changes; no per-frame recomputation.
