Гайд по тегам стран и ID локаций в EU5

Вот ошибка, на которую натыкается почти каждый. Консоль открыта, команда настоящая, вы ввели её аккуратно — и ничего не происходит, или консоль выдаёт ошибку. С командой всё в порядке. Неверна цель. Вы передали имя страны там, где нужен тег, или тег страны там, где нужен ID локации, или экранное название религии там, где нужен внутренний ключ конфессии. EU5 строго к этому относится, и поначалу это кажется недружелюбным, пока не поймёте замысел: игра не разбирает ваши намерения — она сопоставляет точную внутреннюю строку со своими данными.

Эта страница даёт ментальную модель, после которой любая команда и любой мод-файл становятся предсказуемыми. Сначала — две системы идентификаторов и одно правило, которое управляет обеими. Затем — что такое теги стран и ID локаций на самом деле и где они хранятся. Затем — практический навык, заменяющий зубрёжку: как считать любой идентификатор из живой игры за секунды. Далее — справочник команд, разбор моддинга и алгоритм отладки на случай, если цель всё равно не принимается.

Две системы идентификаторов, одно правило

EU5 ведёт два параллельных реестра имён, и они никогда не пересекаются. Запомните это разделение — и остальная часть статьи станет просто деталями.

Теги стран обозначают государства. Каждая страна на карте — играбельная, высвобождаемая или формируемая — имеет короткий буквенный код. Франция — FRA, Австрия — HAB. Эти коды потребляют команды, нацеленные на государство: смена играемой страны, аннексия соперника, объявление войны, принуждение к личной унии или указание ИИ забыть свои планы. Если команда действует на кого, ей нужен тег страны.

Идентификаторы локаций обозначают места. Каждая клетка карты — то, что EU5 называет локацией, а игроки EU4 помнят как провинцию, — имеет собственный идентификатор. Он существует в двух формах, указывающих на одну и ту же клетку. ID локации — число, форма для консоли: population 7273 10000 или win_siege 1219. Ключ локации — строчное текстовое имя, форма для файлов данных. Если команда действует на где, ей нужен идентификатор локации.

Теперь правило, объясняющее каждую непонятную ошибку. Движок сопоставляет внутренние имена, а не отображаемые. Текст, который игра рисует на экране, — «Франция», «Католицизм», «Ренессанс» — это слой локализации поверх настоящих данных. Команды и скрипты обращаются к слою под ним. Поэтому:

• Вы вводите tag FRA, а не tag France. Тег — настоящее имя; «Франция» — лишь обёртка.
• Команда религии требует внутренний ключ конфессии, поэтому religion bon работает, а religion buddhist сразу выдаёт ошибку: «Buddhist» — экранная надпись, bon — ключ, определённый в данных.
• Ключи локаций — обычные строчные слова, потому что так их именуют файлы карты, вне зависимости от того, как подсказка провинции называет их на вашем языке.

Из этого вытекают ещё два принципа, которые стоит усвоить сразу.

Идентификаторы считывают, а не запоминают. Набор тего стран велик, ID локаций исчисляются тысячами, и оба растут с добавлением контента. Никто не держит их в голове. Навык в том, чтобы знать, где каждый из них напечатан — оверлей отладки для тегов, отладочная подсказка для ID локаций, папки данных для внутренних ключей — и находить его за пять секунд. Любой гайд, дающий гигантский статический список, — это удобство, а не урок.

Идентичность определяется один раз и используется везде. Тег страны объявляется в записи настройки страны, и все остальные системы — цвета на карте, локализация, дипломатия — привязаны к этому одному коду. Идентичность локации — это её имя, привязанное к уникальному цвету в определениях карты; и иерархия, и шаблон местности, и население ссылаются на это имя. Когда что-то ломается, вы почти всегда возвращаетесь к единственной точке определения. Знать, где эта точка, важнее, чем знать любое конкретное значение.

Теги стран: что это и где они хранятся

Тег страны — компактный буквенный код: три символа для подавляющего большинства ванильных стран и до пяти, когда моддер хочет новый тег, который невозможно спутать с существующим. Три буквы — краткость; пять букв — дистанция от ванильного пула, чтобы модовая страна с тегом DOWNT никогда не столкнулась с shipped-страной вроде BTI. Теги пишутся заглавными по соглашению и не содержат пробелов или подчёркиваний.

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

Где страна живёт в данных — на случай, если нужно заглянуть под капот:

Файл / папка	Что хранит для страны
main_menu/setup/start/10_countries	Запись старта / закладки: тип правительства, столица (строчный ключ локации), принадлежащие и коренные локации, открытые регионы.
in_game/setup/countries/	Внутриигровые определения стран, разбитые по региональным файлам. Новый тег нужно добавить и сюда, и в стартовый файл выше — это отдельные системы.
map/colors	Цвет страны на карте, опционально как именованное значение RGB, на которое можно ссылаться по имени.
main_menu/localization/<language>/	Отображаемое имя в игре. Это обёртка; тег под ней — то, что использует движок.

Несколько тегов стоит узнавать в лицо, потому что они постоянно встречаются в примерах и других гайдах. Воспринимайте это как подсказку для чтения, а не список для заучивания — оверлей отладки даст вам авторитетный тег любой страны в вашем сейве.

Тег	Страна	Тег	Страна
FRA	Франция	HAB	Австрия (Габсбурги)
CAS	Кастилия	ENG	Англия
TUR	Османы	POR	Португалия
ARA	Арагон	NAP	Неаполь
VEN	Венеция	BYZ	Византия
POL	Польша	SWE	Швеция

ID локаций и ключи локаций: настоящие имена карты

Начнём с поправки в терминологии, которая экономит больше всего путаницы: EU5 называет клетки карты локациями, а не провинциями. «Провинция» в игре по-прежнему существует, но теперь это группировочный ярлык на уровень выше, наряду с областью, регионом, субконтинентом и континентом. Это названия уровней иерархии, а не самой клетки. Когда ветеран EU4 говорит «ID провинции», он обычно имеет в виду то, что EU5 называет ID локации — и числа у двух игр не совпадают, потому что EU5 построила новую карту.

Иерархия от клетки вверх выглядит так:

локация → провинция → область → регион → субконтинент → континент

Локация — атомарная единица, к которой вы приближаетесь и на которую кликаете. Локации объединяются в провинцию, провинции — в область, области — в регион и так далее. Одни команды и эффекты нацелены на одну локацию; другие — на целую провинцию, область или регион. Знать, какой уровень ожидает команда, — половина правильного использования: завоевать провинцию и оккупировать локацию — не одно и то же.

Каждая локация несёт свою идентичность в двух связанных формах. ID локации — число, которое используют консоль и отладочная подсказка; аргумент для команд вроде population, win_siege и core. Ключ локации — строчное текстовое имя из файлов данных; в мод-файлах это имя привязано один-к-одному к уникальному hex-цвету. Закрасьте область карты определённым цветом, привяжите этот цвет к имени в определениях — и движок разрешит цвет под курсором в это имя, а затем во всё привязанное к нему: местность, климат, население. Цвет — мост между картинкой карты и данными за ней.

Поэтому у локаций больше движущихся частей, чем у стран, и моддеры относятся к привязке «имя + цвет» как к святыне: нарушите её — и движок не сможет сопоставить закрашенный пиксель с определением. Для игрока практический вывод проще: вы почти всегда будете использовать числовой ID локации, считывать его из подсказки и никогда не трогать ключ, если не редактируете файлы.

Как считать любой идентификатор прямо в игре

Этот раздел заменяет любой статический список, который вы когда-либо найдёте. Оба идентификатора печатает сама игра, когда включён режим отладки, и их считывание занимает секунды.

Включите режим отладки. Это параметр запуска Steam, а не внутриигровая настройка: кликните правой кнопкой по игре в библиотеке, откройте «Свойства» и добавьте флаг режима отладки в «Параметры запуска». Проверка, что всё получилось, — клавиша консоли (клавиша слева от 1) теперь открывает консоль. Если консоль не открывается, флаг не активен; гайд по настройке режима отладки разбирает точное написание флага и частые причины, по которым он не срабатывает.

Считайте тег страны. С активным режимом отладки наведите курсор на любую страну на карте. Оверлей отладки отрисовывает метаданные государства, и одна из строк гласит tag = FRA (или какой там код). Это значение вы и подставляете в команды для стран. Никаких списков, никаких справочников — страна сама называет своё имя.

Считайте ID локации. Здесь нужен второй переключатель. Откройте «Настройки», перейдите в «Интерфейс» и включите Map Tooltips. Теперь приблизьтесь и наведите на провинцию: отладочная подсказка рисует фиолетовый оверлей, включающий числовой ID локации и дополнительные данные региона. Это число — аргумент для команд локации. Если видите фиолетовую рамку, но без ID, подсказки всё ещё выключены.

Обнаружьте сами команды. Список команд тоже не нужно учить наизусть. Введите helplog в консоли, и игра запишет полный актуальный справочник команд в текстовый файл внутри папки Europa Universalis V в «Документах». Этот файл — авторитетный список для вашей конкретной сборки, куда надёжнее любого скриншота или вики-страницы, потому что его генерирует та самая игра, которую вы запустили. Автодополнение по Tab в консоли — быстрый способ проверить написание команды и ожидаемый аргумент прямо во время ввода.

Весь рабочий процесс — это цикл: наведите, чтобы считать идентификатор; проверьте ожидаемый аргумент команды через help или helplog; введите команду с только что считанным идентификатором. Когда этот цикл станет мышечной памятью, вы перестанете зависеть от любого гайда, включая этот.

Какие команды какой аргумент принимают

Держа в голове две системы, список команд перестаёт быть стеной и сам сортируется в две колонки: команды, действующие на кого, принимают тег страны; команды, действующие на где, принимают идентификатор локации. Третья небольшая группа требует внутренний ключ данных.

Команда	Тип аргумента	Пример	Что делает
tag	Тег страны	tag FRA	Сменить играемую страну.
nex	Тег страны	nex HAB	Аннексировать страну (территория приходит интегрированной, но не полностью коренной).
war	Тег страны	war MVA	Объявить войну государству напрямую.
waronplayer	Тег страны	waronplayer HAL	Заставить ИИ-страну объявить войну вам.
form_union	Тег страны	form_union FRA	Создать личную унию с вами как старшим партнёром.
add_favor	Тег страны + количество	add_favor FRA 50	Сделать так, чтобы страна была вам должна услуги.
clear_ai_objectives	Тег страны	clear_ai_objectives FRA	Заставить ИИ забыть свои планы и пересчитать их.
population	ID локации + значение	population 7273 10000	Добавить население локации (значение в тысячах).
win_siege	ID локации	win_siege 1219	Мгновенно выиграть активную осаду в локации.
core	ID локации	core 1219	Сделать локацию коренной.
weather	Имя локации + тип	weather Grimby tornado	Создать погодное событие в локации.
religion	Внутренний ключ конфессии	religion bon	Сменить религию по ключу из файла данных, а не по экранному имени.
add_institution_progress	Ключ института + локация + %	Ренессанс + локация + 100	Запустить или продвинуть институт в локации.

Две привычки уберегут вас от проблем. Первая: когда команда не срабатывает, подозревайте тип аргумента раньше, чем саму команду — команда для страны, получившая ID локации, молча проваливается или выдаёт непонятную ошибку, и решение — просто считать правильный идентификатор. Вторая: следите за масштабом числовых аргументов — population считает в тысячах, так что значение 1 означает тысячу человек, а некоторые параметры упираются в потолок вместо буквального сложения: стабильность, например, достигает максимума и игнорирует всё, что вы накидываете сверх него. Когда число ведёт себя странно, ответ — в поведении самой игры, а не в фиксированной таблице; проверьте на одноразовом сейве.

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

Теги и ID в моддинге

Если вы добавляете контент, а не просто вводите команды, те же идентификаторы становятся тем, что вы определяете, а не считываете. Рабочий метод непритязателен, и в нём весь секрет: моддинг EU5 — это по большей части копирование рабочего примера и переименование. Найдите ванильную страну или локацию, похожую на желаемую, скопируйте её записи из каждого файла, где она упоминается, и подправьте. Не нужно понимать всю систему до начала — нужен один правильный шаблон и дисциплина менять идентификатор последовательно везде, где он встречается.

Добавление тега страны. Скопируйте запись настройки похожей страны и пройдитесь по четырём точкам касания: внутриигровой файл страны, стартовый файл / файл закладки, цвет на карте и запись локализации. Три правила предотвращают классические ошибки:

• Переименовывайте файлы мода; сохраняйте имена папок. Файл мода, чей путь и имя совпадают с ванильным файлом, полностью заменяет его, молча удаляя ванильную страну и ломая совместимость с другими модами. Имена папок, напротив, должны точно повторять ванильные. Файлы гибки; папки структурны.
• Обновляйте оба места настройки. Стартовый файл и внутриигровой файл страны — отдельные системы. Добавьте тег только в один — и страна появится наполовину сформированной. Пока вы в стартовой записи, замените столицу и список принадлежащих локаций скопированной страны на свои — оставив локации исходной страны, вы отдадите новой нации чужие земли.
• Никогда не набирайте код тега вручную. Копируйте и вставляйте его между файлами каждый раз. Переставленная буква не выдаёт ошибки и создаёт страну, которая тихо работает неправильно, а отлаживать это — мучение. Это самый повторяемый совет в моддинге стран не просто так.

Добавление локаций. Новой локации нужно имя, привязанное к уникальному цвету, а затем горстка файлов, висящих на этом имени: файл определений, встраивающий её в иерархию «континент → провинция», шаблон местности / климата и запись населения. Минимум, чтобы игра распознала и отрисовала локацию, — около трёх файлов; население, культура и ресурсы добавляются поверх. Два жёстких правила:

• Изображение карты должно быть попиксельно точным. Парсер считает каждый отдельный цвет, каждый прозрачный пиксель и каждый мягкий сглаженный край отдельной локацией. Рисуйте жёстким карандашом на полной непрозрачности плоскими сплошными цветами, экспортируйте как 8-битный RGB без альфа-канала и без leftover-слоёв, иначе игра породит сотни фантомных локаций — или вообще не запустится.
• Имена — чистый ASCII. Символ с диакритикой или спецсимвол в имени локации мгновенно крашит EU5. EU4 прощала это пробелом; EU5 — нет. Держите имена строчными и без диакритики, а красивое отображение прописывайте через локализацию позже.

Управляющая философия: сначала заставить игру работать, потом наводить красоту. Скопируйте заглушки климата, населения и ресурсов, чтобы локация загрузилась, убедитесь, что она появляется на карте, и только затем уточняйте детали. Когда лог ошибок называет сломанную локацию, её имя соответствует цвету в определениях — нарисуйте этот цвет в редакторе изображений, выделите по цвету, и проблемные пиксели подсветятся. Этот цикл превращает «игра крашнулась» в «вот лишний пиксель здесь» меньше чем за минуту.

Почему тег или ID не срабатывает и как это чинить

Когда цель не принимается, причина почти всегда из короткого списка. Пройдитесь по нему, прежде чем решать, что команда сломана.

Неверный тип аргумента. Самая частая ошибка. Вы дали команде для страны ID локации, или команде для локации тег страны, или ввели отображаемое имя страны там, где нужен тег. Перечитайте подсказку, определите, кого или что ожидает команда, и подставьте соответствующий идентификатор.

Экранное имя вместо внутреннего ключа. Движок сопоставляет настоящий ключ данных, а не экранную надпись. religion buddhist не работает; religion bon работает. То же для институтов и других данных из файлов — рабочий ключ живёт в папках common, и вы открываете нужный файл, чтобы прочитать его, а не угадывать английское слово.

Опечатка при ручном вводе. Если вы набрали тег или ключ вместо копирования, один переставленный символ пройдёт без ошибки и просто ничему не будет соответствовать. Скопируйте идентификатор заново из подсказки или файла и вставьте.

Страна ещё не существует. У формируемых и высвобождаемых стран есть теги, но тег страны, которой сейчас нет на карте, не на что нацелить. Сначала сформируйте или высвободите страну, затем считайте её тег из живого оверлея.

Команда изменилась между сборками. Имена команд, точный синтаксис и числовые потолки меняются между обновлениями, так что команда, работавшая в прошлогоднем видео, может быть переименована или переработана. Именно поэтому helplog так важен: он выводит список команд для той сборки, которую вы запустили, и вы сверяетесь с реальностью, а не с гайдом. Сами идентификаторы — теги и ID локаций — стабильные данные; команды, которые их потребляют, — изменчивая часть.

Цикл отладки, который решает почти всё: считайте идентификатор из отладочной подсказки, а не из памяти; подтвердите команду и её ожидаемый аргумент через help или helplog; для крашей мода пройдите по логу ошибок к названной локации, сопоставьте имя с цветом и выделите по цвету, чтобы найти битые пиксели. Если сама консоль не открывается или команда всё равно отказывается, гайд по неработающим консольным командам разбирает ошибки настройки, которые стоят выше любого идентификатора.

Частые вопросы

Что почитать дальше

• Как включить режим отладки в EU5 — точный флаг запуска и решения, когда консоль не открывается.
• Список консольных команд и читов EU5 — полный каталог команд, в который подставляются эти идентификаторы.
• Консольные команды EU5 не работают — устранение ошибок настройки, стоящих выше любой цели.
• Лучшие стартовые страны EU5 — примените тег страны в рекомендованной первой кампании.
• Гайд для новичков EU5: первые 50 лет — стартовый чек-лист для любой страны.
• Гайд по тегам стран HOI4 — та же концепция в Hearts of Iron 4, если вы играете в разные тайтлы Paradox.
• Гайд по ID из отладочной подсказки Stellaris и Список ID Stellaris — считывание идентификаторов из игры в Stellaris.