Structure Explorer

Мод Structure Explorer для Minecraft 1.21.11

Structure Explorer — это мод для серверов Minecraft на загрузчике Fabric, который превращает исследование мира в соревнование. Он автоматически отслеживает, в какие структуры заходили игроки, и предоставляет команды для просмотра списка открытий, истории посещений и рейтингового списка лидеров. Мод работает на стороне сервера, проверяя перемещения игроков каждые 5 секунд по умолчанию, и позволяет администраторам настраивать уведомления, формат дат и отображение названий структур через конфиги и файлы переводов.

🏆 Основная цель: превращение исследования мира в захватывающее соревнование. Мод Structure Explorer автоматически отслеживает, в какие структуры заходили игроки, создавая мотивацию для полного освоения карты сервера. Система работает на стороне сервера, постоянно проверяя перемещения игроков и фиксируя их открытия в личных списках.

⌨ Управление через команды. Основной инструмент — команда /explorer (также доступна как алиас /discoveries). С её помощью игроки и администраторы могут управлять информацией об открытиях:

📝 Настройка через файл конфигурации. Основной файл настроек находится по пути config/structure_explorer/structure_explorer.json. Здесь можно управлять поведением мода, включая интервал проверки, отображение значков и звуки.

⚠️ Важно: мод работает исключительно на стороне сервера (server-side). Он не может читать файлы локализаций из клиентских ресурс-паков, так как они недоступны серверу. Для интеграции с другими модами используйте встроенные файлы локализаций внутри JAR-архива модов или создайте специальные файлы переводов.

🛠 Интеграция для разработчиков модов. Structure Explorer предоставляет два способа добавления названий структур из ваших модов. Первый вариант — использование стандартного файла локализаций (lang/en_us.json), если он уже есть в мод-пакете. Формат ключа: "structure.имя_структуры": "Отображаемое имя". Это самый простой способ, требующий дополнительных файлов.

Пример для `assets/mymod/lang/en_us.json`:
```json
{
  "structure.mymod.cool_dungeon": "Cool Dungeon"
}
```

Второй вариант — полный контроль через файл translations.json, размещённый в data/structure_explorer/. Этот метод позволяет задавать префиксы, суффиксы и цвета для названий. Файлы, созданные разработчиком, загружаются до файлов конфигурации администратора, что позволяет последнему всегда переопределить настройки.

🗣 Система переводов. По умолчанию мод автоматически переводит названия ванильных структур (например, minecraft:fortress отображается как Nether Fortress). Для кастомизации названий любых пространств имен используйте файлы JSON в папке config/structure_explorer/translations/. Они загружаются после встроенных и встроенных в моды переводов, поэтому имеют приоритет.

Формат файла перевода:
```json
{
  "replace": false,
  "translations": {
    "namespace": {
      "prefix": "",
      "prefix_color": "",
      "suffix": "",
      "suffix_color": "",
      "name_color": "",
      "structures": {
        "structure_path": "Display Name"
      }
    }
  }
}
```

🎨 Поддержка цветов. В настройках и переводах можно использовать стандартные названия цветов (case-insensitive): black, dark_blue, gold, gray, red, white и другие. Также поддерживаются HEX-цвета в формате CSS (например, "#FF5500"). Цвета применяются независимо к префиксу, суффиксу и основному названию структуры.

📸 Визуализация работы. Мод автоматически обнаруживает структуры и добавляет их в список открытий игрока. Система работает циклично, проверяя положение игроков каждые 5 секунд по умолчанию, чтобы точно фиксировать момент входа в структуру.

Связанные материалы

• Plasmo Voice — похожий мод

Автор: fella_guy · Лицензия: MIT