Mod Menu

Mod Menu - это очень полезный мод для Майнкрафт, который добавляет в игру отдельное меню со списком всех установленных модов. Если мод поддерживает экран настроек, через Mod Menu можно быстро открыть его конфиг прямо из игры, без лишней возни с файлами и папками.

По факту, это один из тех проектов, которые почти всегда ставят в сборки модов на Fabric или Quilt. Особенно если у вас не 5-10 модов, а нормальная такая сборка, где уже сложно сходу понять, что установлено, где чьи настройки и какой мод вообще за что отвечает. В обычном Minecraft такой системы нет, а Mod Menu закрывает эту проблему очень аккуратно и удобно.

Что делает Mod Menu

С этим модом для Minecraft вы получаете:

• список всех установленных модов в одном окне
• быстрый доступ к экранам конфигурации, если они поддерживаются конкретным модом
• отображение названий и описаний модов с поддержкой перевода
• поддержку форматирования текста в описаниях через /mod/placeholder-api
• скрытие библиотек из основного списка обычных модов
• встроенную проверку обновлений для модов, размещённых на Modrinth или имеющих собственный источник обновлений
• гибкую настройку функций самого Mod Menu

Если коротко, Mod Menu делает управление модами в Майнкрафт намного удобнее. Игровой процесс напрямую он не меняет, новых блоков и мобов не добавляет, но сильно улучшает интерфейс и повседневный опыт игры с модами. А это, особенно в больших сборках, реально чувствуется.

Зачем нужен Mod Menu в Minecraft

Когда игрок ставит много модов на Fabric или Quilt, быстро появляется типичная проблема - список проектов растёт, настройки разбросаны, часть конфигов открывается в игре, часть лежит в файлах, а некоторые моды вообще сложно опознать без отдельной проверки. В такой ситуации Mod Menu становится почти базовым инструментом.

Он помогает:

• быстро посмотреть, какие моды установлены
• отделить обычные моды от библиотек-зависимостей
• перейти к настройкам без поиска по папкам
• понять, есть ли доступные обновления
• удобнее ориентироваться в сборке модов

Короче, если вы собираете клиент под себя, тестируете моды, настраиваете интерфейс или просто хотите держать всё под контролем, скачать мод Mod Menu для Майнкрафт - очень логичное решение.

Поддерживаемые платформы

Supported Platforms

Mod Menu доступен для:

• Fabric
• Quilt

Поддерживаются версии Minecraft: Java Edition 1.14 и новее.

То есть это клиентский мод для Майнкрафт, который особенно часто используют на версиях вроде Minecraft 1.20.1, 1.20.4, 1.21 и других актуальных релизах, если сборка работает на Fabric или Quilt.

Что меняется после установки

После установки Mod Menu в игре появляется удобный раздел с модами. Там можно открыть список установленных проектов, посмотреть их названия, краткие описания и, если автор предусмотрел такую возможность, сразу перейти к экрану настроек. Это сильно упрощает жизнь, когда нужно быстро подкрутить параметры производительности, интерфейса, графики или геймплея.

Особенно хорошо Mod Menu раскрывается в связке с другими клиентскими модами для Minecraft. Например, когда в сборке есть оптимизационные проекты, интерфейсные улучшения, миникарты, HUD-моды, библиотеки и конфигураторы. Без такого меню всё это превращается в кашу, а с ним уже появляется нормальная структура.

Дополнительные возможности

Mod Menu поддерживает не только базовый список модов, но и более продвинутые функции.

Переводимые названия и описания

Мод умеет работать с переводимыми именами, краткими описаниями и полными описаниями модов. Это удобно и для игроков, и для авторов сборок, потому что интерфейс становится понятнее, особенно если проект локализован.

Форматирование описаний через QuickText

Поддерживается форматирование текста в описаниях модов благодаря Patbox и API /mod/placeholder-api. Это позволяет показывать более аккуратные и читаемые описания прямо в интерфейсе списка модов.

Фильтрация библиотек

Одна из самых полезных фишек - Mod Menu умеет отделять библиотечные моды от обычных. Это важно, потому что в большой сборке модов нередко половина списка состоит из API, библиотек и служебных зависимостей, которые обычному игроку вообще не нужны для ежедневной навигации.

Проверка обновлений

Также в Mod Menu встроена проверка обновлений. Она работает для модов, размещённых на Modrinth, а также для тех, которые предоставляют собственные источники обновлений. Если для файла найдена более новая версия под ваш загрузчик и версию Minecraft, мод покажет уведомление.

Глубокая настройка

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

Для кого этот мод особенно полезен

Mod Menu особенно пригодится, если вы:

• играете с большим количеством модов
• собираете собственную сборку модов для Minecraft
• часто меняете конфиги и тестируете настройки
• используете Fabric или Quilt
• хотите быстро понимать, что именно установлено в клиенте
• ищете удобный способ открыть конфиг мода прямо из игры

Если у вас ванильный Minecraft без модов, очевидно, он не нужен. Но если вы хотя бы немного сидите на Fabric-сборках, это почти must-have.

Возможности для разработчиков

У Mod Menu есть несколько API, которые помогают разработчикам сделать отображение своего мода более аккуратным и удобным. Поддерживаются языковые ключи, JSON-метаданные и Java API.

Ниже - важные технические детали, если вы делаете мод для Майнкрафт и хотите нормальную интеграцию с Mod Menu.

Translation API

С помощью Translation API можно перевести название мода, краткое описание и полное описание без изменений Java-кода. Достаточно добавить ключи перевода в нужном формате в любой язык, который вам нужен.

"modmenu.nameTranslation.modmenu": "Menu o' mods!",
"modmenu.descriptionTranslation.modmenu": "Menu o' mods ye installed matey!",
"modmenu.summaryTranslation.modmenu": "Menu o' mods ye installed matey!"

Fabric Metadata API

В Fabric Metadata API доступно несколько возможностей, которые можно добавить прямо через метаданные в fabric.mod.json.

Все эти параметры размещаются в отдельном блоке modmenu внутри custom. Ниже приведён пример с несколькими возможностями API:

fabric.mod.json

{
  ...
  "custom": {
    "modmenu": {
      "links": {
        "modmenu.discord": "https://discord.gg/jEGF5fb"
      },
      "badges": [ "library", "deprecated" ],
      "parent": {
        "id": "example-api",
        "name": "Example API",
        "description": "Modular example library",
        "icon": "assets/example-api-module-v1/parent_icon.png",
        "badges": [ "library" ]
      },
      "update_checker": true
    }
  }
}

"custom": {
    "modmenu": {
        "links": {
          "modmenu.discord": "https://discord.gg/jEGF5fb"
        }
    }
}

"custom": {
    "modmenu": {
        "parent": "flamingo"
    }
}

"custom": {
    "modmenu": {
        "parent": {
            "id": "this-mod-isnt-real",
            "name": "Fake Mod",
            "description": "Do cool stuff with this fake mod",
            "icon": "assets/real-mod/fake-mod-icon.png",
            "badges": [ "library" ]
        }
    }
}

"custom": {
    "modmenu": {
        "update_checker": false
    }
}

Quilt Metadata API

Так как Mod Menu работает и с Quilt, те же самые API из раздела Fabric Metadata API доступны и для Quilt-модов. Но формат пользовательских метаданных немного отличается.

Вместо блока "modmenu" внутри "custom", здесь "modmenu" размещается прямо в корневом объекте.

quilt.mod.json

{
  ...
  "modmenu": {
    // Здесь размещаются links, badges и прочие параметры
  }
}

Java API

Чтобы использовать Java API, нужно добавить Mod Menu как зависимость времени компиляции в ваш проект Gradle. Это не сделает Mod Menu обязательным для вашего мода, но он будет присутствовать в окружении для тестирования.

build.gradle

// Add the Terraformers maven repo to your repositories block
repositories {
  maven {
    name = "Terraformers"
    url = "https://maven.terraformersmc.com/"
  }
}

// Add Mod Menu as a dependency in your environment
dependencies {
  // Prior to Minecraft 26.x, use "modImplementation" instead
  implementation("com.terraformersmc:modmenu:${project.modmenu_version}")
}

После этого укажите версию Mod Menu в gradle.properties. Актуальный номер версии можно посмотреть на странице /mod/modmenu/version/latest, но для старых версий Minecraft может понадобиться другой релиз. Полный список версий есть на странице /mod/modmenu/versions.

gradle.properties

modmenu_version=VERSION_NUMBER_HERE

Если Mod Menu не нужен в тестовом окружении, но вы всё равно хотите компилировать мод с использованием Java API, можно применять modCompileOnly вместо modImplementation.

"entrypoints": {
  "modmenu": [ "com.example.mod.ExampleModMenuApiImpl" ]
}

@Override
public void attachModpackBadges(Consumer<String> consumer) {
	consumer.accept("modmenu"); // Indicates that 'modmenu' is part of the modpack
}

Screen createModsScreen(Screen previous)

Text createModsButtonText()

Что важно знать перед установкой

• Mod Menu работает на Fabric и Quilt
• Для Forge и NeoForge этот проект не предназначен
• Подходит для Minecraft Java Edition 1.14+
• Лучше всего ощущается в сборках модов, где много клиентских настроек
• Некоторые функции, вроде кнопок конфигурации, работают только если сам мод это поддерживает

Итог

Mod Menu - один из самых полезных клиентских модов для Minecraft, если вы играете с Fabric или Quilt. Он не добавляет контент в мир, зато делает работу с установленными модами в разы удобнее: показывает полный список, помогает быстро открыть настройки, отделяет библиотеки, поддерживает переводы и даже умеет проверять обновления.

Если вы собираете удобный клиент для Майнкрафт, ставите десятки модов или просто хотите навести порядок в интерфейсе, Mod Menu закрывает очень конкретную и частую проблему. В этом и его сила - штука вроде простая, но после установки без неё уже как-то неудобно.