MinersAdvantage

MinersAdvantage

概述

MinersAdvantage 是一款专为“我来挖矿，不是来填表的”玩家打造的模组。

这是对旧版 MC 1.20 时代版本的又一次全面重写：保留那些广受喜爱的便利功能，移除过去令人头疼的问题，并让整套功能在单人游戏和多人游戏中都更加合理。挖矿、耕种和砍树依然能为你节省大量时间，同时还支持现代版 Fabric 和 NeoForge，并在服务器负载较高时表现得更加稳定。

如果你曾经想过：“我明明只想挖几组石头，怎么 45 分钟过去了还没结束？”那么这款模组就是为你打造的。

功能

• 物品吸引：自动将附近的物品和经验值吸到你身边（类似磁铁模式）。
• 作物收割：用锄头右键即可收割成熟作物并重新种植。
• 耕地培育：在水源和湿润条件符合要求的有效耕地周围自动耕地，提升耕种效率。
• 区域挖掘：一次挖掘一片区域内相连的方块，而非逐个挖掘。
• 道路铺设：配合你的铲子操作，快速铺出道路。
• 自动照明：挖矿时自动放置火把，不再被黑暗偷袭。
• 整树砍伐：根据树干和树叶的结构逻辑砍倒整棵树。
• 矿道开凿：开凿可配置的条带状矿道。
• 工具切换：根据当前情境和规则，自动选择快捷栏中最合适的工具。
• 矿脉挖掘：通过可配置的控制选项，一次挖完整条矿脉。
• 竖井开凿：向上或向下挖掘竖井，并可选择放置梯子。
• 服务器同步：同步游戏设置，并可在多人游戏中由服务器统一控制。
• 多加载器与多版本支持：Fabric 和 NeoForge 版本均由同一套共享代码构建。

运作方式

物品吸引

物品吸引会监测你设定范围内的物品实体和经验球，并根据列表模式将允许的物品吸到身边。你可以使用白名单或黑名单模式，也可以设置一份无条件生效的黑名单，确保特定物品永远不会被吸走。

作物收割

作物收割有两项主要的耕种便利功能：用锄头右键点击作物即可收割并立即重新种植；还可以选择是否启用种子收集，并决定优先获得整洁的收获结果，还是积攒更多种子。

耕地培育

耕地培育专注于自动耕地，并根据水分条件检查农田，确保只有在水源有效支持的地方才会自动处理耕地。它旨在让自动耕种更加可控，而不是“莫名其妙地闹脾气”。

区域挖掘

区域挖掘会在可配置的范围内破坏符合条件的方块，并提供每刻处理上限、方块变种处理和列表筛选逻辑。它支持按住或切换两种操作方式；启用相关共享选项后，也能与自动照明和矿脉挖掘等系统协同工作。

道路铺设

道路铺设可将草方块和泥土快速铺成道路，并能配置道路的宽度和长度。它就像是“铺路不伤手”的快捷按钮，而且适用于所有类型的泥土。

自动照明

自动照明会监测周围亮度，并在亮度低于设定阈值时放置火把。你只管继续挖矿，它会帮你预防“转角突然冒出苦力怕”这种情况。

整树砍伐

整树砍伐会遍历树干和树叶区域，识别整棵树，并根据你的策略设置将其砍倒。你可以控制树叶处理方式、耐久度消耗行为和树苗重新种植，让砍树速度与可持续性符合你的偏好。

矿道开凿

Shaftanation 会按照可配置的宽度、高度、深度和每刻挖掘速度，开挖笔直的采矿通道。你只需设定竖井的形状和规模，重复的挖掘工作就交给它。

工具替换

工具替换会根据方块或实体的情境，自动切换到快捷栏中最合适的工具，并可选择在之后切换回来。规则配置支持根据操作匹配目标，也支持基于表达式的高级优先级设定，方便追求精准控制的玩家。

矿脉挖掘

矿脉挖掘会在挖矿时扩展为整条矿脉开采，并支持设置距离限制和可选的计时修正。你还可以设定是否必须潜行，以及采出的矿石掉落物放置在哪里。

竖井开挖

竖井开挖可创建垂直通道，并支持配置尺寸和挖掘速度。还可以选择自动放置梯子，让竖井成为真正可用的通道，而不只是一个好看的坑。

多人同步与规则执行

仅影响客户端画面的设置会保留在本地；影响玩法的设置则会在多人游戏中与服务器状态同步。简而言之：轮廓颜色由你决定，服务器玩法规则则由服务器决定。

安装

Fabric

1. 安装受支持的 Minecraft 版本和 Fabric 加载器。
2. 安装与游戏版本相同的 Fabric API。
3. 下载适用于目标版本的 MinersAdvantage Fabric jar 文件。
4. 将 jar 文件放入 mods 文件夹。
5. 启动游戏。

NeoForge

1. 安装受支持的 Minecraft 版本和 NeoForge。
2. 下载适用于目标版本的 MinersAdvantage NeoForge jar 文件。
3. 将 jar 文件放入 mods 文件夹。
4. 启动游戏。

多人游戏说明

为确保功能一致、行为稳定，请在客户端和服务器上都安装 MinersAdvantage。

配置

MinersAdvantage 会将配置以 TOML 格式分别存储在不同目录中：

• 客户端文件：minersadvantage-client-config.toml
• 服务器玩法配置文件：minersadvantage-server-config.toml

客户端选项仅在本地生效。多人游戏中的玩法选项以服务器设置为准。

客户端配置（minersadvantage-client-config.toml）

选项	类型	默认值	说明
disable_particle_effects	布尔值	false	设为 true 时，禁用功能粒子效果。
outline_foreground_color_argb	颜色	0xFF40D9C0	用于前景轮廓的 ARGB 颜色。
outline_see_through_color_argb	颜色	0x4B40D9C0	用于透视轮廓的 ARGB 颜色。

通用玩法配置（minersadvantage-server-config.toml）

选项	类型	默认值	范围	描述
common.tps_guard	boolean	true	–	在 TPS 较低时减少激进行为。
common.gather_drops	boolean	false	–	在适用情况下启用掉落物收集辅助功能。
common.auto_illuminate	boolean	true	–	允许兼容功能触发照明行为。
common.mine_veins	boolean	true	–	允许兼容功能触发脉络挖掘行为。
common.blocks_per_tick	int	1	1 to 1024	每刻处理预算的共享基准值。
common.enable_tick_delay	boolean	true	–	启用刻延迟节奏控制。
common.tick_delay	int	5	0 to 200	启用时，处理周期之间的延迟。
common.block_radius	int	3	1 to 128	相关功能操作使用的共享搜索半径。
common.block_limit	int	64	1 to 8192	单次操作可处理方块数量的共享上限。

吸引（minersadvantage-server-config.toml）

选项	类型	默认值	范围	描述
captivation.enabled	boolean	true	–	启用或禁用吸引功能。
captivation.allow_in_gui	boolean	false	–	允许在 GUI 界面打开时执行捕获行为。
captivation.radius_horizontal	int	16	1 to 128	水平方向的拾取半径。
captivation.radius_vertical	int	16	1 to 128	垂直方向的拾取半径。
captivation.is_whitelist	boolean	false	–	设为 true 时，将 blacklist 作为白名单处理。
captivation.unconditional_blacklist	boolean	false	–	无论是否采用白名单逻辑，始终排除列出的条目。
captivation.blacklist	list<string>	[“minecraft:rotten_flesh”, “minecraft:egg”]	–	用于白名单或黑名单筛选的物品 ID。

作物收获（minersadvantage-server-config.toml）

选项	类型	默认值	描述
cropination.enabled	boolean	true	启用或禁用作物收获功能。
cropination.harvest_seeds	boolean	true	设为 true 时，自动收获会掉落种子。

耕作（minersadvantage-server-config.toml）

选项	类型	默认值	范围	描述
cultivation.enabled	boolean	true	–	启用或禁用耕作功能。
cultivation.hydration_distance	int	4	1 to 16	补水逻辑使用的水源距离检查值。

挖掘（minersadvantage-server-config.toml）

选项	类型	默认值	范围	描述
excavation.enabled	boolean	true	–	启用或禁用挖掘功能。
excavation.width	int	3	1 to 127	挖掘宽度。
excavation.height	int	3	1 to 127	挖掘高度。
excavation.depth	int	3	1 to 64	挖掘深度。
excavation.processes_per_tick	int	10	1 to 512	每刻的处理量。
excavation.toggle_mode	boolean	false	–	设为 true 时，使用切换模式而非按住模式。
excavation.ignore_block_variants	boolean	false	–	匹配时将不同方块变种视为相同。
excavation.is_block_whitelist	boolean	false	–	设为 true 时，将 block_blacklist 作为白名单使用。
excavation.block_blacklist	list<string>	[]	–	用于黑名单/白名单筛选的方块 ID。

道路生成（minersadvantage-server-config.toml）

选项	类型	默认值	范围	描述
pathanation.enabled	boolean	true	–	启用或禁用道路生成功能。
pathanation.path_length	int	6	1 to 64	生成道路段的长度。
pathanation.path_width	int	3	1 to 9	生成道路段的宽度。

照明（minersadvantage-server-config.toml）

选项	类型	默认值	范围	描述
illumination.enabled	boolean	true	–	启用或禁用照明功能。
illumination.radius_horizontal	int	8	1 to 64	放置检查的水平搜索半径。
illumination.radius_vertical	int	4	1 to 64	放置检查的垂直搜索半径。
illumination.lowest_light_level	int	1	0 to 15	低光照检测的放置阈值。
illumination.use_block_light	boolean	true	–	设为 true 时，使用方块光照评估方式。

照明（minersadvantage-server-config.toml）

选项	类型	默认值	范围	描述
lumbination.enabled	boolean	true	–	启用或禁用 Lumbination。
lumbination.max_trunk_range	int	32	1 to 128	树干搜索的最大范围。
lumbination.max_leaf_range	int	6	1 to 32	树叶搜索的最大范围。
lumbination.processes_per_tick	int	8	1 to 512	每个游戏刻的处理吞吐量。
lumbination.chop_tree_below	boolean	true	–	为 true 时，会继续砍伐起始点下方的方块。
lumbination.destroy_leaves	boolean	true	–	为 true 时，会在处理树木时移除树叶。
lumbination.leaves_affect_durability	boolean	false	–	为 true 时，树叶也会消耗工具耐久度。
lumbination.replant_saplings	boolean	true	–	尝试在可行的位置重新种植树苗。
lumbination.use_canopy_tool	boolean	true	–	使用树冠检测与处理逻辑，以应对形状更复杂的树木。
lumbination.ignore_player_placed_leaves	boolean	true	–	识别天然树木时忽略玩家放置的树叶。
lumbination.logs	list<string>	[]	–	额外的树干/原木方块 ID。
lumbination.leaves	list<string>	[]	–	额外的树叶方块 ID。
lumbination.axes	list<string>	[]	–	Lumbination 功能允许使用的工具列表。

竖井化（minersadvantage-server-config.toml）

选项	类型	默认值	范围	描述
shaftanation.enabled	boolean	true	–	启用或禁用 Shaftanation。
shaftanation.depth	int	16	1 to 256	竖井长度/深度。
shaftanation.processes_per_tick	int	10	1 to 512	每个游戏刻的处理吞吐量。
shaftanation.width	int	1	1 to 7	竖井宽度。
shaftanation.height	int	2	1 to 5	竖井高度。
shaftanation.torch_placement	enum	FLOOR	enum value	火把放置模式（FLOOR 及其他枚举值）。

替换（minersadvantage-server-config.toml）

选项	类型	默认值	说明
substitution.enabled	boolean	true	启用或禁用 Substitution。
substitution.allow_mending	boolean	false	设为 true 时，允许在候选选择中使用具有经验修补的工具。
substitution.prioritize_silk_touch	boolean	false	设为 true 时，优先选择精准采集类效果。
substitution.switch_back	boolean	true	设为 true 时，操作后切回之前的快捷栏栏位。
substitution.favour_fortune	boolean	true	适用时优先选择时运效果。
substitution.ignore_if_valid_tool	boolean	true	如果当前手持工具已符合要求，则跳过替换。
substitution.ignore_passive_mobs	boolean	true	设为 true 时，攻击被动型生物不会触发切换工具行为。
substitution.blacklist	list<string>	[]	不纳入替换考量的物品 ID。

矿脉连采（minersadvantage-server-config.toml）

选项	类型	默认值	范围	说明
veination.enabled	boolean	true	–	启用或禁用矿脉连采。
veination.max_vein_distance	int	12	1 to 64	连通矿脉的最大距离。
veination.ores	list<string>	[]	–	明确指定允许采掘的矿石方块列表。
veination.ore_harvest_without_sneak	boolean	true	–	允许无需潜行即可采掘矿石。
veination.drop_ores_at_first_block	boolean	true	–	将掉落物放在最先破坏的矿石方块附近。
veination.increase_harvest_time_per_ore	boolean	true	–	设为 true 时，采掘时间会随矿脉大小增加。
veination.harvest_time_modifier	double	0.2	0.01 to 10.0	应用于缩放后采掘时间的修正系数。
veination.pickaxe_blacklist	list<string>	[]	–	矿脉连采功能禁用的镐子列表。

通风挖掘（minersadvantage-server-config.toml）

选项	类型	默认值	范围	说明
ventilation.enabled	boolean	true	–	启用或禁用通风挖掘。
ventilation.width	int	1	1 to 32	通道宽度。
ventilation.height	int	16	1 to 64	通道高度范围。
ventilation.depth	int	1	1 to 64	通道深度/长度。
ventilation.processes_per_tick	int	8	1 to 512	每刻处理吞吐量。
ventilation.place_ladders	boolean	true	–	启用后，挖掘通道时会放置梯子。

高级替换规则配置（运行时数据）

Substitution 的运行时默认配置中包含高级 selectionRules 规则配置。该配置会根据操作和表达式进行处理，每条规则可以包含以下字段。

字段	类型	描述
action	enum	BREAK、INTERACT、ATTACK、STAT_CHANGE 或 ANY。
targetKind	enum	BLOCK_TAG、ENTITY_TYPE 或 ANY。
targetId	string	所选目标种类的标签/实体标识符。
requiredToolKind	string	工具类别提示（例如 pickaxe、axe、shovel、hoe）。
targetPriority	int	在目标匹配项中进行选择的优先级。
toolPriority	int	在工具候选项中进行选择的优先级。
preferSilkTouch	boolean	为该规则优先采用精准采集类结果。
preferFortune	boolean	为该规则优先采用时运类结果。
targetExpression	string	可选的目标表达式，支持 AND/OR/NOT 和括号。
toolExpression	string	可选的工具表达式，支持 AND/OR/NOT 和括号。
minSilkTouch	int	所需的最低精准采集等级。
minFortune	int	所需的最低时运等级。
requireMending	boolean	为 true 时要求所选工具带有经验修补。
denyMending	boolean	为 true 时拒绝带有经验修补的工具（若两者均为 true，则 requireMending 优先）。

兼容性

主题	状态
Minecraft 版本	维护 1.21.11 和 26.1.2 节点。
加载器	Fabric 和 NeoForge 均为一等支持目标。
已知冲突	目前未记录任何硬性冲突。如果你发现了冲突，请提交 issue。

技术文档

完整技术细节请参阅 TECHNICAL.md。

许可证

MIT – 完整文本请参阅 LICENSE.md。

致谢

• DuelMonster 提供了原模组和现代重写版本。
• Stonecutter、Modstitch、Fabric、NeoForge、Cloth Config 和 ModMenu 的维护者们。