ВЕРСИИ (73)

## ChainVeinFabric v4.1.2 ### 补丁修复 / 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

## ChainVeinFabric v4.1.1 ### 补丁修复 / Patch fixes - 修复 Minecraft 26.3 配置界面中 Add 和 Remove 主按钮点击无响应的问题 - Fixed unresponsive Add and Remove primary buttons in the Minecraft 26.3 configuration screen

## 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 - 所有挖掘模式均支持自动挖掘：按住 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 `2048` positions at decode time - `/chainvein maxBlocks [1..2048]` now controls the server-wide processed-position budget per tick and defaults to `256`; active players share it fairly and unused shares are redistributed - Only the first mining or interaction request from each player is accepted per tick. Existing work is processed first, then its unstarted remainder is replaced by the new request, so no unbounded queue can form - `/chainvein pickupRadius [0..64]` controls the capture radius for Direct to Inventory and optional Quick Shulker storage, defaults to `10`, and can be set to `0` to disable server-side drop capture - Dedicated-protocol mining no longer imposes an additional player-distance limit but never loads unavailable chunks; interactions use the vanilla server block-interaction-range check - Stale work is cleared when a player disconnects, respawns, changes dimension, or changes server ### 掉落与 Quick Shulker / Drops and Quick Shulker - 手动连锁挖掘的首个方块与后续方块现在使用同一条服务端破坏和掉落路径；开启直接进入背包后，首个方块也会正确进入背包 - 修复无精准采集冰块、含物品容器等方块在连锁破坏时与原版语义不一致的问题 - Quick Shulker 保持可选：背包装满后，剩余掉落会按玩家背包中的盒子顺序写入潜影盒，并支持公开新 API 与兼容能力探测路径 - 连续同类掉落会批量写入，潜影盒按需解析；只有背包和潜影盒都无法接收的最终剩余物才会在原位置创建掉落实体 - 保持部分接收以及 `64/16/1` 堆叠上限；满盒、超量掉落、箱子内容物和物品展示框均保留原版可见结果，不会吞物品 - The initially clicked block and all subsequent blocks now use the same server-side breaking and drop path; with Direct to Inventory enabled, the first block is captured correctly as well - Fixed chained breaking of blocks such as non-Silk-Touch ice and containers with contents so their behavior matches vanilla semantics - Quick Shulker remains optional: after the normal inventory fills, overflow is inserted into carried shulker boxes in inventory order through the public API and capability-detected compatibility path - Consecutive equal drops are inserted in batches and boxes are resolved lazily; item entities are created only for final overflow that fits in neither inventory nor shulker storage - Partial insertion and `64/16/1` stack limits are preserved. Full boxes, excess contents, container drops, and item-frame drops remain visible in the world instead of being lost ### 界面、配置与稳定性 / UI, Configuration, and Stability - 配置界面改为响应式布局，在不同 GUI 比例和分辨率下为标签、按钮及滚动条正确预留空间 - 修复切换到 Advanced 页面时下拉框构造顺序可能触发的崩溃，并隐藏不存在的翻译注释占位符 - 拆分客户端任务调度、配置持久化、预设管理、白名单归一化与界面组件，保持各层职责清晰 - 放宽兼容的 Litematica 版本范围；Litematica 与 Quick Shulker 未安装时，对应设置与模式仍保持隐藏 - 扩充服务端与真实客户端 GameTest，覆盖自动挖掘、纯客户端回退、服务端公平调度、配置迁移、四个配置页、白名单、快捷键、种植、容器及潜影盒边界行为 - The configuration screen now uses a responsive layout that reserves space correctly for labels, controls, and scrollbars across GUI scales and resolutions - Fixed a dropdown initialization crash when opening Advanced and hid missing translation-comment placeholders - Split client job dispatch, configuration persistence, preset management, whitelist normalization, and screen components into focused layers - Broadened the supported Litematica version range; Litematica- and Quick Shulker-specific modes and settings remain hidden when those optional mods are absent - Expanded server and real-client GameTests for automatic mining, client fallback, fair server scheduling, schema migration, all four configuration tabs, whitelists, hotkeys, planting, containers, and shulker-storage boundaries ### 兼容性 / Compatibility - 同时提供 Minecraft 26.2 与 26.1.x 构建；Minecraft 1.21.x 继续使用 ChainVeinFabric 2.2.1 - 相比 4.0.x，4.1.0 未更改 4.x 网络负载格式、客户端配置 schema 或公开 `ChainVeinClientApi` 方法签名，可在同一 Minecraft 版本内与 4.0.x 混用 - 4.x 专用协议仍与 1.x～3.x 分离；版本不匹配时会安全退回纯客户端模式，而不会尝试解码不兼容的数据包 - Quick Shulker 仍为可选依赖；未安装时不影响其他连锁功能 - Builds are provided for both Minecraft 26.2 and 26.1.x; Minecraft 1.21.x remains on ChainVeinFabric 2.2.1 - Compared with 4.0.x, 4.1.0 keeps the 4.x network payload format, client configuration schema, and public `ChainVeinClientApi` method signatures unchanged, allowing 4.0.x interoperability within the same Minecraft version - The 4.x dedicated protocol remains separate from 1.x–3.x; mismatched versions safely use client-side mode instead of decoding incompatible payloads - Quick Shulker remains optional and its absence does not affect other chaining features

### 服务端调度 / Server Scheduling - 服务端协议单个请求固定最多携带 `2048` 个坐标；该限制在解码阶段执行 - `/chainvein maxBlocks` 现在表示全服单 tick 合计处理上限，默认仍为 `256`，现有配置值会直接作为 tick 预算使用 - 同一 tick 内，各玩家的活动请求公平分享全局预算；短请求未使用的份额会重新分配，除不尽的余数会轮换 - 每名玩家每 tick 只接受第一份挖掘或交互请求；先处理手上的旧请求，再用新请求替换旧请求尚未开始的部分 - 服务端不会形成可无限增长的请求队列；玩家下线、重生或切换维度后，旧请求会被丢弃 - A dedicated-server request is hard-limited to `2048` positions at decode time - `/chainvein maxBlocks` now controls the server-wide total processed per tick. Its default remains `256`, 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/1` stack 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

- 自动挖掘不再是独立模式：在任意挖掘模式中按住 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]` (default `256`) and `/chainvein pickupRadius [0..64]` (default `10`) - 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

## ChainVeinFabric v4.0.2 ### 修复 / 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

## 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

## 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

## 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

## 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

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

## 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>`

## 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

### 变更 / 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

### 新增功能 / 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.

fix: advance config cannot be saved

Band new modern ui using malilib!

Band new modern ui using malilib!

# 1.4.2 update to 26.1

# 1.4.1 - 从yarn mapping 迁移到official mapping - 修复了采集同种模式下不检查白名单的问题

### 🎉 1.4 版本 Release Note #### ✨ 新增特性 (New Features) * **全新连锁搜索算法升级 (Search System Overhaul)** * 在原有的“相邻蔓延 (Shape)”基础上，**新增了“立方体 (Cube)”和“球体 (Sphere)”两种空间搜索算法**，并对应支持了自定义搜索半径 (Radius)。 * 新增了**蔓延方向限制**：现在可以通过设置控制检索方向，支持限制在“纯水平 (Horizontal)”、“纯垂直 (Vertical)”、“仅向上 (Upward)”或“仅向下 (Downward)”方向上进行连锁检索，能更好地控制大型挖掘范围。 * **全新设置界面交互升级 (Settings GUI Update)** * 配置菜单全面引入了**列表滚动条机制 (Scrollbar)**，现在拥有更整洁的分类（Basic / Advanced），不再受分辨率限制排版，能轻松容纳更多高级选项（由于算法模式的新增及各种选项扩张而带来的界面优化）。 #### 🛡️ 优化与修复 (Optimizations & Fixes) * **工具保护机制重构，修复耐久保护失效 (Tool Protection Rework)** * **修复了旧版机制中“耐久过低时直接拒绝连锁发包”的死板设定。** * 现在系统更加智能：不再是粗暴地停止工作，如果开启了保护，每次会精准将“你手中工具的剩余可用耐久（固定保留10点安全值）”动态视作本次连锁的**挖掘/处理数量上限**，允许你在报废前完成最大程度的有限连锁。 * 全面梳理了空手 (Empty Hand) 判定，空手现在能够正确享有默认最大上限进行运作！ * **生存模式防穿安全锁 (Unbreakable Block Filter)** * 在生成待挖掘方块发包列表的最末端加入了硬防线：当处于生存或冒险模式时，系统会自动在数据底层将硬度 `< 0`（如不可破坏的基岩、末地传送门、屏障）的方块强制剔除。以杜绝因玩家操作或服主错误配置白名单时，连锁毁掉整个世界结构的灾难隐患。

- 修复了方块搜索时对角斜角配置不生效的问题 - 添加了发包速率控制 - 在配置界面能根据服务器是否安装了服务端来禁用相应无效配置项

- 添加了连锁种植作物 - 添加了连锁使用工具，支持打蜡、去皮、耕地、除锈等操作

- 添加斜角对角连锁开关 - 添加连锁半径 --- - Add chamfer diagonal chain switch - Add chain radius