Dimensional Structure Restrict

维度结构限制（DimStructRestrict）

DimStructRestrict 是一款轻量级 Minecraft Forge 模组，适用于 Minecraft 1.20.1，可让你根据维度和结构规则控制结构的生成位置。这款模组由 Troy Cook (@cookta2012) 设计并开发，可精细控制世界生成行为，尤其适合整合包开发者和世界设计者。

首个版本将支持 1.20.1，其他版本将在之后推出。

🌍 功能

• 阻止或允许特定结构在特定维度中生成。
• 定义白名单或黑名单规则。
• 可选地将结构标记为不实际放置，即使它认为自己已经放置了结构。
• 基于 JSON 的配置——支持注释，并会自动重新生成缺失的键。
• 记录规则执行情况及结构/维度信息，便于调试。

🔧 配置

配置文件位于：

/config/dimstructrestrict.json

如果文件不存在，模组会生成一个包含示例条目的配置文件。

📐 dimstructrestrict.json 的结构

{
  "structures": [
    {                                       // Individual structure rules will override dimension rules FULL STOP
      "id": "minecraft:village_plains",     // Structure ID
      "whitelist": ["minecraft:overworld"], // Allowed dimensions
      "false_place": false,                 // If true, the structure will be "falsely placed" (may break mods)
      "active": true                        // Whether this rule is active
    }
  ],
  "dimensions": [
    {
      "id": "minecraft:overworld",        // Dimension ID
      "whitelist": [],                    // Structures allowed in this dimension
      "active": true
    }
  ]
}

🧠 规则类型

✅ whitelist

只有列出的维度或结构才会被允许。

❌ blacklist

列出的维度或结构将被禁止。

⚙️ false_place（可选，默认为 false）

如果设为 true，结构不会实际放置，但不会跳过生成步骤，也就是说它会在地图上被标记为已生成。

> ⚠️ 可能会导致某些依赖结构的模组出现问题。

🔄 active（可选，默认为 false）

控制是否执行该规则。无需移除规则即可暂时将其停用。

🧪 使用示例

{
  "structures": [
    {
      "id": "minecraft:ruined_portal",
      "blacklist": ["minecraft:the_end", "minecraft:the_nether"],
      "active": true
    }
  ],
  "dimensions": [
    {
      "id": "minecraft:overworld",
      "whitelist": ["minecraft:village_savanna", "minecraft:village_plains"],
      "false_place": true,
      "active": true
    }
  ]
}

🛠️ 高级设置

该模组在内部使用通用的 Rule 系统，并包含两个映射：

• STRUCTURE_RULES：用于结构专属规则
• DIMENSION_RULES：用于基于维度的限制

每条 Rule 包含：

• id：ResourceLocation
• mode：WHITELIST 或 BLACKLIST
• resource：目标集合（结构/维度 ID）
• false_place：布尔值
• active：布尔值

🧑‍💻 开发者信息

• 作者：Troy Cook
• GitHub：@cookta2012
• 语言：Java
• 环境：适用于 Minecraft 1.20.1 的 Minecraft Forge

📄 许可证

MIT 许可证。

📬 反馈与贡献

如果你想扩展该系统（例如基于游戏规则的控制、数据包集成或 GUI 支持），欢迎提交 issue 或 fork 该项目。