砍砍砍

ChopChopChop

ChopChopChop 是一款沉浸式的砍树模组，它能在视觉上逐步削减原木方块，并根据进度动态地让整棵树倒下。它不会瞬间破坏单个原木或让树木悬浮在半空中，而是让你用斧头砍击原木时，使其积累“砍痕”。

---

功能

• 视觉损坏系统 — 自定义带砍痕的原木方块，拥有 25 个损坏阶段的静态 3D 模型，模拟在木头上砍出的凹痕。
• 动态砍伐阈值 — 动态计算所需砍痕数量为 原木总数 + 1，上限可配置（默认 25 次）。
• 浮动 3D 抬头显示（HUD） — 在游戏世界中显示进度指示器（"X/Y"），位置朝向玩家视线高度外移 0.7 个方块，以防止模型遮挡。
• 效率颜色缩放 — HUD 文本颜色根据预估砍伐时间动态变化，从红色（慢速）过渡到橙色、黄色和绿色（快速），计算时会考虑工具等级、附魔、状态效果和树木大小。
• 平衡的音量 — 将树木倒下时的嘎吱声降低 55%，在提供令人满足的反馈的同时避免高分贝噪音。
• 潜行行为 — 可配置的潜行交互：始终砍伐、潜行时跳过（原版风格）、或仅潜行时砍伐。
• 健壮的树叶扫描器 — 使用广度优先搜索（BFS）算法验证结构连接和树叶数量，以防止人工建造的木屋倒塌。
• 工具耐久度上限 — 每棵树对斧头的耐久度消耗上限为 20 次，防止瞬间损坏斧头。
• 8 种木头类型 — 橡木、云杉木、白桦木、丛林原木、金合欢木、深色橡木、红树木、樱花木。
• 模组树木支持 — 来自其他模组（如 Biomes O' Plenty、Regions Unexplored 等）且使用 #minecraft:logs 标签的原木会被自动检测并纳入树木扫描。模组原木会像原版原木一样积累砍痕，但不会显示视觉损坏（模组木材没有自定义的砍痕模型）。
• 砍伐动画 — 树木会以底部为轴心，以逼真的方式旋转倒向地面。树叶会随树干移动，掉落物会落在树根处。超过可配置大小限制的树木则会瞬间倒下。
• 配置支持 — 分为三类：游戏玩法（启用、潜行行为、最大砍痕、最大树木大小）、兼容性（红树根、下界真菌）以及音频与视觉（砍伐风格、音量）。

---

需求

Fabric 1.21.1

依赖项	版本	是否必需
Minecraft	1.21.1	是
Fabric Loader	0.16.x+	是
Fabric API	0.115.0+	是
Yet Another Config Lib (YACL)	3.6.6+	是
ModMenu	11.x+	可选（配置 GUI）

---

安装

1. 为你的 Minecraft 版本安装相应的模组加载器（Fabric、Forge 或 NeoForge）。
2. 从此页面下载 ChopChopChop。
3. 将 .jar 文件放入你的 .minecraft/mods/ 文件夹。
4. 下载并将你加载器所需的依赖项放入同一文件夹。
5. 启动 Minecraft，开始砍树！

---

配置

• Fabric：通过 ModMenu → ChopChopChop → 配置 访问。设置保存在 config/chopchopchop.properties 下。
• Forge / NeoForge：通过 模组 → ChopChopChop → 配置 访问。设置保存在 config/chopchopchop.toml 下。

游戏玩法

设置	默认值	范围	描述
启用砍树	是	—	启用/禁用此模组
潜行行为	潜行以跳过	—	控制潜行如何影响砍树。始终砍伐：无论是否潜行都砍。潜行以跳过：按住潜行以原版方式挖掘。潜行以砍伐：仅在潜行时砍树
最大砍痕上限	25	1–100	砍倒任何树木所需的最大总砍痕数量
最大砍伐树木大小	64	1–256	树木可以拥有原木的最大数量，以便播放倒地动画。超过此限制的树木将瞬间被砍倒

兼容性

设置	默认值	范围	描述
破坏红树根	否	—	在树木扫描中包含红树根，并在砍伐时将其破坏
检测下界真菌	否	—	将绯红/诡异菌光体视为树叶，允许砍倒下界真菌（巨型蘑菇）

音频与视觉

设置	默认值	范围	描述
砍伐动画	瞬间	—	树木被砍倒时的动画风格。瞬间：所有方块同时破坏。倒下：树木视觉上斜向倒向地面
砍伐音量	1.0	0.0–2.0	树木倒下时嘎吱声的音量

---

兼容性

• 适用于 Fabric 1.20.1、Fabric 1.21.1、Forge 1.20.1、Forge 1.21.1 和 NeoForge 1.21.1。
• 支持任何影响挖掘速度的模组工具、附魔和 RPG 属性。
• 模组树木支持：任何在 #minecraft:logs 标签中的原木方块都会被自动检测并纳入砍树程序。像 Biomes O' Plenty、Regions Unexplored、Oh The Biomes You'll Go 等众多模组可以直接使用。模组原木会积累砍痕并计入砍伐阈值，但它们没有视觉损坏模型（只有原版原木会显示砍痕外观）。
• 整合包使用：在 MIT 许可下允许。

---

常见问题解答

问：我可以将这款模组加入整合包吗？ 答：可以！ChopChopChop 采用 MIT 许可证。你可以自由地将其加入任何整合包。

问：它能在服务器上工作吗？ 答：可以，此模组需要在客户端和服务器端都安装，以管理结构方块检查、网络同步和自定义 3D 浮动 HUD。

问：来自其他模组的树木能工作吗？ 答：可以！任何在 #minecraft:logs 标签中的原木方块都会被自动检测。像 Biomes O' Plenty、Regions Unexplored、Oh The Biomes You'll Go 等众多模组可以直接使用。模组原木会积累砍痕并计入砍伐阈值。唯一的区别是模组原木不会显示视觉损坏（没有自定义的刻痕模型），但它们仍然会显示浮动 HUD 并产生砍击声效。

问：我应该在哪里报告错误或建议功能？ 答：请访问 Arvani Creations 获取帮助、反馈和建议。

---

采用 MIT 许可。由 Arvani Creations 制作。