静脉袋

Vein Pocket ⛏️📦

Vein Pocket 是一款专为 NeoForge（Minecraft 1.21.1） 使用 Kotlin 开发的现代轻量级实用模组。它允许玩家通过一次操作安全高效地开采整条矿脉，并将所有获取的资源直接送入玩家物品栏，防止其掉落进熔岩、虚空或因超时消失。

---

🌟 关键特性

• 连锁矿脉： 破坏一个矿石会触发三维递归搜索（包括对角线），直到达到可配置的方块数量上限，自动破坏同类型的所有相连矿石。
• 智能自动拾取： 所有资源直接插入玩家物品栏，而不是掉落在被开采方块的位置。
• 溢出保护： 如果在连锁采矿时物品栏已满，任何剩余物品都会安全地掉落在玩家脚下。
• 完整附魔支持： 无缝兼容原版附魔逻辑——支持 时运 以增加物品产量，以及 精准采集 以掉落原始方块。
• 智能耐久管理：
• 工具保护：如果镐子剩余耐久达到 1 点，连锁采矿会自动停止，防止意外损坏。
• 准确计算 经验修补 附魔的触发概率。
• 潜行激活： 默认情况下，连锁采矿能力仅在按住潜行键（Shift）时触发。
• 创造模式保护： 在创造模式中故意禁用，以防止意外破坏建筑或地形。
• 性能优化： 采用高效的广度优先搜索（BFS）算法，不会造成服务器卡顿，同时干净利落地处理方块移除。

---

⚙️ 配置（veinpocket-settings.toml）

首次启动时，模组会在你的 Minecraft 配置目录中生成一个 .toml 配置文件：

.minecraft/config/veinpocket-settings.toml

自动恢复： 如果文件缺失、损坏或包含语法错误，Vein Pocket 将使用安全默认值重新写入。

文件结构（veinpocket-settings.toml）

# 这是使用此模组可开采的矿石数量上限。
blockLimit = 128
仅限潜行时进行连锁挖掘
alwaysCrouching = true
允许所有被开采的方块产生粒子效果。默认禁用以提高性能。
showParticles = false

配置详情

选项	类型	默认值	描述
blockLimit	整数（Int）	128	单次连锁中可开采的同类型矿石方块的最大数量。
alwaysCrouching	布尔值（Boolean）	true	true：需要按住潜行（Shift）才能激活连锁采矿。 false：任何矿石被破坏时都会激活。
showParticles	布尔值（Boolean）	false	false：只有初始方块会发出声音和粒子效果（性能最佳）。 true：矿脉中的每个方块都会产生独立的破坏粒子效果。

---

🛠️ 需求与安装

1. 为 Minecraft 1.21.1 安装 NeoForge。
2. 下载 Vein Pocket 的最新版本。
3. 将下载的 .jar 文件放入你的 mods 文件夹： .minecraft/mods/
4. 启动游戏即可享受！

---

📜 致谢

• 开发者： Moddy
• 框架： NeoForge / Kotlin