刷怪笼调整

刷怪笼调整模组介绍

本模组参考了经典模组 Mob Spawner Control 的设计。它提供了大量用于修改刷怪笼的配置文件，可以修改刷怪笼的以下内容：

---

🌐 全局总控设置

在全局设置分类下提供两个独立的功能开关，你可以随时按需启停对应功能模块：

• enableExtraSpawnerConfig：如果设置为 false，刷怪笼的所有额外配置将不会生效，模组新增的拓展机制会全部禁用。
• enableVanillaSpawnerConfig：如果设置为 true，将会以配置中的数值覆盖世界中所有刷怪笼的原版属性。你也可以将它设置为 false，配合《失落的城市》或其他模组生成一些带有定制过原版属性值的刷怪笼，同时启用 enableExtraSpawnerConfig 来使他们具有模组新增的拓展机制。

---

📋 原版刷怪笼基础属性配置

• spawnDelay：刷怪笼的生成延迟，以刻为单位，默认值 20。
• minSpawnDelay：刷怪笼的最小生成延迟，以刻为单位，默认值 200。
• maxSpawnDelay：刷怪笼的最大生成延迟，以刻为单位，默认值 800。
• spawnCount：每次刷怪笼激活时生成的生物数量，默认值 4。
• maxNearbyEntities：刷怪笼附近允许的最大实体数量，默认值 6。
• requiredPlayerRange：玩家必须在范围内才能使刷怪笼生成生物的距离，默认值 16 格。
• spawnRange：刷怪笼生成生物的范围半径，默认值 4 格。

---

⚙️ 刷怪笼额外拓展配置

基础设置

• breakSpawner：如果设为 false，刷怪笼失效时只会被禁用，而不会被破坏。
• canPlayerBreakSpawner：如果设为 false，玩家将无法破坏刷怪笼。
• spawnerImmuneToExplosion：如果设为 true，刷怪笼将免疫爆炸。

刷怪笼生成数量相关配置

• limitSpawnCount：刷怪笼是否启用生成数量限制。
• mobThreshold：当某个刷怪笼生成的生物数量达到这个数字时，会停止工作，最小值为 1。
• incrementOnMobDeath：如果设为 true，刷怪笼将在生物被击杀时计数，而不是在生成时计数。
• incrementOnlyWhenMobDieOfPlayer：如果设为 true，刷怪笼将仅在生物被玩家击杀时计数。
• multiPlayerMobThresholdIncreaseRate：当多个玩家在这个刷怪笼附近时，这个倍率会应用于生成数量阈值的增加。计算公式：最终阈值 = 基础阈值 + (玩家数量 - 1) x 倍率 x 基础阈值。

刷怪笼生成速率相关配置

仅在 limitSpawnCount 设置为 true 时生效，可以实现刷怪笼生成速度的动态变化：

• spawnRateModifier：该倍率会在每次生物生成或击杀时应用于刷怪笼的生成延迟。可用于使生成的生物呈指数级加快或减慢。小于 1 则加快，大于 1 则减慢，等于 1 则不变。取值范围 0.01~100.0，默认值 1.0。
• adjustSpawnRateOnMobDeath：如果设为 true，刷怪笼将在生物被击杀时调整生成速率，否则在生物生成时调整生成速率，默认值 true。
• minMinSpawnDelay：经过 spawnRateModifier 修改后的刷怪笼最小生成延迟刻数的最小值，默认值 20。
• maxMinSpawnDelay：经过 spawnRateModifier 修改后的刷怪笼最小生成延迟刻数的最大值，默认值 400。
• minMaxSpawnDelay：经过 spawnRateModifier 修改后的刷怪笼最大生成延迟刻数的最小值，默认值 80。
• maxMaxSpawnDelay：经过 spawnRateModifier 修改后的刷怪笼最大生成延迟刻数的最大值，默认值 1600。

刷怪笼生成条件配置

用于改变刷怪笼生成规则的自定义选项：

• forceSpawnerAllSpawns：如果设为 true，刷怪笼将不对任何实体执行生物特定的检查，例如动物生成需要草方块、大多数敌对生物需要在黑暗中生成，开启后你就不能通过人造光源来禁用刷怪笼了，默认值 false。
• checkSunlight：如果启用了 forceSpawnerAllSpawns 且将这个配置项设置为 true，将阻止敌对生物在阳光下生成，但仍可在雨中生成，默认值 true。
• onlySpawnInDoors：如果为 true 则只能在室内生成，主要用于配合《失落的城市》模组使用，默认值 false。
• useIndependentPlayerRange：使用水平和垂直玩家范围代替原版的球形范围检查，默认值 false。
• horizontalPlayerRange：玩家必须在这个水平范围内才能使刷怪笼生成生物，默认值 16.0 格。
• verticalPlayerRange：玩家必须在这个垂直范围内才能使刷怪笼生成生物，默认值 16.0 格。

刷怪笼破坏掉落配置

用于配置刷怪笼方块自身被破坏时的掉落规则：

• xpDropped：刷怪笼被破坏时掉落的最小经验值，默认值 15。
• randXpVariation：计算掉落经验值的公式为 xpDropped + rand(该值) + rand(该值)，默认值 15。
• itemsDropped：刷怪笼被破坏时掉落的物品 ID 列表，格式为 modid:item(:count(:chance))，数量和概率为可选参数，默认是空列表。

刷怪笼生成生物的战利品配置

仅对刷怪笼生成的生物生效，完全不影响自然生成生物的掉落规则。

defaultValues - 全局默认战利品配置

• xpMultiplier：刷怪笼生成的生物的经验值掉落倍率，最先被计算，默认值 1.0。
• flatXpIncrease：将添加给刷怪笼生成的生物的固定经验值修正，在乘以 xpMultiplier 之后计算，默认值 0。
• removeAllItems：移除此类刷怪笼生成的生物的所有现有物品掉落，之后会添加后续配置的“添加的物品”，默认值 false。
• removedItems：从生成的生物的掉落物中移除哪些物品，格式为 modid:item，如果“移除所有物品”为 true，则此项无效。
• addedItems：向生成的生物的掉落物中添加哪些物品，格式为 modid:item(:count(:chance))，数量和概率为可选参数。

特定生物独立自定义配置

• xpMultipliers：针对刷怪笼生成的某些生物的独立经验值掉落倍率配置，格式为 modid:entity:xpMultiplier(:flatXp)，flatXp 为可选参数。
• itemDropRemovals：针对刷怪笼生成的某些生物的独立物品掉落移除配置，格式为 modid:entity(,modid:item)(,modid:item)...，括号内的内容均为可选，可输入任意数量的物品；如果你不输入任何物品，则会移除该生物的所有掉落物，之后会自动添加对应生物的自定义新增掉落。
• itemDropAdditions：针对刷怪笼生成的某些生物的独立物品掉落添加配置，格式为 modid:entity,modid:item(:count(:chance))(,modid:item(:count(:chance)))...，括号内的内容均为可选，可输入任意数量的物品。