Dimensional Structure Restrict

Dimensional Structure Restrict

DimStructRestrict — это лёгкий мод для Minecraft Forge на Minecraft 1.20.1, который позволяет управлять тем, где могут появляться структуры, на основе правил для измерений и структур. Разработан Troy Cook (@cookta2012). Мод даёт тонкий контроль над генерацией мира — особенно полезен для разработчиков модпаков и создателей миров.

Первый релиз будет для 1.20.1, другие версии появятся позже.

🌍 Возможности

• Запрещать или разрешать генерацию конкретных структур в конкретных измерениях.
• Задавать правила по белому или чёрному списку.
• Опционально помечать структуры как «не размещать», при этом считая, что она размещена.
• Конфигурация на основе JSON — поддерживает комментарии и автоматически восстанавливает отсутствующие ключи.
• Логирует применение правил с контекстом структуры и измерения для отладки.

🔧 Конфигурация

Файл конфигурации находится по пути:

<minecraft_root>/config/dimstructrestrict.json

Если файла нет, он будет создан с примерами записей.

📐 Структура dimstructrestrict.json

{
  "structures": [
    {                                       // Правила для отдельных структур переопределяют правила измерений БЕЗ ИСКЛЮЧЕНИЙ
      "id": "minecraft:village_plains",     // ID структуры
      "whitelist": ["minecraft:overworld"], // Разрешённые измерения
      "false_place": false,                 // Если true, структура будет «ложно размещена» (может сломать моды)
      "active": true                        // Активно ли это правило
    }
  ],
  "dimensions": [
    {
      "id": "minecraft:overworld",        // ID измерения
      "whitelist": [],                    // Структуры, разрешённые в этом измерении
      "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: Boolean
• active: Boolean

🧑‍💻 Заметки для разработчиков

• Автор: Troy Cook
• GitHub: @cookta2012
• Язык: Java
• Окружение: Minecraft Forge для Minecraft 1.20.1

📄 Лицензия

MIT License.

📬 Обратная связь и вклад

Не стесняйтесь открыть issue или форкнуть проект, если хотите расширить систему (например, управление через gamerule, интеграцию с датапаками или поддержку GUI).