禁用器

Disabler：生成、生物群系、维度、结构与物品控制

关于

一个服务端实用模组，让管理员能够控制生物生成、结构生成、维度访问、世界构成、物品、战利品和容器物品——由简单的配置文件驱动。

你可以控制：

阻止生物生成

• 从生物群系生成列表中移除生物
• 取消运行时的生成尝试 禁用结构
• 阻止整个结构类型生成
• 移除它们自定义的生物生成覆盖

移除生物群系

• 将特定生物群系完全排除在世界生成之外
• 干净地阻止它们出现在新世界中
• 保持陆地替换在陆地上、水域替换在水域中
• 包含针对 Alex's Caves 洞穴生物群系生成路径的额外兼容处理

禁用维度

• 在实体进入被阻止的维度之前取消维度旅行
• 当 minecraft:the_nether 被阻止时，阻止新的下界传送门形成
• 没有生成传送回退：玩家留在原地

阻止物品

• 从生成的战利品中移除配置的物品
• 阻止被阻止的物品实体留在世界中或进入玩家物品栏
• 清理合成、熔炼、玩家物品栏、末影箱、装备和打开的容器结果
• 可选地按可配置的间隔扫描已加载的模组与原版存储

简单的 JSON 文件

• 无命令、无 GUI
• 仅服务端
• 无需客户端安装
• 可选单人游戏支持
• NeoForge、Forge 和 Fabric 上使用相同的 config/disabler-server.json 格式

配置

配置文件位于：

.minecraft/config/disabler-server.json

{
  "blocked_mobs": [],
  "blocked_biomes": [],
  "biome_exceptions": [
    "minecraft:mushroom_fields"
  ],
  "blocked_structures": [],
  "blocked_dimensions": [],
  "blocked_items": [],
  "storage_scan": {
    "enabled": true,
    "interval_ticks": 300,
    "block_entities_per_tick": 512,
    "skipped_namespaces": []
  }
}

参数

• blocked_mobs：无法生成或加入服务器世界的实体类型 ID。示例：minecraft:zombie。
• blocked_biomes：从新生成区块中排除的生物群系 ID。替换项根据气候选择，并保留陆地/水域类别。示例：minecraft:plains。
• biome_exceptions：不能作为替换项选择的生物群系。minecraft:mushroom_fields 默认被排除，因为它有特殊的地形要求。
• blocked_structures：阻止在新生成区块中开始生成的结构 ID。示例：minecraft:village_plains。
• blocked_dimensions：实体无法进入的原版或模组维度 ID。旅行在更改层级之前被取消。示例：minecraft:the_end。
• blocked_items：从战利品、物品实体、玩家物品栏、合成与熔炉结果、打开的菜单以及受支持的存储中移除的原版或模组物品 ID。示例：minecraft:elytra。
• storage_scan：用于定期从已加载的方块实体物品栏中移除被阻止物品的一组设置。
• storage_scan.enabled：启用或禁用定期存储扫描。当此项为 false 时，基于事件的物品和战利品阻止仍会继续工作。
• storage_scan.interval_ticks：完整存储扫描周期之间的延迟。默认为 300 tick，约 15 秒。
• storage_scan.block_entities_per_tick：每 tick 检查的排队方块实体最大数量。默认限制为 512。
• storage_scan.skipped_namespaces：其物理存储不得被扫描的模组命名空间。示例：["examplemod"]。

该模组还会创建 .minecraft/config/DisablerGuide.md，其中包含相同的参数说明。未打开的 loot-table 容器会保持原样，直到其战利品被生成，从而防止干扰 Lootr 转换。

如果存在旧的 .minecraft/config/disabler-server.toml 而 JSON 不存在，已知设置会自动迁移。TOML 文件会作为备份保留，而所有后续配置均使用 JSON。

在 GitHub 上查看其工作原理！