Lucky Tweaks

幸运微调

为 幸运方块 模组（Forge 1.20.1）修复问题并提供平衡工具。

幸运值修复

幸运方块模组会在方块从世界中移除后才读取被破坏方块的幸运值，因此玩家破坏方块时的幸运值判定始终为 0。幸运值合成、自然生成的幸运/不幸结构以及自定义幸运值都因此不起作用。Lucky Tweaks 会在方块被破坏时捕获其真实幸运值，并将其注入掉落判定中。无需修改幸运方块的 JAR 文件。

概率

幸运值加成统一以概率 %表示，因此同一个数值在所有方块上都代表相同的含义：+100% 始终对应该方块可能出现的最佳结果，-100% 则对应最差结果。其他模组和脚本可通过 API 提供概率（幸运戒指、幸运腰带和入侵惩罚都通过此机制生效），系统会在后台将其换算为各个方块对应的幸运值。

游戏内配置界面

以下所有选项都能通过模组列表中的配置按钮设置，无需编辑文件。界面会列出检测到的所有幸运方块，并为每种方块提供独立控制项（上限、生成规则、启用/禁用）。

各方块幸运值上限

可为任意幸运方块设置正幸运值上限（负幸运值不受限制）：

# config/luckytweaks-common.toml
luckCaps = ["lucky:lucky_block=60"]

上限会同时应用于破坏判定、幸运值合成结果和合成预览，因此工具提示始终与实际判定一致。支持重载，并会覆盖通过 API 注册的上限。

世界生成控制

• 全局生成倍率（1.0 至 3.0），用于控制幸运方块在新生成地形中的出现频率。不会更改已生成的区块。
• 可为任意方块设置各维度的规则：禁止其在某个维度生成、强制其在某个维度生成，或设置生成频率（每 N 个区块生成 1 次）。

禁用幸运方块

可关闭指定的幸运方块。禁用后，该方块不再生成；破坏已存在的方块也不会触发效果，而是掉落为物品并保留其幸运值。适用于基础方块、附属方块和跨模组幸运方块。

幸运武器修复

幸运剑、弓和药水在命中时会触发幸运方块效果，其中部分效果会伤害使用者。启用此选项后，有害效果（TNT、闪电、熔岩、火、蜘蛛网）会从命中判定中移除；武器幸运值越高，移除概率越高，在 +100 时约为 1%。攻击性和有益效果会保留，且不会影响幸运方块。可配置。

融合

新增合成配方，可将两个或更多同类型幸运方块合并为一个，并累加它们的幸运值（受方块上限和总计 +/- 100 的限制）。支持堆叠物品，也支持按住 Shift 点击进行批量合成。

共享生命

这是整合包的难度调节方式，用来取代简单的硬核模式开关。整个团队共享一个不会自动恢复的生命池；生命耗尽时，本次冒险即告结束。单人游戏时为 1 条生命；多人游戏时每位玩家各有 1 条，另加 1 条备用生命（两人时共 3 条，三人时共 4 条），人数按团队曾达到的最大规模计算。两项数值都可配置，生命数取决于实际游玩人数，而非世界是否开放到局域网。剩余生命会以一排心形图标显示在 HUD 上；可在配置界面的专用“Lives”选项卡中设置其颜色、角落位置和偏移量。

兼容 PlayerRevive

安装可选的 PlayerRevive 模组后，本会死亡的玩家会进入倒地状态，队友可以将其救起。只有在另一名玩家实际在线时，这项功能才会启用，因此单人游玩仍会像普通硬核模式一样死亡；在服务器上也与单人游戏完全一致。倒地会消耗一条共享生命；主动放弃则会失去物品。Lucky Tweaks 中没有关闭此功能的开关：由于复活功能的存在，共享生命池会为合作游戏中的每名玩家额外提供一条生命，因此两项功能会一并启用（PlayerRevive 自身的配置仍由你掌控）。

玩家定位器

多人游戏中，经验条上方会显示一排标记，指示其他玩家的位置；标记按玩家区分颜色，并会随距离增加而逐渐淡去。按住玩家列表键可显示他们的名字牌和头部图标。这是对 Player Locator Plus 的忠实复刻，并且完全可配置，还可选择隐藏潜行或隐身的玩家。

圣心上限

限制玩家一生中最多能吃下多少个 Yakurum 圣心（默认为 10 个）。每个圣心都会永久增加一颗心，而 Yakurum 本身没有数量上限，因此这项功能可以防止生命值条无限增长。其他所有额外生命值来源均不受影响。

鳄鱼修复

修复 Fuze Relics 中的鳄鱼：鳄鱼被杀死时会归还吃掉的物品，而不是将其永久销毁。

传奇与诅咒掉落

读取整合包注入掉落表的 NBT 标记，以识别最稀有的“传奇”掉落和最棘手的“诅咒”掉落。抽中传奇掉落时，会向全服务器播放庆祝音效并生成粒子效果；两类掉落都会计入 Lucky Stats 界面中的传奇/诅咒计数器。幸运图腾的增益和诅咒也使用相同的标记。

主菜单品牌标识

在标题屏幕底部显示一行可配置文字（整合包名称和版本）。只需一个配置文件，无需重新构建。

游戏记录完整性封印

适用于重视公平性的游戏和竞赛。每位玩家都有一份独立封印，记录在 Lucky Stats 界面中，显示游戏是否使用过创造模式或旁观模式、是否启用了作弊、是否在非硬核模式下运行、是否使用了非默认的 Lucky Tweaks 配置，以及存档是否被编辑过。一旦标记生效，就会一直保留；记录还带有校验和，可检测基本的存档编辑操作。与任何客户端检查一样，有决心的模组作者仍可能绕过它，因此如需充分保障，请在服务器上举办竞赛。需要 Lucky Stats。

JEI

安装 JEI 后，会为每个已注册的幸运方块和幸运合成材料生成示例配方（幸运合成和融合属于动态配方，JEI 本身无法显示）。

API

com.lwi.luckytweaks.api.LuckyTweaksApi：

• addChance(int)：为当前方块破坏增加概率 %（请在优先级为 HIGH 或更低的 BlockEvent.BreakEvent 处理器中调用）
• addTopReroll()：为方块的最高阶授予一次重抽机会
• registerLuckCap(blockId, max) / getLuckCap(blockId) / getCapturedLuck() / getContributedChance()
• registerBreakListener(...)、isLuckyBlock(...)、getLuckyBlockIds(...)，以及 LEG_TAG / CURSE_TAG 掉落标记

可通过 Java.loadClass 在 KubeJS 服务端脚本中使用。

需要 Lucky Block。可选：PlayerRevive（合作复活）、JEI（配方显示）、Lucky Stats（游戏记录完整性封印）。为 Lucky World Invasion Reloaded 打造。