Mod Menu

Вот пример перевода Mod Menu на пиратский язык. Чтобы создать свой собственный, просто замените `modmenu` в конце (*).НЕ* (тот, что в начале) ключа перевода с вашим собственным ID мода, например, `modmenu.descriptionTranslation.traverse`.

`en_pt.json` ```json "modmenu.nameTranslation.modmenu": "Меню модов!", "modmenu.descriptionTranslation.modmenu": "Меню модов, которые вы установили, приятель!", "modmenu.summaryTranslation.modmenu": "Меню модов, которые вы установили, приятель!" ```

> Перевод краткого описания здесь излишен и не нужен, поскольку он совпадает с описанием, но он был включен, чтобы показать, что вы можете переводить краткое описание (короткое описание мода в одном предложении) отдельно от описания, даже на английском языке!

Значки (`"значки": [ ]`)

В то время как значок `Client` добавляется автоматически к модам, настроенным только для клиентской стороны (для этого установите `"environment": "client"` в файле `fabric.mod.json`), другие значки, такие как `Library` и `Deprecated`, требуют определения здесь.

Поддерживаемые значения: - `library` - следует присваивать модам, которые являются исключительно зависимостями для других модов и не должны отображаться пользователю по умолчанию, если он не включит их. - `deprecated` - следует присваивать модам, которые существуют исключительно по причинам совместимости со старыми версиями, например, старый модуль API и т.п.

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

Ссылки (`"links": { }`)

Объект `links` позволяет авторам модов добавлять пользовательские гиперссылки в конец описания. Если вы укажете контакт `sources` в официальных метаданных `fabric.mod.json`, он также будет включен в раздел ссылок.

Любой ключ из объекта `links` будет включен в раздел ссылок, при этом ключ будет использоваться в качестве ключа перевода. Например, такой:

`fabric.mod.json` ```json "custom": { "modmenu": { "links": { "modmenu.discord": "https://discord.gg/jEGF5fb" } } } ``` будет отображаться как ссылка с текстом "Discord", поскольку "Discord" — это английский перевод "modmenu.discord", предоставленный Mod Menu.

Mod Menu предоставляет несколько стандартных переводов, которые можно использовать для ссылок. Полный список можно посмотреть в языковом файле Mod Menu здесь. Все стандартные ключи перевода ссылок имеют вид `modmenu. `.

Вы также можете предоставить собственные переводы, если хотите добавить пользовательские ссылки. Обязательно используйте *ваше собственное пространство имен* (в отличие от `modmenu`) для любых пользовательских клавиш.

Родители (`"parent": "mod_id" or { }`)

Родительские элементы используются для отображения одного мода как дочернего по отношению к другому. Это предназначено для модов, разделенных на разные модули. Следующий элемент в файле `fabric.mod.json` определит мод как дочерний по отношению к моду 'flamingo':

`fabric.mod.json` ```json "custom": { "modmenu": { "parent": "flamingo" } } ```

Однако, если вы хотите сгруппировать моды под родительским элементом, но этот родительский элемент на самом деле не является модом, вы тоже можете это сделать. В приведенном ниже примере мод определяет метаданные для родительского элемента. Убедитесь, что эти метаданные включены во все дочерние элементы, использующие фиктивный/поддельный родительский элемент. Это также можно использовать в качестве запасного варианта для необязательного родительского элемента; если он присутствует, он будет заменен реальными метаданными мода.

`fabric.mod.json` ```json "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" ] } } } ```

Модификации родительского класса, созданные с помощью фиктивных файлов, поддерживают только следующие метаданные: - `id` (строка) - `name` (строка) - `description` (строка) - `icon` (строка) - `badges` (массив строк)

Отключить проверку обновлений (`"update_checker": false`)

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

Вы можете отключить проверку обновлений, установив параметр `update_checker` в значение false в метаданных вашего меню модов следующим образом:

`fabric.mod.json` ```json "custom": { "modmenu": { "update_checker": false } } ```

Первые шаги

Для использования API реализуйте интерфейс ModMenuApi в классе и добавьте его в качестве точки входа типа "modmenu" в ваш файл `fabric.mod.json` следующим образом:

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

Экраны конфигурации модов

Моды могут предоставлять фабрику экранов для создания пользовательского экрана конфигурации, который открывается с помощью кнопки конфигурации. Для этого реализуйте метод `getModConfigScreenFactory` в вашей реализации API.

Предполагается, что это позволит модам предоставлять собственные экраны конфигурации. Идентификатор мода на экране конфигурации определяется автоматически на основе исходного контейнера модов, из которого возникла точка входа.

Предоставленные экраны конфигурации

Моды могут предоставлять фабрики экранов для создания пользовательских экранов конфигурации, которые будут открываться вместе с кнопками конфигурации для других модов. Для этого реализуйте метод `getProvidedConfigScreenFactories` в вашей реализации API.

Предполагается, что это пригодится таким модам, как Cloth Config, для предоставления экранов конфигурации для модов, использующих его API.

Значки модпака

Моды могут присваивать другим модам значок `Modpack`, используя метод `attachModpackBadges`, например, следующим образом:

```java @Override public void attachModpackBadges(Consumer consumer) { consumer.accept("modmenu"); // Указывает, что 'modmenu' является частью модпака } ```

Обратите внимание, что «внутренние» моды, такие как сам Minecraft и загрузчик модов, не могут получить значок модпака, поскольку они не распространяются в рамках типичного модпака.

Статические вспомогательные методы

`ModMenuApi` также предлагает несколько вспомогательных методов для модов, которые хотят лучше взаимодействовать с Mod Menu, например, создавать собственные кнопки для модов.

Создание экземпляра экрана «Моды».

Вы можете вызвать этот метод, чтобы получить экземпляр экрана «Моды»: ```java Screen createModsScreen(Screen previous) ```

Создание текста кнопки «Модераторы»

Вы можете вызвать этот метод, чтобы получить текст, который будет отображаться на кнопке меню модов: ```java Text createModsButtonText() ```