Mоd Mеnu

Ось приклад перекладів Mod Menu піратською мовою. Щоб створити свій власний, просто замініть `modmenu` в кінці (НЕ той, що на початку) ключа перекладу на ідентифікатор вашого моду, наприклад `modmenu.descriptionTranslation.traverse`.

`en_pt.json`

```json

"modmenu.nameTranslation.modmenu": "Menu o' mods!",

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

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

```

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

#### Badges (`"badges": [ ]`)

Хоча значок `Client` додається автоматично до модів, встановлених лише на стороні клієнта (встановіть `"environment": "client"` у `fabric.mod.json`, щоб зробити це.), інші значки, такі як `Library` і `Deprecated`, потребують визначення тут.

Підтримувані значення:

• `library` - слід призначати модам, які є суто залежностями для інших модів, які не повинні відображатися користувачеві за замовчуванням, якщо вони їх не ввімкнуть.
• `deprecated` - слід призначати модам, які існують суто з міркувань сумісності, наприклад, старому модулю API тощо.

Будь-які інші будуть ігноруватися, і Mod Menu не підтримує додавання власних значків. Ви можете відкрити проблему тут, якщо у вас є вагомий випадок використання нового значка.

#### Links (`"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`) для будь-яких власних ключів.

#### Parents (`"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` (String)
• `name` (String)
• `description` (String)
• `icon` (String)
• `badges` (Array of Strings)

#### Disable update checker (`"update_checker": false`)

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

Ви можете вимкнути перевірку оновлень, встановивши для `update_checker` значення false у метаданих Mod Menu, як показано нижче:

`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" ]

}

```

Екрани конфігурації модів

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

Передбачуваний варіант використання цього - надання модами власних екранів конфігурації. Ідентифікатор моду екрана конфігурації автоматично визначається вихідним контейнером моду, з якого походить точка входу.

Надані екрани конфігурації

Моди також можуть надавати фабрики Screen, щоб надавати власні екрани конфігурації для відкриття за допомогою кнопок конфігурації для інших модів. Реалізуйте метод `getProvidedConfigScreenFactories` у вашій реалізації API для цього.

Передбачуваний варіант використання ... (обрізано)