---
title: Игровой старт и фон главного меню
summary: Что настраивают gamestarts.xml и startmenu.xml, и где начинается MD-логика старта.
section: galaxy
kind: guide
status: reference
updated: 2026-10-27
tags: ["gamestarts","startmenu","userdata","новая игра"]
sources: ["https://chemodun.github.io/x4/modding-support/anatomy-of-game-data/libraries/gamestarts-xml/","https://chemodun.github.io/x4/modding-support/anatomy-of-game-data/libraries/startmenu-xml/"]
---
## Два разных файла


`libraries/gamestarts.xml` описывает варианты новой игры: запись в меню, размещение и имущество игрока, вселенную и ограничения. `libraries/startmenu.xml` задаёт фоновые сцены главного меню. Ни один из них не заменяет MD-сценарий миссии.



Схема стартов - `libraries/gamestarts.xsd`. Порядок дочерних элементов значим. Картинка записи, preview cutscene и intro имеют разные роли; наличие красивого preview не создаёт стартовый корабль.



## Учебная правка стартовых денег


Файл патча - `libraries/gamestarts.xml` вашего расширения:



```xml
<diff>
  <replace sel="/gamestarts/gamestart[@id='wiki_training_start']/player/@money">25000</replace>
</diff>
```



**Предпосылка:** вы уже добавили полноценный старт `wiki_training_start` с прямым дочерним `player` и атрибутом `money`. Это вымышленный ID, не существующий старт базовой игры.



**Ожидается:** определение этого старта получит `money="25000"`. При новой игре оно задаёт стартовые средства; патч не начисляет деньги персонажу в уже загруженном сохранении. Для собственного старта отдельно нужны корректные ссылки на место, персонажа, корабль и необходимые ресурсы.



## Переход к MD


ID выбранного старта доступен в MD как `player.module`. Условия конкретного старта не должны запускать его вводную миссию во всех новых играх. Сначала проверьте ID, затем момент готовности мира и защиту от повторной инициализации при загрузке.



Настройки `universe` могут отключать `jobs` и `god`. Поэтому отсутствие кораблей в учебном мире не всегда является ошибкой квоты. Для стартов с собственным набором данных проверьте [jobs и god](wiki:jobs-and-god).



## Фон и разблокировка


Новая сцена добавляется под `/startmenu/background`, а её `cutscene` служит ключом. Нужны существующие сцена и ресурсы; одна запись в списке недостаточна. Замена общего default-фона может конфликтовать с DLC и другими модами.



Условия `userdata` относятся к профилю игрока и могут действовать между разными сохранениями. Проверяйте заблокированный старт или фон на отдельном профиле, а не только на давно используемом.



## Сценарий проверки


Откройте меню новой игры, выберите старт, затем начните новую игру и независимо прочитайте имущество. Отдельно загрузите старый сейв. Для фона проверьте выбор сцены в настройках главного меню. Примеры здесь не запускались в X4; полный набор ресурсов сцены не распространяется. Далее: [журнал](wiki:debugging), [сохранение MD](wiki:md-persistence).