Add mod documentation in seven languages

This commit is contained in:
cthangover committed 2026-10-29 09:26:03 +01:00
1 parent bcac9f027b
commit 364a0af3d1
20 files changed
+526 -8

No files matched your search

+74
View File
@@ -0,0 +1,74 @@
# Menu — главное меню, выбор игры, сохранения и настройки
Menu — первый экран, который вы видите: заглавное меню с кнопками **Играть**, **Загрузить**, **Настройки**, **Моды и коллекции** и **Выход**. Здесь можно выбрать одну из установленных игр, начать её или продолжить с того места, где остановились, загрузить сохранение, а также изменить язык, звук и настройки экрана. Другие моды могут добавлять сюда свои кнопки и страницы настроек.
Menu входит в оболочку, которая загружается всегда, поэтому оно на месте ещё до запуска любой игры.
![Главное меню: слева кнопки Play, Load, Settings, Mods & Collections и Exit, справа титульный арт Cthangover.](assets/main-menu.jpg)
## Запуск игры
Кнопка **Играть** открывает **Выбор игры**. Каждая игра из ваших коллекций — карточка с обложкой, описанием, готовностью к запуску и числом сохранений.
![Две карточки игр в разделе Choose a game: Cthangover и My Novel, у обеих «Ready to play» и «No saves», кнопки New game и Configure.](assets/game-picker.jpg)
- **Новая игра** запускает игру с её первой сцены. Меню переключается на набор модов этой игры в том же окне — без перезапуска.
- **Продолжить** на карточке продолжает последнее сохранение этой игры; **Сохранения** открывает их список.
- **Установить недостающее** появляется, когда игре нужны моды, которых у вас нет, и скачивает их.
- **Настроить** открывает схему игры в менеджере модов.
Пока вы смотрите на меню, моды игр готовятся в фоне; подсказка внизу сообщит, когда запуск будет быстрым.
Кнопка **Продолжить** в самом главном меню появляется после первой же игры: она возвращает в последнюю игру и сохранение, которыми вы пользовались.
## Загрузка сохранения
Кнопка **Загрузить** показывает сохранения одной игры за раз; выберите игру в списке сверху и щёлкните сохранение, чтобы загрузить его.
![Окно загрузки для My Novel с одним сохранением «Day 1, 00:00» и подсказкой «Click a save to load it».](assets/load.jpg)
Если состав модов игры изменился с момента сохранения, окно **Состав игры изменился** перечислит, что добавилось (начнёт с нуля), что убралось (его данные сохранятся и вернутся, если включить снова) и что обновилось, а перед загрузкой сделает резервную копию сохранения. Сохранения, сделанные ещё до появления игр, показываются в группе **Сохранения без игры**; вы выбираете, к какой игре они относятся, и файл переезжает туда.
Внутри игры сохранение и загрузка идут через то же окно в игровом меню: щёлкните слот, чтобы сохранить; занятый слот перезаписывается после подтверждения; **+ Новое сохранение** добавляет ещё один.
## Настройки
В **Настройках** четыре вкладки. Изменения применяются и сохраняются сразу.
- **Основное** — язык интерфейса.
- **Звук** — включение и громкость звуков, музыки и эмбиента.
- **Экран** — режим окна (в окне, на весь экран, без рамки или эксклюзивный полный экран), монитор, размер окна, V-Sync и ограничение частоты кадров, плюс **Сбросить настройки экрана**.
- **Моды** — страницы настроек, которые добавляют установленные моды, с кнопкой **Сбросить настройки**.
![Вкладка настроек экрана: режим окна, монитор, размер окна, V-Sync и ограничение частоты кадров.](assets/settings-display.jpg)
![Вкладка «Моды»: собственная страница мода Menu с «Data of disabled mechanics» и кнопкой Purge.](assets/settings-mods.jpg)
Собственная страница Menu на вкладке **Моды** — это **Данные отключённых механик → Очистить**: кнопка удаляет из всех сохранений данные модов, которые больше не входят в игры. Пользуйтесь ею, только когда уверены: включённая снова механика начнёт с нуля.
## От чего зависит Menu
Menu рисует экраны и решает, что делает каждая кнопка. Список игр и их готовность приходят из коллекций; запуском, переключением и сохранением игр занимаются игровая сессия и службы сохранений движка; музыка титульного экрана — это плейлист `MainMenu` из Music Pack, которого Menu требует. Раздел **Моды и коллекции** поставляет Mod Manager.
## Авторам модов: добавить кнопку или страницу настроек
Кнопки берутся из реестра, а не с жёстко заданного экрана, поэтому мод может добавлять, заменять и переставлять их. Mod Manager добавляет свою кнопку записью `main_menu` в манифесте:
```json
"main_menu": [
{
"id": "mods_hub",
"scene_path": "scenes/mods_hub_screen.tscn",
"button": { "icon": "mod_manager", "locale": "mod_manager/menu_title", "index": 100 }
}
]
```
Настройки мода появляются на вкладке **Моды**, когда мод регистрирует описания настроек в реестре настроек модов, — так Menu поступает со своим действием «Очистить». Тексты кнопок и настроек берутся из локализации самого мода.
## Если что-то пошло не так
1. **Под «Играть» нет игр.** Не установлена и не включена ни одна коллекция типа «игра»; откройте **Моды и коллекции**.
2. **На карточке игры «Не хватает модов» или «Несовместимые версии».** Нажмите **Установить недостающее** или **Настроить**, чтобы посмотреть, в чём дело.
3. **Нет кнопки «Продолжить».** Она появляется после того, как вы поиграли хотя бы раз.
4. **Окно не сохраняет размер.** Проверьте **Экран → Режим окна**; размер окна применяется только в оконном режиме.