Руководство по модам Pre-Warp Age
Создайте первый мод, разберите его устройство и добавьте в игру собственные технологии, постройки и события.
Найти слово в справочнике
1. С чего начать
Руководство описывает Pre-Warp Age 1.0.24 beta. Для модов выпущенной 1.0.23 выберите её руководство в переключателе версий.
Мод хранится в отдельной папке. В неё можно записать новую цену разведки, собственную технологию или целую корпорацию. Там же хранятся ваши тексты, изображения и звуки. Программировать на C# для этого не нужно: правила мода записываются в текстовых файлах JSON.
Начните с раздела «Первый мод»: вы создадите два файла и проверите изменение в игре. Затем в «Основах» разберём, что означает каждая часть записи, а в «Рецептах» добавим новый контент. Подробный справочник находится в конце руководства. К нему удобно обращаться за конкретным правилом, когда вы уже знаете, что хотите сделать.
Язык правил игры называется Nexus. Он позволяет сочетать существующие возможности: например, технология может увеличить добычу, открыть постройку или дать доход. Если задуманный механизм вообще не предусмотрен движком, одного мода с JSON будет недостаточно. Потребуется доработка самой игры.
Моды доступны в полной компьютерной игре. В демоверсии они отключены. При включённых модах или изменённых файлах Vanilla официальные достижения не выдаются.
2. Первый мод
Сделаем разведку дешевле. Для этого зададим ей базовую цену в один минерал. Нужны только два файла; изображения и переводы пока не понадобятся. Если хотите сначала проверить готовый вариант, скачайте ZIP «Быстрая разведка» в начале страницы.
В главном меню игры откройте Играть → Моды → Папка модов. Всегда открывается одна папка Modding, независимо от выбранного мода. Откройте в ней Local, создайте папку quick-survey, а внутри неё — Logic. Должна получиться такая структура:
Modding/
Local/
quick-survey/
modinfo.json
Logic/
Explore.jsonПервый файл, quick-survey/modinfo.json, содержит название и версию мода. Скопируйте в него весь следующий блок:
{
"id": "quick-survey",
"version": "1.0.0",
"title": "Быстрая разведка",
"description": "Снижает базовую цену разведки до одного минерала."
}Второй файл, quick-survey/Logic/Explore.json, меняет цену. Его содержимое:
[
["Explore", "Cost.Minerals", 1]
]Внутренняя строка читается так: «Базовая цена разведки Explore в минералах равна 1». Квадратные скобки снаружи собирают записи файла в список. Пока запись одна; ниже мы разберём, как добавлять другие.
- Сохраните оба файла как JSON в UTF-8. Если распаковываете готовый архив, проверьте, что modinfo.json находится прямо в Modding/Local/quick-survey, а не ещё на один уровень глубже.
- Вернитесь на экран модов и включите «Быстрая разведка». Закройте экран: игра перечитает файлы и обновит меню новой партии.
- Создайте новую партию. Выберите сценарий «G-система», режим «Казуал» и корпорацию «Добытчики». Обучающую «Солнечную систему» пока пропустите: обучение ограничивает доступные действия.
- Выберите неразведанное тело и наведите указатель на действие разведки. Проверьте цену в подсказке. В моде задана база 1; надбавка за удалённость и другие действующие модификаторы могут увеличить или уменьшить итоговую цену.
Теперь замените 1 на 2 в Explore.json. Откройте и закройте экран модов и создайте новую партию: база станет равна двум минералам. Для точного сравнения используйте то же зерно, сценарий, корпорацию и то же тело. Меняется база цены; дальность до тела остаётся прежней.
Уже начатая партия продолжает использовать прежние данные, даже если файлы мода изменились. Пункт «Начать заново» также сохраняет набор текущей партии. Чтобы проверить правку, нужна новая партия из обновлённого меню. Если игра сообщает об ошибке файла, сначала исправьте её и повторно откройте и закройте экран модов.
3. Основы языка фактов
3.1. Субъект, предикат и значение
["Explore", "Cost.Minerals", 1]Разберём знакомую цену разведки. Здесь три части: Explore - разведка, Cost.Minerals - её цена в минералах, 1 - новая базовая цена. Вся строка означает: «Разведка стоит один минерал до скидок и надбавок». Запись из трёх частей называется триплетом.
- Субъект - о чём говорится: Explore.
- Предикат - какое свойство задаём: Cost.Minerals.
- Значение - сколько оно составляет: 1. В литературе эту третью часть также называют объектом триплета.
Субъект и предикат всегда записываются строками. Значение бывает числом, строкой или true/false. Строка может быть текстом, ключом перевода, именем варианта или ссылкой на сущность. Её смысл определяет конкретное поле, а не кавычки. Идентификаторы чувствительны к регистру: Tech и tech не одно слово.
Одна запись и целый файл - разные вещи. Выше мы рассматривали одну запись. Вот готовый файл Logic/Explore.json с этой записью; его можно скопировать целиком:
[
["Explore", "Cost.Minerals", 1]
]Теперь изменим ещё и базовую цену аванпоста. Замените содержимое того же файла следующим. В нём уже две записи:
[
["Explore", "Cost.Minerals", 1],
["Outpost", "Cost.Minerals", 8]
]Разведка получила базовую цену 1, аванпост - 8. Посмотрите на конец первой записи: там появилась запятая, которая отделяет её от второй. После второй запятой нет. Самые верхняя и нижняя скобки ограничивают весь список записей файла.
Дальше в справочнике будут встречаться короткие фрагменты - только новые записи, без остального содержимого файла. Их назначение будет указано перед кодом. Полные файлы, как два примера выше, всегда показаны целиком.
Explore, Cost, Is и Tech уже известны игре. Имя собственной технологии, например SurveyScience, выбираете вы. Новое имя можно использовать слева, чтобы описать объект, но нельзя произвольно поставить его на место предиката. Объявление собственных слов разбирается в статье «Predicate»; для первых модов хватит существующих свойств.
Для собственных имён в первых модах удобно брать латинские буквы и при необходимости цифры: SurveyScience, MyMiner2. Выбирайте уникальные имена без пробелов, отличные от существующих. Точка, подчёркивание и двоеточие имеют специальное назначение: точка отделяет часть определения, подчёркивание используется в именах экземпляров, двоеточие - в адресах ячеек карты. Не включайте их в имя самостоятельного определения. Ключи перевода также удобно составлять из латинских букв; видимые игроку названия пишутся по-русски в словаре.
3.2. Определения, экземпляры и наследование
В файлах мода обычно описывают вид объекта: технологию, корпорацию, постройку или мир. Это определение. Во время партии игра создаёт по нему конкретные объекты - экземпляры. Например, описание технологии общее, а её исследованность у каждого игрока своя. Имена экземплярам назначает игра; переносить случайное имя вроде SurveyScience_0 из сохранения в мод не нужно.
[
["MyMiner", "Is", "CorpMiner"],
["MyMiner", "Name", "MyMinerName"]
]Этот фрагмент описывает новую корпорацию MyMiner на основе существующей CorpMiner. Первая строка даёт ей свойства добытчиков, вторая меняет название. Получение свойств другого определения называется наследованием. Неуказанные свойства остаются как у CorpMiner; собственное значение, например Name, заменяет унаследованное.
Теперь возьмём свойства двух готовых корпораций. В этом отдельном примере у MyHybrid нет собственного Name. Полный файл Logic/MyHybrid.json:
[
["MyHybrid", "Is", "CorpMiner"],
["MyHybrid", "Is", "CorpColonist"]
]Унаследуются свойства обоих родителей. Но оба родителя задают Name. Для такого совпадения побеждает первый в списке: здесь название будет как у добытчиков. Поменяйте две строки местами - приоритет получит Name колонистов. Собственный Name у MyHybrid, если его добавить, будет сильнее обоих родителей.
Наследование подготавливается при создании партии. Поэтому после правки файла создавайте новую партию; смена Is у живого объекта не копирует заново все свойства. Цепочки наследования не должны замыкаться: нельзя сделать MyMiner потомком CorpMiner, а CorpMiner - потомком MyMiner.
Мы использовали Is для получения свойств родителя. Отдельное поле Type решает другую задачу - выбирает обозначение типа в подсказке. Различимый пример выбора показан в статье «Type - обозначение типа объекта»; заменой одного Type свойства родителя не наследуются.
3.3. Составной предикат и подсубъект
Точка встретится нам в разных местах записи. Сначала рассмотрим её в свойстве, затем - в имени описываемого объекта. Это два разных случая.
В знакомой цене разведки Cost означает стоимость, а Minerals уточняет ресурс оплаты:
["Explore", "Cost.Minerals", 1]Cost.Minerals целиком занимает второе место триплета. Это составной предикат: одно свойство записано несколькими словами через точку. Если бы мы задавали цену энергией, свойство называлось бы Cost.Energy. Точка здесь уточняет, какую именно стоимость мы описываем.
Подсубъект позволяет изолировать одно поведение субъекта от других. Например, корпорация может получать один бонус при большом запасе денег, а другой - независимо от запаса. У каждого такого поведения будут свои условия и эффекты. Условие одной части не должно включать или выключать соседнюю часть. Так подсубъекты позволяют задать поведение для разных ситуаций и состояний одного субъекта.
Посмотрим, как это записывается. У корпорации магнатов CorpMagnate есть процентный доход от запаса кредитов. Он описан в подсубъекте CorpMagnate.Interest: CorpMagnate - субъект, Interest - имя отдельного поведения. Interest придумал автор; само это слово не начисляет проценты и не задаёт условие.
Сначала укажем, по какому количеству считать доход этой части. Ниже одна запись из определения корпорации:
["CorpMagnate.Interest", "Per", "Credits"]Per Credits означает «за каждый кредит в запасе игрока этой корпорации». Пока размер дохода не задан. Эта строка выбирает количество, но ничего сама не выдаёт.
Следующая запись задаёт размер дохода - 0,03 кредита за ход за единицу выбранного количества:
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]Adds.Income.Credits означает прибавку к доходу кредитов за ход. Вместе две записи дают правило процентного дохода. Их нужно читать как одну часть определения:
["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]При запасе 100 кредитов эта часть добавит 100 × 0,03 = 3 кредита дохода за ход до остальных модификаторов. Обе строки относятся к CorpMagnate.Interest. Пока условия нет: процентный доход рассчитывается при любом запасе. Подсубъект не обязан быть условным.
Теперь изменим правило для учебного примера: пусть проценты начисляются только при запасе не меньше 100 кредитов. Добавим условие именно в Interest:
["CorpMagnate.Interest", "Requires.Has.Credits.Min", 100]Requires.Has.Credits.Min 100 проверяет, что у игрока в запасе хотя бы 100 кредитов. При запасе 50 эта часть не даёт дохода; при 100 даёт 3, при 200 - 6. Условие относится к процентному доходу Interest, а не ко всем способностям корпорации.
Добавим второе поведение: постоянную выплату 2 кредита за ход. Для неё выделим другой подсубъект, Support:
["CorpMagnate.Support", "Adds.Income.Credits", 2]У Support нет своего условия и расчёта за каждый кредит: это постоянные +2. Условие и Per из Interest на него не распространяются. При запасе 50 выплата Support остаётся равной 2, хотя Interest выключен. При запасе 100 обе части работают: 3 кредита процентного дохода плюс 2 постоянной выплаты дают прибавку 5 кредитов за ход. Вместе разобранные записи выглядят так:
["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03],
["CorpMagnate.Interest", "Requires.Has.Credits.Min", 100],
["CorpMagnate.Support", "Adds.Income.Credits", 2]Interest и Support - имена, выбранные автором. Смысл каждой части задают её Requires, Per и Adds. Эти слова языка нужно отличать от авторских имён. Правила добавления и замены уже существующих частей отдельно разобраны в статье Is.
Сравните два места точки: в Cost.Minerals она находится во втором элементе и уточняет свойство; в CorpMagnate.Interest - в первом и отделяет имя части от имени корпорации. Обращение к связанному объекту через точку - ещё один случай; его отдельно разберём на условии по владельцу в статье «Источник условий и корректировка параметра». Произвольная цепочка знакомых слов не создаёт новое правило.
3.4. Роли, ресурсы и эффекты
Создадим технологию «Научная разведка». Сначала объявим, что SurveyScience - технология. SurveyScience - наше имя, Tech - известная игре категория:
["SurveyScience", "Is", "Tech"]Is Tech даёт объекту поведение технологии: её можно исследовать. Категорию с таким поведением будем называть ролью. Building обозначает постройку, Event - событие, Corporation - корпорацию. Готовые категории и определения перечислены в статье Is.
Теперь включим технологию в дерево игрока:
["Player", "Has", "SurveyScience"]Player Has SurveyScience означает, что технология входит в набор игрока. После создания партии она будет в его дереве, но ещё не будет исследована. Has здесь не выдаёт бонус.
Зададим сам бонус - одну науку за ход после исследования:
["SurveyScience", "Adds.Income.Science", 1]Income.Science - доход науки за ход. Adds увеличивает его на указанное число. Эту прибавку получит игрок, изучивший SurveyScience. Если его доход был 2, после исследования он станет 3 при отсутствии других изменений. Заменив 1 на 2, мы получим прибавку 2 за ход.
Дадим технологии название:
["SurveyScience", "Name", "SurveyScienceName"]Name указывает ключ строки. По SurveyScienceName игра найдёт русское название в словаре Text/ruRU.json. Этот словарь показан ниже вместе с готовым Logic-файлом. SurveyScience обозначает саму технологию, а SurveyScienceName - строку её названия.
Для картинки выберем уже существующую иконку колбы:
["SurveyScience", "Icon", "flask"]Icon flask использует готовое изображение игры. Свой PNG для этого примера не нужен. Наконец, укажем первый ярус дерева:
["SurveyScience", "Tier", 1]Tier отвечает за расположение узла. Число 1 помещает его в первый ярус; цену и требование предшествующей технологии эта строка не задаёт.
Теперь соберём разобранные строки вместе. В папке мода из первого примера создайте Logic/Technology.json. Полное содержимое файла:
[
["SurveyScience", "Is", "Tech"],
["SurveyScience", "Name", "SurveyScienceName"],
["SurveyScience", "Tier", 1],
["SurveyScience", "Icon", "flask"],
["SurveyScience", "Adds.Income.Science", 1],
["Player", "Has", "SurveyScience"]
]В корне мода создайте папку Text, а в ней файл ruRU.json. Если такой файл уже есть, добавьте ключ в его существующий словарь; второй внешний объект в JSON создавать нельзя. Для нового файла содержимое целиком такое:
{
"SurveyScienceName": "Научная разведка"
}Откройте и закройте экран модов, создайте новую партию и откройте окно технологий. Найдите «Научную разведку» в первом ярусе. До исследования доход науки не изменён; после исследования он увеличится на единицу за ход. Цена исследования определяется настройками Research в основной игре, поэтому в примере её нет. Если заменить 1 на 2 в Adds.Income.Science и начать новую партию с перечитанным модом, изучение даст уже две единицы за ход.
Здесь мы изменили доход за ход. Сравнить его с запасом и добычей одним рабочим можно в статьях Income, Count и Production. Там каждая величина разобрана на своём примере.
В рецепте постройки ниже встретится Income.Science без Adds. У готовой постройки это её собственный доход, который игра учитывает в экономике владельца. У технологии мы записали Adds.Income.Science - прибавку к доходу игрока после исследования. Эти записи выполняют разные задачи. Нельзя убрать Adds из технологии или дописать его к постройке, рассчитывая сохранить тот же результат.
В Logic задавайте правила и начальные данные мода. Не копируйте туда содержимое сохранения партии: текущие запасы, уже разыгранные карты, результаты действий и другие изменения во время игры движок хранит сам. Нужные для продолжения партии служебные записи не являются настройками мода.
4. Небольшие рецепты
Дальше - несколько самостоятельных изменений. Выберите нужный рецепт и добавьте его файлы в мод из первого примера. Все пути отсчитываются от папки мода. Для каждого полного файла показаны внешние скобки; отдельные строки помечены как фрагменты. Названия новых объектов собраны в подразделе «Тексты примеров». Числа здесь выбраны для обучения, а не как рекомендация по балансу.
4.1. Цена и баланс
Сохраним две цены в одном файле. Замените содержимое Logic/Explore.json целиком следующим массивом. Новое имя файла не требуется:
[
["Explore", "Cost.Minerals", 1],
["Outpost", "Cost.Minerals", 8]
]База разведки станет равна одному минералу, база аванпоста - восьми. Между записями стоит запятая, после последней её нет. Остальные свойства аванпоста, включая требования и срок, сохраняются. Итоговую цену по-прежнему меняют действующие скидки и надбавки. Проверьте её в новой партии в подсказке разведки или строительства аванпоста.
4.2. Корпорация
Добавим отдельную корпорацию с возможностями добытчиков и своим названием. Создайте Logic/Corporation.json:
[
["MyMiner", "Is", "CorpMiner"],
["MyMiner", "Name", "MyMinerName"],
["MyMiner", "Description", "MyMinerDesc"],
["MyMiner", "Order", 10]
]MyMiner - наше имя нового определения; CorpMiner - существующее определение добытчиков. Через Is новая корпорация получает их способности и изображение. Name и Description заменяют название и описание; Order влияет на место карточки в списке. Добавьте MyMinerName и MyMinerDesc из «Текстов примеров» в Text/ruRU.json.
Перечитайте мод через экран модов и начните создание новой партии. Среди корпораций появится «Мои добытчики»; исходные «Добытчики» также останутся. Выберите новую карточку: она должна показывать унаследованные способности. Для корпорации с собственным набором способностей вместо Is CorpMiner используется Is Corporation, а нужные эффекты задаются отдельно.
4.3. Технология
В разделе «Роли, ресурсы и эффекты» мы добавили SurveyScience без предшественника. Теперь сделаем её продолжением существующей технологии OutpostConstruction - в русском интерфейсе она называется «Строительство аванпостов». Замените Logic/Technology.json из того примера целиком:
[
["SurveyScience", "Is", "Tech"],
["SurveyScience", "Name", "SurveyScienceName"],
["SurveyScience", "Tier", 2],
["SurveyScience", "Icon", "flask"],
["SurveyScience", "Requires", "OutpostConstruction"],
["SurveyScience", "Adds.Income.Science", 1],
["Player", "Has", "SurveyScience"]
]Словарь названий остаётся прежним. Requires запрещает исследование до изучения OutpostConstruction. Tier 2 переносит узел во второй ярус дерева; один Tier такого запрета не создаёт. Перечитайте мод и начните новую партию. До изучения предшественника исследование «Научной разведки» недоступно; после него станет доступно. После изучения самой «Научной разведки» доход науки вырастет на единицу за ход. Tier и Order задают расположение, а не цену исследования.
4.4. Постройка
Создадим научный вариант аванпоста. Ему нужны обычные условия строительства аванпоста, но он дополнительно приносит науку. Полный файл Logic/Building.json:
[
["SurveyOutpost", "Is", "Outpost"],
["SurveyOutpost", "Name", "SurveyOutpostName"],
["SurveyOutpost", "Description", "SurveyOutpostDesc"],
["SurveyOutpost", "Income.Science", 1]
]Через Is Outpost наследуются роль постройки, требования технологии и места, цена, срок и содержание аванпоста. Собственный Income.Science добавляет доход науки готовой постройке. Для имён нужны ключи SurveyOutpostName и SurveyOutpostDesc в Text/ruRU.json из подраздела «Тексты примеров».
В новой партии исследуйте «Строительство аванпостов» (OutpostConstruction) и разведайте подходящий каменистый мир, который допускает обычный аванпост. Выберите его и найдите действие строительства «Научного аванпоста». Если ресурсов хватает, постройте его. В режиме «Казуал» строительство мгновенное, в режиме с длительными задачами дождитесь завершения. После постройки в доходе появится одна наука за ход; содержание энергией остаётся как у обычного аванпоста. Исчерпание энергии может нарушить работу постройки.
В собственном определении с нуля одного Is Building недостаточно: нужно также задать, где строить, что требуется, сколько платить и что получится. Этим вопросам посвящена статья «Building, Project, Upgrade» справочника. В данном рецепте эти сведения берутся у Outpost.
4.5. Событие
Создадим событие, которое один раз добавит минералы в запас игрока, и проверим его на втором ходу. Сначала зададим количество минералов, затем назначим момент события. После проверки включим его в случайный выбор. Выполняйте шаги по порядку.
Событие и награда минералами
Событие назовём SurveyGift. Одна запись объявляет, что это событие:
["SurveyGift", "Is", "Event"]Как и у технологии, Is задаёт роль. Но Event означает происшествие с результатом, а не исследуемый узел. Теперь зададим его результат:
["SurveyGift", "Adds.Minerals.Scaled", 1]Эта строка задаёт разовую награду минералами. Её количество рассчитывается через Scaled с коэффициентом 1.
Замените коэффициент 1 на 2. Например, при масштабе 10 событие добавит 20 минералов вместо 10.
Оформление Name, Description и Icon уже знакомо по технологии. Соберём определение события в полный файл Logic/Event.json:
[
["SurveyGift", "Is", "Event"],
["SurveyGift", "Name", "SurveyGiftName"],
["SurveyGift", "Description", "SurveyGiftDesc"],
["SurveyGift", "Icon", "ore_iron"],
["SurveyGift", "Adds.Minerals.Scaled", 1]
]Добавьте SurveyGiftName и SurveyGiftDesc из «Текстов примеров» в Text/ruRU.json. Событие теперь описано, но время его срабатывания ещё не назначено. Одно подключение мода не выдаёт награду.
Запуск на известном ходу
Игровые события разыгрываются из групп. Создадим проверочную группу SurveyGiftCheck:
["SurveyGiftCheck", "Is", "Events"]Events - группа, из которой игра будет выбирать событие; Event из предыдущего шага - само событие. В нашу группу включим только одну карту:
["SurveyGiftCheck", "Deck.SurveyGift", 1]Deck.SurveyGift включает одну карту SurveyGift. Других карт в этой группе нет, поэтому при розыгрыше будет выбрана именно она. Осталось назначить розыгрыш:
["SurveyGiftCheck", "Turn.Starts", 2]Turn.Starts 2 означает второй ход партии. Это не срок ожидания в два хода от установки мода. Все три разобранные записи образуют полный файл Logic/EventCheck.json:
[
["SurveyGiftCheck", "Is", "Events"],
["SurveyGiftCheck", "Deck.SurveyGift", 1],
["SurveyGiftCheck", "Turn.Starts", 2]
]Игра находит такие группы по Is Events, дополнительная связь для включения не нужна. Перечитайте мод и начните новую G-систему в режиме «Казуал». Завершите первый ход: на втором появится событие «Дополнительные минералы», и запас увеличится на величину награды. При 10 работниках без завершённых технологий и коэффициенте 1 это 10 минералов. При другом населении или числе исследований количество изменится. На третьем ходу эта проверочная группа снова награду не выдаст.
Выбор из нескольких карт
Теперь изменим только состав знакомой группы. Возьмём готовое событие SuppliesScience из основной игры: оно один раз добавляет науку игроку. Если в EventCheck.json добавить его карту, получится:
[
["SurveyGiftCheck", "Is", "Events"],
["SurveyGiftCheck", "Deck.SurveyGift", 1],
["SurveyGiftCheck", "Deck.SuppliesScience", 1],
["SurveyGiftCheck", "Turn.Starts", 2]
]При первом розыгрыше выбирается одно из двух событий: SurveyGift с наградой минералами или SuppliesScience с наградой наукой. Шансы равны, потому что каждой карты по одному экземпляру. Оба события сразу этот розыгрыш не запускает.
Измените только число у Deck.SurveyGift с 1 на 2. В колоде будет две карты SurveyGift и одна SuppliesScience. Вероятность события с минералами в первом розыгрыше станет 2 из 3. Количество минералов в награде не изменится: за него отвечает Adds.Minerals.Scaled в Event.json, а не число карт.
Для обычной игры вместо проверки на втором ходу добавим SurveyGift в уже существующую группу RandomEvents. Полный отдельный Logic/RandomGift.json:
[
["RandomEvents", "Deck.SurveyGift", 1]
]После этого уберите EventCheck.json из Logic, перечитайте мод и создайте новую партию. Останутся Event.json и RandomGift.json. Теперь SurveyGift участвует в обычном случайном выборе вместе с другими событиями и не обязано появиться на втором ходу. Определение события и его награда остались прежними.
Расчёт награды
Формулы, настройки и округление описаны в разделе Scaled.
4.6. Сценарий
Сделаем собственный вариант G-системы. Сначала выберем готовую основу:
["SurveySystem", "Is", "ScenarioG"]SurveySystem получает параметры ScenarioG. Но определение карточки и создание звезды - разные части задачи. Для настоящего центра карты нужна своя запись:
["SurveySystem", "Orbit.Center", "ClassG"]Она выбирает ClassG - жёлтую звезду. Если заменить только ClassG на ClassK, в центре появится оранжевая звезда K. Параметры, унаследованные от ScenarioG, от этой замены сами по себе не превращаются в параметры ScenarioK.
Теперь добавим уже знакомые название и описание карточки; Order задаст её место в списке. Полный Logic/Scenario.json:
[
["SurveySystem", "Is", "ScenarioG"],
["SurveySystem", "Name", "SurveySystemName"],
["SurveySystem", "Description", "SurveySystemDesc"],
["SurveySystem", "Orbit.Center", "ClassG"],
["SurveySystem", "Order", 10]
]SurveySystem - имя нового сценария. Он наследует параметры ScenarioG, а Name и Description задают собственные подписи карточки. Добавьте SurveySystemName и SurveySystemDesc в Text/ruRU.json. После перечитывания мода найдите «Мою жёлтую звезду» при выборе сценария новой партии. После выбора в центре системы должна оказаться звезда класса G.
Сравните два изменения файла. Замена собственного Orbit.Center ClassG на ClassK меняет создаваемую звезду на K. Удаление всей собственной строки Orbit.Center - другой результат: описание сценария ещё может видеть ClassG у предка, но сама звезда G в этом примере не создастся. Поэтому для рабочего нового сценария оставляйте явную запись центра.
Если захотите изменить стартовые ресурсы, учтите правило наследования частей. В этом рецепте ресурсы берутся из родительской Start. Собственная SurveySystem.Start заменит эту часть целиком: в ней нужно перечислить все нужные стартовые запасы, а не только изменённый. Подробности - в статье Is.
Для первых сценариев удобнее брать за основу случайную систему. «Солнечная система» содержит авторскую карту и обучение: её нельзя считать пустым шаблоном с другим названием звезды.
4.7. Тексты примеров
Для рецептов с новыми названиями нужен словарь Text/ruRU.json. Ниже он приведён целиком для всех примеров раздела. Можно оставить только ключи выбранного рецепта. Если словарь уже существует, добавляйте ключи внутрь его скобок через запятую; не дописывайте второй словарь после закрывающей скобки.
{
"SurveyScienceName": "Научная разведка",
"MyMinerName": "Мои добытчики",
"MyMinerDesc": "Корпорация на основе добытчиков.",
"SurveyOutpostName": "Научный аванпост",
"SurveyOutpostDesc": "Аванпост с дополнительным доходом науки.",
"SurveyGiftName": "Дополнительные минералы",
"SurveyGiftDesc": "Событие добавляет минералы в ваш запас.",
"SurveySystemName": "Моя жёлтая звезда",
"SurveySystemDesc": "Сценарий на основе жёлтой звезды."
}Слева стоят ключи, которые мы указали в Name и Description, справа - фразы, видимые игроку. Фразы можно переписать, сохранив ключи. Чтобы переименовать сам ключ, нужно также заменить все ссылки на него в правилах мода.
5. Файлы и установка
Откройте Играть → Моды → Папка модов. В одной папке Modding собраны ссылки на Vanilla — файлы основной игры, Local — ваши локальные моды, и Workshop-<itemId> — каждый скачанный мод Steam. Это ссылки на настоящие каталоги, а не копии файлов. Поместите папку своего мода в Local.
Modding/
Vanilla/
Local/
quick-survey/
modinfo.json
Logic/
Explore.json
Text/ (если нужны переводы)
Art/ (если нужны изображения)
Sounds/ (если нужны звуки)
preview.png (превью для Workshop)
Workshop-<itemId>/В modinfo.json записываются сведения о моде, а в Logic - изменения правил. Добавляйте Text, Art и Sounds, когда понадобятся свои тексты, изображения или звуки. Имена JSON-файлов внутри Logic выбираете вы: игра находит описанные объекты по именам в самих записях. Например, цену Explore можно изменить и в Explore.json, и в Prices.json.
Сохраняйте JSON в кодировке UTF-8. В нём нельзя оставлять комментарии и запятую после последнего элемента. Проверьте расширение файла: Explore.json.txt будет обычным текстовым файлом и не загрузится как правило игры.
Все JSON-файлы внутри Logic, включая подпапки, читаются по порядку их относительных путей. Например, 10-base.json читается раньше 20-prices.json. Сравнение точное, с учётом регистра, а не по алфавиту языка интерфейса. Используйте латинские имена в нижнем регистре и числовые префиксы, если порядок важен. При повторной записи одного поля поздний файл может заменить значения раннего. Порядок строк внутри каждого файла сохраняется.
Чтобы посмотреть данные основной игры, откройте Играть → Моды → Папка модов → Vanilla. В ней Logic содержит правила, Text — тексты, Art — изображения, Sounds — звуки и музыку. Открывайте JSON обычным текстовым редактором, PNG — просмотрщиком изображений, OGG — проигрывателем.
В Logic файлы разделены по темам: Corporations.json - корпорации, Techs.json - технологии, Builds.json - постройки, Events.json - события, Scenarios.json - сценарии, Map.json - миры. Используйте их как примеры. Собственные изменения храните в моде, чтобы обновление игры их не заменило.
Vanilla используйте как образец для чтения. Файлы установленной игры не редактируйте: нужные записи переносите в собственную папку мода. Например, чтобы изменить цену из Vanilla/Logic/Simulation.json, запишите новую цену в Modding/Local/quick-survey/Logic/Explore.json, как в первом моде. После правки откройте и закройте экран модов, затем создайте новую партию. Каталоги Workshop-<itemId> появляются для скачанных подписок; itemId — номер предмета Steam Workshop. Их обновляет Steam. Для своей версии скопируйте папку подписки в Local и задайте собственный id в modinfo.json; удалите секцию workshop чужой публикации. Публикуйте свою локальную копию, а не редактируйте файлы подписки.
5.1. Манифест modinfo.json
Этот файл описывает мод для списка модов и Workshop. Его полный образец находится в разделе «Первый мод». Для нового мода замените id, title и description своими значениями; версию можно начать с 1.0.0.
- id - уникальный идентификатор мода, например quick-survey. Начинается с маленькой латинской буквы; далее допустимы маленькие латинские буквы, цифры и дефис. Сохраняйте id при обновлениях.
- version - версия мода из трёх чисел. Начните с 1.0.0, при обновлении содержимого увеличивайте номер.
- title и description - название и краткое описание, которые увидит игрок.
Поля workshop создаёт оболочка при публикации. Не заполняйте чужой itemId или SteamID вручную. Идентификатор vanilla зарезервирован для основной игры.
5.2. Тексты
Чтобы изменить текст или добавить новый, создайте Text/ruRU.json. Это словарь: слева уникальный ключ, справа видимая игроку фраза.
{
"MyMinerName": "Мои добытчики",
"MyMinerDesc": "Корпорация исследователей недр."
}В правилах Name указывает ключ названия, а Description - ключ описания. Например, запись ниже связывает объект MyMiner со строкой MyMinerName. При русском языке игрок увидит «Мои добытчики». MyMiner и MyMinerName - разные имена: первое обозначает корпорацию, второе помогает найти её название в словаре.
["MyMiner", "Name", "MyMinerName"]В Text/ruRU.json достаточно нужных вам ключей. Чтобы заменить существующий текст, возьмите его ключ из словаря основной игры. Пишите обычный текст без HTML и цветовых тегов. Если в исходной строке есть подстановки {0}, {1}, сохраните их: во время игры вместо них появятся числа или названия.
Для каждого языка создавайте отдельный файл с точным именем из списка ниже. В имени нет дефиса: ruRU.json, а не ru-RU.json. Добавлять все языки сразу не требуется.
- ruRU.json - русский
- enUS.json - английский
- ukUA.json - украинский
- deDE.json - немецкий
- frFR.json - французский
- esES.json - испанский
- itIT.json - итальянский
- ptBR.json - португальский, Бразилия
- plPL.json - польский
- csCZ.json - чешский
- roRO.json - румынский
- trTR.json - турецкий
- jaJP.json - японский
- koKR.json - корейский
- zhCN.json - китайский, упрощённое письмо
- zhTW.json - китайский, традиционное письмо
- arSA.json - арабский
- hiIN.json - хинди
- idID.json - индонезийский
- thTH.json - тайский
- viVN.json - вьетнамский
Для выбранного языка игра объединяет тексты основной игры и включённых модов. Строка позднего мода заменяет тот же ключ раннего. Если вы не перевели существующий ключ, остаётся его перевод из игры или другого мода. Если ключа вообще нет в выбранном языке, игра ищет его в английском enUS. Если нет и там, вместо фразы показывается сам ключ. Поэтому для новых строк полезно добавить Text/enUS.json. Русский перевод не подставляется автоматически вместо отсутствующего английского.
5.3. Изображения
Изображения PNG находятся в Art. Для замены используйте имя файла исходной картинки: например, Art/logo.png заменит логотип. Другие изображения останутся прежними. Внутренние подпапки помогают разложить файлы по темам, но при поиске иконки важно её имя без расширения.
Для новой иконки создайте Art/Icons/my_survey.png и запишите ["MyMiner", "Icon", "my_survey"]. Используйте PNG с прозрачным фоном и уникальным именем: два разных файла my_survey.png в разных подпапках не являются двумя независимыми иконками. Размер PNG не фиксирован движком. Для обычной иконки удобно начать с квадрата 256 × 256 пикселей. Расширение .png в Icon не пишется.
preview.png в корне папки мода - отдельное изображение для списка модов и Workshop. Оно не заменяет игровые иконки.
5.4. Звуки и музыка
Сначала заменим звук одного действия. Сохраните свой звук в формате OGG как Sounds/FX/my_scan.ogg внутри мода. Полный Logic/ExploreSound.json:
[
["Explore", "Sound", "my_scan"]
]Разведка будет использовать my_scan.ogg. В Sound пишется имя без расширения .ogg. Выбирайте уникальное имя: два my_scan.ogg в разных подпапках не станут двумя независимыми звуками. Если взять имя звука основной игры, файл заменит его и в других местах, где используется то же имя.
Теперь отдельно зададим фоновую музыку. Добавьте свой файл Sounds/Music/my_theme.ogg. Полный Logic/Music.json с одной дорожкой:
[
["Simulation", "Music", "my_theme"]
]Music у Simulation задаёт музыкальный список партии. В этом варианте в нём одна композиция my_theme.ogg. Sound у Explore относился только к разведке; Music относится к фону всей партии. Варианты звуков и дополнительные настройки разобраны в статье «Sound и Music».
Music может содержать несколько дорожек. Чтобы заменить весь список двумя существующими композициями игры, создайте Logic/Music.json с этим содержимым. Дополнительные OGG-файлы для примера не нужны.
{
"set": [
["Simulation", "Music", "interstellar_waltz"],
["Simulation", "Music", "molten_core"]
]
}Обе строки относятся к одной паре Simulation + Music. set заменяет прежний список всеми указанными значениями сразу, в записанном порядке. Пишите весь новый список в одном файле: если разнести дорожки по двум файлам, поздний файл заменит список раннего. Для своих композиций замените имена и добавьте соответствующие OGG в Sounds.
6. Если модов несколько
Мод меняет только то, что вы в нём указали. В примере выше изменится цена разведки, остальные правила игры сохранятся. Не копируйте весь файл основной игры ради одной цены.
Если два мода меняют одну цену, действует значение из загруженного последним мода. При необходимости задайте необязательное поле order в modinfo.json: большее число означает более позднюю загрузку. Зависимости requires и несовместимости conflicts перечисляются как id других модов. Для первого мода эти поля не нужны.
Если в локальной папке и среди загрузок Workshop есть моды с одним id, игра использует локальную папку. Отключение мода возвращает исходные правила в новых партиях. Само удаление строки из вашего мода ничего не удаляет из основной игры.
7. Workshop и сохранения
Локальный мод работает без Steam: его можно передать папкой или ZIP-архивом. Для установки из Workshop подпишитесь на пакет, дождитесь загрузки, затем вернитесь на экран модов. Подписка не перезаписывает вашу рабочую папку мода.
Для публикации войдите в Steam, откройте экран модов и выберите локальный авторский пакет. Проверьте название, описание, превью и version, затем нажмите «Опубликовать». Публикация не происходит автоматически при запуске. При первом размещении игра сохраняет сведения Workshop в modinfo.json. Обновление проверяет SteamID автора.
Перед публикацией изменённого содержимого увеличьте version вручную. Версия ниже уже опубликованной не принимается. Если Steam попросит принять соглашение Workshop, перейдите по ссылке, которую покажет игра. При ошибке обновления сохраните прежний itemId: он связывает мод с существующей публикацией. Замена на случайный номер не исправит ошибку.
Сохранение содержит упорядоченный список id, версии и отпечатки загруженных модов. Для загрузки должны совпадать id и их порядок. Изменение версии или отпечатка само по себе загрузке не мешает: можно обновлять баланс, тексты, изображения и поведение мода. Версия и отпечаток сохраняют сведения об использованном содержимом. Формат пакета и схема сохранённых данных по-прежнему должны поддерживаться; автоматического переноса между схемами нет.
Переключение модов и редактирование файлов не переписывает начатую партию. «Начать заново» использует закреплённый набор текущей сессии. Чтобы проверить новую версию, обновите экран модов и создайте новую партию из обновлённого меню.
8. Если мод не работает
- Мода нет в списке. Проверьте, что modinfo.json лежит непосредственно в папке мода, содержит правильный JSON и собственный id. Убедитесь, что расширение файла не стало .json.txt. Снова откройте экран модов и прочитайте сообщение об ошибке, если оно появилось.
- Правка не видна в игре. Убедитесь, что мод включён, затем закройте экран модов и создайте новую партию. Старую партию и «Начать заново» для этой проверки не используйте. Если включены другие моды, проверьте порядок: более поздний пакет может менять ту же цену или свойство.
- Игра сообщает об ошибке JSON. Откройте указанный файл и найдите позицию из сообщения. Проверьте парные скобки, кавычки вокруг строк и запятые между элементами. В каждой записи правила должны быть ровно три элемента.
- Неизвестный предикат. Проверьте вторую часть записи: регистр и все слова после точки должны совпадать с поддерживаемой формой из справочника. Собственное имя технологии допустимо слева, но не становится новым свойством только потому, что вы его придумали.
- Бонус не действует. Для технологии проверьте обе строки Is Tech и Player Has, затем исследуйте её в новой партии. Для условного бонуса проверьте, у какого объекта читается условие и выполнено ли оно. Не ожидайте разовой награды от записи, которая меняет доход за ход.
- Количество отличается от примера. Сначала уточните, что сравниваете: запас, выпуск одним рабочим или доход за ход. Затем проверьте скидки, надбавки, назначенных рабочих и условия. Уменьшение базовой цены не обязательно даёт такое же число в итоговой подсказке.
- Сохранение не открывается после обновления мода. Сверьте id и порядок модов с сообщением игры. Проверьте, что нужные пакеты загружены и что поддерживаются формат пакета и схема сохранения.
Если используете проверку данных и видите результат PARTIAL, это означает лишь отсутствие ошибок в тех правилах, которые проверяет валидатор. Он не доказывает, что любая комбинация слов поддерживается и даёт нужный эффект. Окончательная проверка мода - новая партия и выполнение изменённого действия.
Чтобы другой человек смог повторить ошибку, передайте ему папку мода, зерно партии, выбранные сценарий, режим и корпорацию. Опишите действие, ожидаемый результат и то, что получилось. Приложите полное сообщение об ошибке: имя файла и позиция в нём помогают найти причину.
9. Дополнительные возможности файлов
Этот раздел нужен, если мод зависит от других модов или должен удалить часть исходного определения. Для первого мода достаточно обычного массива фактов из раздела «Первый мод».
Необязательные поля modinfo.json
- enabled - true или false, включён ли мод при первом обнаружении. По умолчанию true. Последующий выбор игрока хранится отдельно.
- order - целое число, по умолчанию 0. Большее число означает более позднюю загрузку. При равенстве порядок задаёт id.
- requires - массив id модов, которые должны быть включены и загружены раньше этого мода. Например, ["my-library"]. Диапазоны версий не задаются.
- conflicts - массив id несовместимых модов. Если они включены вместе, игра исключит конфликтующие пакеты из загрузки и покажет причину на экране модов. Отключите один из них и закройте экран, чтобы перечитать оставшийся набор.
- titleKey и descriptionKey - ключи словаря Text для перевода названия и описания мода. Сначала ищется текущий язык, затем английский, затем обычные title и description.
- tags - массив строк для Workshop, например ["Corporation"]. Он не добавляет игровых свойств.
Поля workshop с itemId, account и author заполняются игрой при публикации. Они описывают публикацию и авторство. Не копируйте чужие значения для нового мода.
Как заменить, добавить или удалить запись
Начнём с уже знакомой цены. У основной игры есть свои сведения о разведке. Наш файл Logic/Explore.json меняет только её базовую цену в минералах:
[
["Explore", "Cost.Minerals", 1]
]Результат: для Explore свойство Cost.Minerals получает значение 1. Название, звук и другие свойства разведки сохраняются. Для замены одной цены не нужно копировать всё определение Explore.
Если удалить эту строку из мода, цена вернётся к значению основной игры в новой партии. Удаление нашей правки не удаляет исходную цену. Чтобы действительно убрать свойство, нужна отдельная операция remove; к ней вернёмся ниже.
Некоторые записи перечисляют состав. Например, Has добавляет технологию в набор игрока. В следующем файле предполагается, что SurveyScience уже описана, как в разделе 3.4:
[
["Player", "Has", "SurveyScience"]
]SurveyScience добавится к существующим технологиям. OutpostConstruction и остальные технологии останутся. Так же в обычном массиве дополняются Is и Blocks. Повтор в точности той же записи не создаёт второй одинаковый элемент.
Теперь разберём операции для более точных изменений. Первой будет set - задать весь новый набор значений свойства. Например, хотим оставить в музыкальном списке только две композиции. Полный файл Logic/Music.json:
{
"set": [
["Simulation", "Music", "interstellar_waltz"],
["Simulation", "Music", "molten_core"]
]
}После set список Music содержит именно эти две дорожки в этом порядке. Старые дорожки, которых здесь нет, в новом списке отсутствуют. Это отличие set от добавления: set заменяет весь список, а не приписывает строки к нему.
Следующая операция, add, дополняет список. Оставим Music.json из предыдущего примера и создадим ещё один файл - Logic/zz-more-music.json. Он загрузится позже Music.json:
{
"add": [
["Simulation", "Music", "interstellar_drift_1"]
]
}Теперь дорожек три: interstellar_waltz, molten_core и добавленная interstellar_drift_1. Первые две не исчезли. Все три композиции уже есть в игре, свои OGG для этого опыта не нужны.
Для следующего опыта отключите zz-more-music.json, убрав его из Logic, и создайте Logic/zz-remove-music.json. Удалим только molten_core из двух дорожек Music.json:
{
"remove": [
["Simulation", "Music", "molten_core"]
]
}Это remove с тремя элементами: он удаляет только точную запись. В списке останется interstellar_waltz. Если вместо этого нужно очистить всё свойство Music, укажите в remove только два элемента:
{
"remove": [
["Simulation", "Music"]
]
}Результат второго варианта - пустой список музыки. Не применяйте оба варианта одновременно: это два разных содержимых одного проверочного файла.
delete удаляет уже не свойство, а всё определение. Если вы создали MyMiner в рецепте «Корпорация» и хотите убрать именно её, полный файл Logic/zz-delete-corporation.json будет таким:
{
"delete": ["MyMiner"]
}В новой партии карточки MyMiner не будет; остальные корпорации сохранятся. Вместе с определением удаляются и его части с именами MyMiner.что-либо. Файл с zz в начале имени нужен здесь, чтобы удаление выполнилось после файла, который объявляет MyMiner.
Когда отдельные операции понятны, их можно соединить. Следующий полный Logic/Music.json сначала очищает Music, затем добавляет одну композицию:
{
"remove": [
["Simulation", "Music"]
],
"add": [
["Simulation", "Music", "interstellar_waltz"]
]
}В итоге остаётся только interstellar_waltz. Внутри одного такого файла порядок операций всегда один: delete → remove → set → add. Расположение этих ключей в тексте его не меняет. Применяются только перечисленные операции; остальные можно не указывать.
Значение false не удаляет запись: оно задаёт ложное значение. Для удаления используйте remove, а не false и не null. Значение null в триплетах не допускается.
Выполняйте эти опыты по очереди: несколько проверочных файлов одновременно изменят один музыкальный список. После изменения набора файлов перечитайте мод через экран модов и создайте новую партию. Обычную цену удобнее задавать массивом из первого примера; объект с операциями нужен, когда важны добавление, точное удаление или замена целого списка.
10. Справочник предикатов
Справочник сгруппирован по задачам: связи, условия, эффекты, экономика, события, миры и оформление. В начале страницы есть алфавитный указатель. Каждая статья описывает допустимые формы и результат. Рядом с примерами указано, где это полный файл, а где фрагмент определения. Поля состояния партии отмечены отдельно: их не нужно записывать в мод.
Is - принадлежность и наследование
Is сообщает, чем является объект. Начнём с новой технологии:
["SurveyScience", "Is", "Tech"]SurveyScience - придуманное имя, Tech - готовая категория технологий. Эта запись даёт объекту поведение технологии. Включение её в дерево игрока показано отдельно в разделе «Роли, ресурсы и эффекты».
Справа можно назвать и конкретное готовое определение. Тогда новая вещь получает его свойства. Следующий полный Logic/MyMiner.json создаёт разновидность добытчиков:
[
["MyMiner", "Is", "CorpMiner"],
["MyMiner", "Name", "MyMinerName"]
]MyMiner наследует свойства CorpMiner: роль корпорации, её способности и изображение. Собственный Name заменяет только название. Строка MyMinerName в словаре нужна для видимого имени; готовый словарь приведён в рецепте «Корпорация». Если вместо CorpMiner написать CorpColonist, основой станут колонисты и унаследованные способности изменятся.
У частей определения есть отдельное правило наследования. В разделе 3.3 мы разобрали процентный доход CorpMagnate.Interest. Теперь создадим разновидность магнатов с собственной частью Interest. Полный файл Logic/MyMagnate.json:
[
["MyMagnate", "Is", "CorpMagnate"],
["MyMagnate", "Name", "MyMagnateName"],
["MyMagnate.Interest", "Adds.Income.Credits", 1]
]Для названия этой новой корпорации добавьте в Text/ruRU.json ключ MyMagnateName. Если словаря ещё нет, полное содержимое такое:
{
"MyMagnateName": "Мои магнаты"
}Собственная Interest заменит всю родительскую Interest. Поэтому Per Credits из родительской части не сохранится: новая часть даёт фиксированный доход 1 кредит за ход. Если нужна ещё одна способность в дополнение к процентам, дайте ей другое имя, например ExtraIncome, и родительская Interest останется. Это же правило действует для стартовых частей Start сценариев.
Готовые категории и определения для Is
Выбирайте имя справа от Is из нужной группы. Категория задаёт вид вещи; конкретное определение служит готовой основой со своими свойствами. Ниже перечислены основные варианты PreWarpAge. Их точные определения можно читать в указанных файлах Vanilla/Logic; правки записывайте в собственном моде.
- Корпорация с собственными способностями - Corporation. Готовые корпорации: CorpMiner - добытчики, CorpColonist - колонисты, CorpMagnate - магнаты, CorpTechnocrat - технократы. Определения: Corporations.json.
- Исследуемая технология - Tech. Для наследования готового бонуса можно взять, например, DeepExtraction или ResearchAutomation. Все технологии находятся в Techs.json; полный перечень имён приведён ниже.
- Постройка - Building; размещение на поверхности - SurfaceBuilding, на орбите - Orbital. Готовые основы из Builds.json: SpaceStation, HQ, Metropolis, Outpost, Colony, City, DomeMegacity, GasExtractor, SkyExtractor, StellarFarm, DysonRing, WarpDrivePrototype.
- Сценарий - Scenario. Основы из Scenarios.json: ScenarioK, ScenarioG, ScenarioF, ScenarioM, ScenarioA, ScenarioBrownDwarf. ScenarioSol - обучающая Солнечная система; у неё собственная карта и обучение.
- Режим партии — Rule. Готовые режимы из Modes.json: ModeMeditation — «Казуал», ModeClassic — «Классический», ModeHardcore — «Хардкор». Внутренний идентификатор ModeMeditation не изменился.
- Ресурс - Resource. Существующие ресурсы из Simulation.json: Workers, Water, Minerals, Science, Energy, Credits, Approval. Дополнительные роли: Workforce - рабочие, Currency - валюта, Stat - показываемый показатель. Их назначение и сочетания разобраны в статьях о ресурсах.
- Мир и его признаки: World - мир, Rocky - каменистый, Icy - ледяной, Earthlike - землеподобный. Готовые каменные и ледяные миры перечислены ниже. Определения: Map.json.
- Звезда - Star. Профили из Map.json: ClassK, ClassG, ClassF, ClassM, ClassA, Substellar, BrownDwarf. Sun - авторское Солнце из Solar.json.
- Гигант - Giant. Готовые модели: HotJupiter, GasGiantSmall, IceGiantSmall, GasGiantMedium, IceGiantMedium, GasGiantLarge. Астероид - Asteroid; модели RockyAsteroid и IceAsteroid. Определения: Map.json.
- Событие - Event, вариант ответа - EventChoice, условная способность - Trait, действие - Action. Примеры событий и вариантов находятся в Events.json; объявления конкретных действий - в Simulation.json. Наличие роли само по себе не заменяет необходимое расписание, состав или результат действия.
Готовые технологии, Techs.json. Это имена определений, которые можно использовать справа от Is; для условия исследования они же указываются в Requires:
- OutpostConstruction, DeepExtraction, NuclearDrives, ResearchAutomation, AdvancedThermalInsulation, RegolithShielding, FrostTapping, FusionDrives, BlockchainGovernance, FusionWeapons.
- CryoInsulation, RefractoryCeramics, ClosedBiosystems, CloudMining, StellarEnergy, MantleDrilling, QuantumComputing, QuantumInsulation, UltraCarbides, PlanetaryUrbanization.
- DenseConstruction, SkyMining, CryoRefining, AntimatterDrives, AIManagement, AGI, SyntheticMaterials, Megaengineering, CoreExtraction, AdvancedGeoSurvey.
- MindDigitization, ASI, WarpDrives, PostTechnologies, SpaceStations, AdvancedSpaceStations, ComplexSpaceStations.
Готовые модели миров, Map.json. Их имена используются, когда вы хотите унаследовать конкретный мир, а не общую категорию World:
- Малые тела: TinyRock, TinySulfuric, TinyIce, TinyCryogenic.
- Небольшие миры: SmallLava, SmallRock, SmallIce, SmallCryogenic.
- Миры среднего размера: StandardLava, StandardChthonian, StandardHothouse, StandardOcean, StandardEarthlike, StandardAmmonia, StandardIce, StandardCryogenic.
- Крупные миры: LargeLava, LargeChthonian, LargeHothouse, LargeOcean, LargeAmmonia, LargeIce.
Например, Is TinyRock берёт готовую основу маленького каменного мира, Is World - только общую основу мира. Для авторских планет и лун Солнечной системы смотрите Solar.json. Имена чувствительны к регистру: TinyRock и tinyrock - разные строки.
Has - состав и владение количеством
Has означает «имеет» и перечисляет состав объекта. Например, у игрока есть набор технологий, а у события - набор вариантов ответа. Слева записывается тот, чей состав мы меняем, справа - имя добавляемого определения. Новая строка Has дополняет существующий набор: перечислять заново все технологии игрока не нужно.
["Player", "Has", "SurveyScience"]Эта строка включает SurveyScience в дерево технологий игрока. Определение самой технологии должно существовать, как в учебном примере. Бонус появится после исследования. У события строка Has с именем варианта ответа добавила бы кнопку выбора; одинаковое отношение состава используется для разных объектов, но не означает немедленное выполнение добавленного элемента.
Проверка запаса ресурса внутри условия - другая задача. Её пошагово разбирает статья Requires. Здесь Has использовался для включения технологии в набор игрока.
Adds - числовая прибавка
Начнём с прибавки к доходу науки. Следующая запись дополняет определение SurveyScience из раздела 3.4:
["SurveyScience", "Adds.Income.Science", 1]После исследования игрок получает прибавку 1 к доходу науки за ход. Если до исследования доход был 2, он станет 3 без других изменений. Пока технология не изучена, прибавка не действует. В имени Adds.Income.Science слово Adds означает «прибавляет», Income - доход за ход, Science - науку.
Теперь хотим уменьшить доход на единицу. Заменим только число в этой же записи:
["SurveyScience", "Adds.Income.Science", -1]При прежнем доходе 2 результат будет 1. Отрицательная прибавка уменьшает ту же величину. Это всё ещё изменение дохода за каждый ход, а не разовая потеря науки.
Другая задача - выдать минералы один раз в результате выбора игрока. В полном примере статьи EventChoice вариант «Переработать образцы» ведёт к результату OGSamplesRecycled. Размер его награды можно изменить следующим фрагментом:
["OGSamplesRecycled", "Adds.Minerals.Count", 20]После выбора «Переработать образцы» результат добавит в запас 20 минералов. Следующий ход не выдаст ещё 20 от того же выбора. Count означает количество в запасе; Income.Science в предыдущем примере означал доход за ход. Подключение результата к варианту и варианта к сообщению показано в EventChoice. Одна строка награды не создаёт сообщение и кнопку.
Третья задача - увеличить добычу одним рабочим. Фрагмент существующей технологии DeepExtraction:
["DeepExtraction", "Adds.Production.Minerals", 0.2]После исследования к ставке добычи минералов добавляется 0,2 на рабочего. Например, ставка 1 станет 1,2 до остальных модификаторов; три назначенных рабочих дадут 3,6 вместо 3. Если никто не назначен, этот бонус сам по себе минералы не производит.
Несколько прибавок к одному свойству складываются, если выполнены их условия. Чтобы ограничить получателей бонуса, используется Target; чтобы считать его за единицу другой величины - Per. Примеры обоих правил приведены в соответствующих статьях справочника.
Мы разобрали три разных изменения: запас один раз, доход за ход и ставку добычи на рабочего. Суммирование нескольких прибавок и применение множителей показаны пошагово в статье «Сумма эффектов, база и разовая выдача». Для новых модов используйте явные формы Adds.свойство; старые записи с числовым Target и голым Adds не служат образцом.
Условия и числовые эффекты
Начнём с трёх отдельных задач. Сначала потребуем изучить одну технологию перед другой. Затем дадим изученной технологии доход. После этого увеличим доход множителем. В следующих статьях каждое правило разбирается подробнее.
Требование. В основной игре есть технологии ResearchAutomation и OutpostConstruction. Следующий полный файл Logic/Requirement.json делает «Строительство аванпостов» предшественником ResearchAutomation:
[
["ResearchAutomation", "Requires", "OutpostConstruction"]
]Requires означает «требует». Сначала игроку придётся изучить OutpostConstruction, и только потом станет доступна ResearchAutomation. Эта строка ничего не начисляет и сама не завершает исследование.
Прибавка. Другой полный файл, Logic/Bonus.json, задаёт бонус ResearchAutomation:
[
["ResearchAutomation", "Adds.Income.Science", 2]
]Adds прибавляет указанное число. Здесь Income.Science - доход науки за ход. После исследования ResearchAutomation игрок получит прибавку 2 науки за ход; до исследования бонуса нет. Это замена величины бонуса существующей технологии, а не ещё одна прибавка к её прежнему числу.
Множитель. CloudMining - существующая технология. Полный файл Logic/Multiplier.json меняет её бонус так:
[
["CloudMining", "Multiplies.Income.Energy", 1.1]
]Multiplies умножает. После исследования CloudMining положительные поступления энергии умножаются на 1,1: поступление 10 становится 11. Самостоятельные расходы энергии от этого не увеличиваются. Этот пример не требует двух предыдущих файлов; три задачи можно проверить отдельно.
В примерах выше показаны целые Logic-файлы. Дальше короткие блоки могут показывать только изменяемые строки уже названного определения. Они подписаны до кода. Если вы ещё не добавляли строки в существующий файл, сначала посмотрите полный пример с одной и двумя записями в разделе «Субъект, предикат и значение».
Requires и Or - требования
Начнём с требования технологии. Этот полный файл Logic/ResearchRequirement.json меняет уже существующую ResearchAutomation:
[
["ResearchAutomation", "Requires", "OutpostConstruction"]
]Слева стоит технология, которую игрок хочет изучить. Справа - её предшественник. Пока игрок не исследовал «Строительство аванпостов» (OutpostConstruction), ResearchAutomation недоступна. Выделить предшественника мышью недостаточно: проверяется завершённое исследование.
Теперь отдельно зададим место строительства. Ниже показаны строки требований новой SurveyStation; это ещё не полный рецепт постройки. Две строки Is относят её к зданиям и орбитальным постройкам. Новая здесь строка Requires World:
["SurveyStation", "Is", "Building"],
["SurveyStation", "Is", "Orbital"],
["SurveyStation", "Requires", "World"]World - категория миров. Теперь место станции должно быть миром; гигант, который не принадлежит World, этому требованию не соответствует. Здесь Requires проверяет выбранное место строительства, а в первом примере проверял знания игрока. Различие следует из того, что указано справа: категория места или технология.
Разрешим ещё одно место - гигант. К трём строкам станции добавьте следующую:
["SurveyStation", "Requires.Or", "Giant"]Or означает «или». Теперь подойдёт мир или гигант. Если написать обычное Requires Giant без Or, место должно будет одновременно принадлежать World и Giant: это уже другое требование.
Наконец соединим два изученных правила: место должно быть миром или гигантом, а игрок должен знать технологию аванпостов. Все строки требований вместе выглядят так. Для законченной постройки также нужны название, значок и цена; они разбираются в статье Building.
["SurveyStation", "Is", "Building"],
["SurveyStation", "Is", "Orbital"],
["SurveyStation", "Requires", "OutpostConstruction"],
["SurveyStation", "Requires", "World"],
["SurveyStation", "Requires.Or", "Giant"]Игрок должен изучить OutpostConstruction, а место строительства должно принадлежать World или Giant. Requires.Or добавляет альтернативу к требованиям того же рода: здесь можно выбрать одно из двух мест, но технология всё равно нужна. Без Or обе категории места были бы обязательны. Аналогично Requires.Corporation и Requires.Corporation.Or позволяют перечислить подходящие корпорации.
Игра понимает требование по тому, на что оно ссылается. Ссылка на технологию проверяет, изучил ли её этот игрок. Ссылка на категорию мира проверяет место. У улучшения ссылка на постройку проверяет его непосредственную базу, принадлежащую игроку. У черты требование проверяет вещь, которой эта черта могла бы достаться. Requires Homeworld требует родного мира. Простого упоминания нужного имени в другом поле недостаточно.
Два обычных требования места можно использовать и для пересечения категорий. В следующем фрагменте SurveyStation должна находиться именно на ледяном мире:
["SurveyStation", "Requires", "World"],
["SurveyStation", "Requires", "Icy"]Нужны обе принадлежности. С Requires.Or Icy получилось бы «любой World или любой Icy». Для проверки этой версии замените прежний список требований места целиком: не оставляйте от предыдущей версии Requires.Or Giant. Не объявляйте одно определение одновременно технологией, базой улучшения и категорией места: тогда ссылку нельзя прочесть однозначно.
Числовое условие проверяет конкретное значение. Возьмём SurveyGift из рецепта «Событие»: эту строку можно добавить к его определению, чтобы событие с разовой наградой минералами появлялось лишь у игрока с запасом не меньше 10 минералов:
["SurveyGift", "Requires.Has.Minerals.Min", 10]Has.Minerals читает запас минералов получателя события. Min 10 означает «не меньше 10»: при 9 условие ложно, при 10 и 11 истинно. Это проверка до награды; она не списывает минералы и не выдаёт их.
Чтобы разрешить только запас от 10 до 20 включительно, нужны две границы:
["SurveyGift", "Requires.Has.Minerals.Min", 10],
["SurveyGift", "Requires.Has.Minerals.Max", 20]При 10 и 20 выполняются обе строки, при 9 или 21 - нет. Or у требования места не отменяет эти числовые границы: они проверяются отдельно. Ниже справочно перечислены другие сравнения; F означает проверяемое свойство, V - значение, N - числовой порог.
- Requires.F = V или Requires.F.Equal = V: поле F равно V. Для поля с несколькими значениями достаточно наличия V. Отсутствующее поле не считается ни false, ни числовым нулём.
- Requires.F.More = N: строго больше N. Less: строго меньше. AtLeast или Min: не меньше. Max: не больше. Обе границы диапазона без Or обязательны.
- Requires.F.Any = V: совпадение с одним из перечисленных вариантов этого поля. Requires.F.Not = V: исключение указанного варианта. Для простой предметной альтернативы предпочитайте Or.
- Requires.Not = Category: проверяемая вещь не принадлежит указанной категории и не имеет такой активной черты. Requires.Trait = TraitName: у неё действует указанная черта.
- Requires.Has.R.Min = N: запас ресурса R у проверяемой вещи не меньше N. Requires.Owner.Has.R.Min проверяет запас её владельца. Для ставки добычи на мире указывайте Production.R: например, Requires.Production.Minerals.More со значением 0 проверяет наличие положительной добычи минералов, а не их запас у игрока.
- Вместо числового порога некоторые сравнения допускают путь к другому числу. Например, Requires.Size.Less = Owner.Size сравнивает размер вещи с размером её владельца. Пример имеет смысл только там, где у вещи есть Owner, а у её владельца - Size.
Если потомок задаёт собственные требования места, они заменяют унаследованные требования места вместе с их Or; требования технологий рассматриваются отдельно. Один список не позволяет выразить две независимые группы мест «A или B» и «C или D» или правило «с технологией A на мире, с B на астероиде». Такие случаи оформляйте отдельными вариантами постройки. Перестановка строк и названия частей определения не создают скобки в условии.
У события порог можно рассчитать один раз при появлении. Разберём четыре альтернативные версии условия в ветви HeadquartersQuest.Done. Полный пример задания приведён в статье Goal: он выбирает мир и запускает исход, когда выполнена цель. Здесь меняем только проверку: вместо Goal.Has HQ требуется размер выбранного мира. Само условие размер не меняет. Пусть при появлении задания размер цели равен 12,5, а масштаб события - 20. Каждая следующая версия заменяет предыдущую. Сначала потребуем увеличить размер в 1,4 раза.
["HeadquartersQuest.Done", "Requires.Target.Size.Min.Mult", 1.4]Target.Size читает размер выбранного мира. Mult берёт исходное значение целиком: 12,5 × 1,4 = 17,5. Для нижнего порога результат округляется вверх до 18. При размере 17 условие ещё не выполнено, при 18 выполнено. После изменения размера порог остаётся прежним.
Вместо множителя можно потребовать прибавку к исходной целой части.
["HeadquartersQuest.Done", "Requires.Target.Size.Min.Add", 3]Add берёт целую часть 12,5, то есть 12, и прибавляет 3. Порог получится 15, а не 15,5. При размере 14 условие ложно, при 15 истинно. Этот же приём используется в статье Track для трёх новых завершений после выдачи задания.
В следующей версии порог задаёт Scaled.
["HeadquartersQuest.Done", "Requires.Target.Size.Min.Scaled", 0.5]При масштабе 20 коэффициент 0,5 даст порог 10. Исходный размер 12,5 уже превышает его, поэтому условие выполнено сразу.
Только теперь соединим прибавку и масштаб.
["HeadquartersQuest.Done", "Requires.Target.Size.Min.Add.Scaled", 0.5]Add.Scaled складывает исходную целую часть 12 и добавку 20 × 0,5 = 10. Сохранённый порог равен 22. При размере 21 условие ложно, при 22 истинно. Для проверки заменяйте Goal.Has HQ только одной из этих строк. Остальные факты задания сохраняются.
Порог не растёт вслед за проверяемым значением. Для обычного задания на прирост ресурсов используйте Goal.R из статьи о целях. Перечисленные окончания работают там, где механизм события сохраняет начальный порог; добавление их к произвольному условию такой механизм не создаёт.
Target - получатель, место и фильтр цели
Сначала выберем получателей бонуса технологии. RegolithShielding уже существует в основной игре и увеличивает рабочие места. Запись Target ограничивает, каким мирам достанется этот бонус.
Сначала настроим существующую технологию RegolithShielding, уже включённую в дерево игрока. Фрагмент ниже задаёт прибавку четырёх рабочих мест на собственных каменистых мирах после исследования. Это аддитивная часть бонуса: остальные эффекты определения сохраняются, а итоговая вместимость учитывает и их множители. World.Rocky означает одновременную принадлежность категориям World и Rocky.
["RegolithShielding", "Target", "World.Rocky"],
["RegolithShielding", "Adds.Workplaces", 4]До исследования количество мест не меняется. После исследования бонус действует на подходящие собственные миры, включая те, которые игрок получит позднее. Target не создаёт новые миры и не заменяет исследование технологии.
Теперь выберем место события. SuppliesWater - существующая доставка воды. Начнём с одного ограничения: её место должно принадлежать категории World. Это изменение записывается так:
["SuppliesWater", "Target", "World"]Игра ищет подходящий мир и при доставке связывает с ним сообщение. World - ещё не имя конкретной планеты. В сохранённом уже произошедшем событии вместо категории можно увидеть ссылку на выбранное тело: выбор к этому моменту завершён.
Потребуем, чтобы выбранный мир был разведан. Добавим один фильтр:
["SuppliesWater", "Target.Explored", true]Explored true проверяет знание выбранного тела игроком. Неразведанный мир больше не подходит. Прежнее требование Target World сохраняется: нужны и категория мира, и разведка.
Исключим родной мир отдельной строкой:
["SuppliesWater", "Target.Not", "Homeworld"]Not означает исключение. Родной мир не подойдёт, даже если он разведан. Остальные разведанные миры остаются кандидатами. Теперь все три изученные строки можно собрать вместе:
Теперь изменим место существующей доставки воды SuppliesWater. Основная игра уже задаёт её награду, изображение и участие в группе Supplies. Этот фрагмент разрешает доставку на разведанный мир, кроме родного. Он не запускает доставку немедленно.
["SuppliesWater", "Target", "World"],
["SuppliesWater", "Target.Explored", true],
["SuppliesWater", "Target.Not", "Homeworld"]Добавим другой признак места - каменистость. У события для него нужна отдельная строка Target.Is:
["SuppliesWater", "Target", "World"],
["SuppliesWater", "Target.Is", "Rocky"]Здесь выберется каменистый мир. Не переносите в событие сокращение World.Rocky из бонуса технологии: числовой бонус понимает его как сочетание двух категорий, а событие ищет категорию с таким полным именем. Без отдельно объявленной категории World.Rocky подходящего места не найдётся. Event и Mission используют это правило выбора места одинаково.
Ещё один отдельный фильтр проверяет возможность строительства. Например, следующая строка оставляет лишь места, в которых игроку сейчас доступно строительство HQ:
["SuppliesWater", "Target.Build", "HQ"]Этот фильтр ничего не строит и не выдаёт штаб. Он использует действующие требования постройки. Сочетайте его с предыдущими фильтрами только если действительно хотите требовать их все одновременно.
Target.Has проверяет связанное имущество указанного рода, если оно действительно существует в этой игре. Условия разных полей выполняются вместе. Альтернативы одного поля задаются через Or, например Target.Has и Target.Has.Or.
В числовой способности Target PlacedAt выбирает объекты, размещённые на вещи с этой способностью: у них PlacedAt ссылается на неё. Target Target.PlacedAt выбирает объекты, размещённые на её цели. Это обратный отбор размещённых объектов, а не переход к миру под постройкой.
В исходе события Parent означает сообщение, из которого вызван исход, а Parent.Target - тело этого сообщения. Нужные связи уже должны существовать: отсутствующая ссылка не заменяется случайным телом. Фильтры записываются непосредственно после Target; общего префикса Target.If нет.
Можно задать предпочтение: сначала искать каменистый мир, а при его отсутствии - ледяной. Ниже ещё один фрагмент для SuppliesWater. A и B - придуманные имена частей правила. Общие требования самого события сохраняются; части проверяются по Order, при равенстве - по имени. Игра выбирает первую часть, для которой нашлись подходящие тела.
["SuppliesWater", "Target", "World"],
["SuppliesWater", "Target.Explored", true],
["SuppliesWater.A", "Order", 1],
["SuppliesWater.A", "Target.Is", "Rocky"],
["SuppliesWater.B", "Order", 2],
["SuppliesWater.B", "Target.Is", "Icy"]Для задания на накопление можно выбрать тело по нехватке денег на разведку. Сначала укажем, какую цену читать. Этот вариант относится к SuppliesWater; прежние обычные ограничения Target сохраняются.
["SuppliesWater", "Target.Cost.Minerals.Count", "Explore"]Для каждого кандидата игра сравнит текущую цену Explore в минералах с запасом игрока. При цене 50 и запасе 10 не хватает 40 минералов. Если Scaled использует масштаб 20, нехватка составит 40 / 20 = 2 единицы масштаба.
Сначала ограничим нехватку снизу.
["SuppliesWater", "Requires.Scaled.Min", 1.5]Нехватка 2 подходит, нехватка 1 - нет. Нижняя граница 1,5 включается в допустимый диапазон. Теперь ограничим нехватку сверху.
["SuppliesWater", "Requires.Scaled.Max", 2.5]Вместе границы оставляют нехватку от 1,5 до 2,5 включительно. Тело с нехваткой 2 остаётся кандидатом, тело с нехваткой 3 исключается. Для этой проверки допустима цена только в одном ресурсе.
Per - величина за единицу
Per означает «за каждую единицу». Например, 0,03 кредита дохода за каждый накопленный кредит дают 3 кредита за ход при запасе 100. Число после Adds задаёт доход на единицу, а Per указывает, сколько таких единиц брать. Действие при этом не повторяется сто раз: рассчитывается один итоговый доход.
Процентный доход уже есть у корпорации магнатов CorpMagnate. Interest - часть её определения. Посмотрим только на эту способность:
Adds.Income.Credits задаёт доход 0,03 за единицу. Per Credits называет эту единицу: один кредит в запасе игрока. Поэтому итог зависит от запаса, а не от того, сколько раз игрок нажал кнопку.
["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]При запасе 100 кредитов получится 100 × 0,03 = 3 кредита за ход, при запасе 200 - 6. Запас читается у игрока, выбравшего магнатов, и самим этим расчётом не расходуется.
Так же можно вычислять множитель за единицу размера. Следующий отдельный фрагмент относится к уже существующей способности SizeScale мира:
["SizeScale", "Per", "Size"],
["SizeScale.Places", "Multiplies.Workplaces", 0.2]Per Size читает размер мира. При размере 4 множитель равен 4 × 0,2 = 0,8, при размере 5 - 1. Это умножение 0,2 на размер, а не возведение 0,2 в степень размера. Если Size отсутствует, вклада нет. Если Size существует и равен нулю, получится нулевой множитель: отсутствие и ноль различаются.
У ресурса можно выбрать точность чтения. Per Credits в первом примере берёт целую часть запаса. Чтобы учитывать дробь, замените только эту строку способности магнатов:
["CorpMagnate.Interest", "Per", "Credits.Count"]Теперь при 100,5 кредита в расчёт войдёт 100,5, а не 100. До округления доход составит 100,5 × 0,03 = 3,015. Употребление WorkersFree вместо Credits означало бы число свободных работников; сам Per по-прежнему только читает величину.
Величину можно взять у связанного объекта. Например, в части эффекта постройки Per PlacedAt.Size читает размер мира под ней, а не размер самой постройки. Такая запись имеет смысл лишь у объекта с реальной ссылкой PlacedAt. Путь Owner.Size аналогично читает размер владельца, если он у владельца существует.
Общий Per действует и на части определения. В показанном SizeScale его часть Places получает Per Size от родителя. Если у Places записать собственный Per, он заменит родительский для этой части. Объект проверки Requires от этого не меняется: Per выбирает только величину расчёта.
Multiplies - множитель поля или силы способности
Multiplies умножает значение. Например, доход 10 при множителе 1.1 становится 11: прибавляется десять процентов, а не десять единиц. Множитель действует, пока действует давшая его технология, корпорация или черта.
Сначала изменим только существующую технологию CloudMining. Её не нужно заново включать в дерево игрока. Следующая строка задаёт её энергетический бонус:
Income.Energy означает положительные поступления энергии за ход. Число 1.1 означает умножение на 1,1. Множитель технологии начинает действовать только после её исследования.
["CloudMining", "Multiplies.Income.Energy", 1.1]Поступление 10 превратится в 11, поступление 20 - в 22. Отдельный расход энергии, например содержание постройки, останется прежним. Множитель 1 ничего не изменил бы; множитель 0 обнулил бы результат, если само свойство допускает ноль.
Теперь отдельный пример для корпорации. Строка ниже меняет существующих колонистов CorpColonist:
["CorpColonist", "Multiplies.Workplaces", 1.4]В партии за колонистов рабочие места подходящих собственных объектов умножаются на 1,4. В расчёте из 10 получится 14 до дальнейшего округления и других модификаторов. Здесь бонус включается выбором корпорации, а не исследованием CloudMining.
Если на одно поле действуют два множителя, они перемножаются. Например, 1,1 и 1,2 дают общий множитель 1,32. Это правило применяется к числам; Name, Icon и true/false через Multiplies не меняются. Получателя можно ограничить отдельным Target, как показано в его статье.
Теперь сделаем множитель дохода зависимым от населения. Следующий отдельный фрагмент добавляет такую часть к DeepExtraction. PopulationIncome - придуманное имя части технологии:
["DeepExtraction.PopulationIncome", "Per", "Workers"],
["DeepExtraction.PopulationIncome", "Adds.Multiplies.Income.Science", 0.1]После исследования Per Workers читает население игрока. Adds.Multiplies.Income.Science начинает множитель с 1 и добавляет 0,1 за каждого работника. При населении 4 получится 1 + 0,1 × 4 = 1,4. Доход науки 2 превратится в 2,8; при населении 6 - в 3,2, если других научных потоков нет. Обычное Multiplies.Income.Science 0.1 с тем же Per дало бы множитель 0,4 при четырёх работниках: наличие Adds здесь меняет формулу.
Следующий фрагмент для существующей технологии NuclearDrives ослабляет надбавки семейства RemotenessTrait до 80% их силы. Сами расстояния до родного мира остаются прежними. Семейство уже связано со свойством Distance в основной игре:
["NuclearDrives", "Multiplies.RemotenessTrait", 0.8]Это множитель силы черты, а не самого расстояния и не одного поля. При силе 0,8 прибавка черты 10 превратится в 8. Если черта даёт множитель 2, ослабляется только надбавка сверх 1: получится 1 + (2 − 1) × 0,8 = 1,8. Поэтому ответ здесь не равен 2 × 0,8.
По той же форме можно изменить силу семейства черт, связанных через Is. Не называйте семейство так же, как изменяемое числовое поле: у записи не должно быть двух разных прочтений. У повторяемой технологии каждое завершённое исследование добавляет её эффект ещё раз: прибавки складываются, множители перемножаются. Подробный пример повторения находится в статье Tech.
Сумма эффектов, база и разовая выдача
Разберём расчёт дохода на одном примере. Проверяйте его в отдельном моде за корпорацию «Добытчики», без назначенных на добычу минералов работников. Тогда добыча рабочих не смешается с изучаемым доходом. Сначала создайте полный файл Logic/MineralIncome.json:
[
["Minerals", "Income", 10]
]У Minerals теперь есть собственный доход 10 за ход. Это исходное значение, или база расчёта. В данном примере без других источников и расходов игрок получает 10 минералов за ход. Число в запасе и число за ход - разные вещи: запись не заменяет запас числом 10.
Теперь добавим бонус технологии. Замените тот же файл целиком:
[
["Minerals", "Income", 10],
["DeepExtraction", "Adds.Income.Minerals", 2]
]После исследования «Глубокой добычи» (DeepExtraction) к базе 10 прибавляется 2. Получается 12 минералов за ход. Пока технология не изучена, действует только база 10. Строка мода заменяет прежнюю величину этого бонуса DeepExtraction; её прежнее число не прибавляется ещё раз. Бонус технологии к добыче одним рабочим сохранится, поэтому для этой проверки работники на минералы не назначены.
Следующим шагом введём множитель второй технологии. Ещё раз замените файл целиком:
[
["Minerals", "Income", 10],
["DeepExtraction", "Adds.Income.Minerals", 2],
["CloudMining", "Multiplies.Income.Minerals", 1.5]
]Когда изучены обе технологии, игра сначала складывает 10 и 2, затем умножает сумму на 1,5. Доход равен (10 + 2) × 1,5 = 18. Множитель применяется ко всей положительной сумме, а не только к прибавке 2. Порядок этих строк в JSON результата не меняет. Если из двух технологий изучена только CloudMining, получится 10 × 1,5 = 15.
Несколько самостоятельных прибавок сначала складываются с базой. Несколько множителей затем перемножаются. Например, к полученным 18 ещё один действующий множитель 1,2 даст 21,6. Запас ресурса может хранить дробное количество; правила округления конкретного показателя разбираются в статье «Min, Max и Round».
Здесь базой служит Income 10 на Minerals. У некоторых других свойств предусмотрена отдельная форма с Base; её смысл указан в статье соответствующего свойства. Она не является обязательной строкой любого эффекта. После числового расчёта игра соблюдает пределы и округление изменяемого количества.
Теперь отделим доход от разовой награды. Возьмём SurveyGift из рецепта «Событие». В его файле Logic/Event.json измените только коэффициент награды с 1 на 2; остальные строки сохраняются:
["SurveyGift", "Adds.Minerals.Scaled", 2]При масштабе 10 событие один раз добавит 20 минералов по расчёту Scaled. Запас 7 вырастет до 27. Для проверки используйте файл EventCheck.json с группой SurveyGiftCheck из того же рецепта: она запустит событие на втором ходу.
Сравните две записи. Adds.Income.Minerals 2 у изученной технологии даёт прибавку 2 каждый следующий ход. Adds.Minerals.Scaled 2 у события SurveyGift выдаёт награду один раз. Фиксированная разовая награда через Adds.Minerals.Count разобрана на исходе выбора в статье EventChoice.
Временный доход рассмотрен отдельно в статье «Временные эффекты и Blocks»: там срок события ограничивает число ходов с бонусом. Однократные стартовые ресурсы сценария показаны в статье «Corporation, Rule и Scenario». Эти случаи используют те же числовые операции, но имеют собственный момент применения.
Постройка тоже может приносить доход. В рецепте «Постройка» строка SurveyOutpost Income.Science 1 означает собственный доход готового аванпоста. Он включается после завершения строительства. Это другой источник: бонус технологии начинает действовать после исследования, доход постройки - после её появления. Рабочие места поверхностной постройки и самостоятельные назначения станции разобраны отдельно в статьях «Workplaces» и «Production».
Черта через Has может менять саму вещь или принадлежащие ей объекты. Как различаются эти случаи и почему один Has на постройке не означает бонус всем мирам игрока, разобрано в статье «Trait и Grants». Для временной прибавки используйте срок события, а не ручное восстановление исходного числа.
Per отвечает за величину, Target - за получателей. Изменение Target не означает, что Per автоматически начнёт читать свойства новой цели. Например, Per Size читает размер вещи, у которой действует способность. Если требуется размер связанного места размещения, используется поддерживаемый путь PlacedAt.Size. Примеры - в статье «Per».
Adds и Multiplies работают с числовыми свойствами, предусмотренными языком игры. Название, значок, ссылки, Is, Has и true/false ими не меняются. Новое имя с числом само по себе не объявляет числовое свойство. Для нового материала сначала нужен Is Resource; порядок объявления разобран в статье «Resource, Stat и Currency».
Некоторые числа доступны только для чтения: Change.R, WorkersFree, Build.Cost, Explore.Cost, Researching.Steps и счётчики Track. Записи Completed также создаёт сама игра. Их можно использовать в разрешённых условиях, но нельзя переписывать через Adds.
У других задач свои формы: скидки задаются в Cost, регулярное содержание - в Upkeep, торговые цены и объёмы - в Price и Trade. Параметры предложения миссии меняются её вариантами, а шкала Progress - собственными операциями. Эти формы и их ограничения приведены в соответствующих статьях; одна общая прибавка не заменяет их правила.
Trait и Grants - условные черты
Черта позволяет один раз описать бонус, а затем дать его разным объектам. Сначала только объявим черту ExtraCapacity с прибавкой двух рабочих мест. Trait - готовая категория черт, ExtraCapacity - выбранное нами имя.
Первый фрагмент описывает сам бонус, но пока никому его не присоединяет:
["ExtraCapacity", "Is", "Trait"],
["ExtraCapacity", "Adds.Workplaces", 2]Is Trait объявляет черту, Adds.Workplaces описывает её действие. Пока есть лишь определение ExtraCapacity, у миров ничего не изменится. Для постоянного присоединения к существующему TinyRock нужна ещё одна строка:
["TinyRock", "Has", "ExtraCapacity"]Теперь в новой партии каждый TinyRock получает прибавку двух мест. Она не создаёт работников: место и занятый работник - разные вещи. Если позже черта будет снята, исчезнет её прибавка, а не исходная вместимость мира.
Дальше перейдём к условной выдаче. Перед её проверкой уберите прямую строку TinyRock Has ExtraCapacity из файла: иначе постоянное присоединение сохранит бонус независимо от нового условия. Оставьте само определение ExtraCapacity.
Можно объединить черты в семейство: объявить семейство через Is Trait, а каждый его вариант - через Is с именем семейства. Вариант с Requires автоматически достаётся вещам, подходящим под его условия, и снимается, когда условия перестают выполняться. Само семейство и вариант без условий автоматически никому не выдаются. Для постоянного присоединения используйте Has, для выдачи событием - Marks.
["SmallWorldTrait", "Is", "Trait"],
["CompactWorld", "Is", "SmallWorldTrait"],
["CompactWorld", "Requires", "World"],
["CompactWorld", "Requires.Size.Max", 4],
["CompactWorld", "Multiplies.Cost.Build", 0.9]CompactWorld автоматически даёт скидку 10% на строительство на мирах размера не больше четырёх. SmallWorldTrait - имя семейства, CompactWorld - имя варианта. Варианты разных семейств выбираются независимо.
Семейство можно связать с существующим свойством для показа вариантов в его подписи и подсказке. Например, в основной игре Distance - свойство расстояния, RemotenessTrait - семейство черт удалённости. Строка ["Distance", "Has", "RemotenessTrait"] связывает описание свойства с этим семейством. Она не выдаёт каждую черту всем мирам: подходящий вариант по-прежнему выбирается по условиям самих вариантов.
Другой способ - отдельное правило Grants. Фрагмент ниже выдаёт ExtraCapacity только мирам размера не меньше 10. BigWorld - имя правила. Это альтернатива постоянному Has из первого примера; не оставляйте оба способа, если бонус должен исчезать при уменьшении размера.
["BigWorld", "Grants", "Size"],
["BigWorld", "Requires", "World"],
["BigWorld", "Requires.Size.Min", 10],
["BigWorld", "Has", "ExtraCapacity"],
["ExtraCapacity", "Is", "Trait"],
["ExtraCapacity", "Adds.Workplaces", 2]Grants Size связывает правило с существующим свойством размера. Requires World ограничивает его мирами, Requires.Size.Min задаёт порог. Has на самом правиле перечисляет выдаваемые черты. Записывать этот Has ещё и на мире не нужно. Если мир уменьшится ниже 10, бонус исчезнет. Повторная проверка условия не прибавляет места заново: пока условие выполнено, добавка остаётся равной двум.
Grants с именем свойства или семейства нужен отдельному правилу выдачи, которое само не объявлено вариантом Trait-семейства. Вариант семейства может предоставлять собственные свойства, а его Has - дополнительные самостоятельные черты. Числа меняют Adds и Multiplies; Grants только выбирает, какие способности действуют. Строковый Adds классификацию не объявляет. Requires в корне черты проверяет вещь, получающую черту; Target и Requires у её отдельной числовой части могут дополнительно ограничивать получателя этой части.
Сделаем выдачу ExtraCapacity случайной. Начнём с единственного правила BigWorld из предыдущего примера и добавим ему вес 30. Для этого опыта других случайных правил Grants Size быть не должно.
["BigWorld", "Chance", 30]У подходящего мира размера 10 шанс получить ExtraCapacity равен 30/100, то есть 30%. Остальные 70% означают отсутствие случайно выбранной черты. Результат сохраняется: повторное открытие подсказки не даёт новую попытку.
Теперь добавим второй подходящий вариант с отличимым результатом - одним рабочим местом вместо двух. BothWorlds - отдельное правило того же свойства Size.
["ExtraPlace", "Is", "Trait"],
["ExtraPlace", "Adds.Workplaces", 1],
["BothWorlds", "Grants", "Size"],
["BothWorlds", "Requires", "World"],
["BothWorlds", "Requires.Size.Min", 10],
["BothWorlds", "Has", "ExtraPlace"],
["BothWorlds", "Chance", 20]Для подходящего мира сумма весов равна 30 + 20 = 50. Вероятности: 30% на ExtraCapacity, 20% на ExtraPlace и 50% без случайной черты. Ни один результат не означает обе случайные выдачи сразу.
Увеличим только второй вес: заменим его20 на90.
["BothWorlds", "Chance", 90]Теперь сумма 120 превышает 100. ExtraCapacity выбирается с вероятностью 30/120 = 25%, ExtraPlace - 90/120 = 75%; пустого результата больше нет. Общее правило знаменателя - max(100, сумма подходящих весов). Chance неотрицателен; дочерняя условная часть может уточнить его. Adds.Weight и Adds.Chance для этого не используются.
Детерминированная выдача работает отдельно от случайного выбора. Для следующего сравнения уберите Chance у BothWorlds, а не задавайте ему0.
["BothWorlds", "Grants", "Size"],
["BothWorlds", "Requires", "World"],
["BothWorlds", "Requires.Size.Min", 10],
["BothWorlds", "Has", "ExtraPlace"]Теперь каждый подходящий мир получает ExtraPlace независимо от случайного BigWorld. Одно дополнительное место будет всегда, а ещё два от ExtraCapacity - с вероятностью 30%. Отсутствие Chance и Chance 0 различаются.
Кому достанется прибавка от черты через Has? Если изменяемое свойство задано у класса вещи или его Is-предка, черта меняет саму вещь. Например, у мира уже есть Workplaces, поэтому присоединённая ему черта с Adds.Workplaces меняет его рабочие места.
Если свойство объявлено у других классов, а у класса этой вещи его нет, числовая способность может обращаться к принадлежащим ей объектам через Owner. Поэтому Has с чертой на постройке сам по себе не означает ни бонус всем мирам игрока, ни бонус миру под постройкой. Для собственной местной черты задайте базу свойства на классе постройки, например Workplaces 0. Так видно, что черта меняет именно эту постройку.
Нулевая Production.R тоже является собственной объявленной ставкой: прибавка может сделать её положительной. Это отличается от отсутствующей добычи. Target PlacedAt выбирает объекты, размещённые на вещи с этой способностью, и не служит переходом к миру под постройкой. Выбор получателей разобран отдельно в статье Target.
Отдельно разберём две альтернативы для одного бонуса. Эта версия ExtraCapacity заменяет прежнее определение её числового эффекта; не оставляйте от прежнего опыта случайные Grants или постоянный Has.
["ExtraCapacity", "Is", "Trait"],
["ExtraCapacity", "Requires", "World"],
["ExtraCapacity", "Adds.Workplaces", 2],
["ExtraCapacity.Small", "Requires.Size.Max", 4],
["ExtraCapacity.Big", "Requires.Size.Min", 10]Small и Big содержат только условия. Они задают альтернативы для общей прибавки 2: мир размера 3 получит +2 через Small, размера 12 - +2 через Big, размера 6 - ничего. Корневое Requires World обязательно в любом случае. Если в одной части несколько условий, все они должны выполняться вместе.
Теперь добавим собственной части Small свою операцию. Прочитаем результат заново: это уже другая модель бонуса.
["ExtraCapacity.Small", "Adds.Workplaces", 1]Small становится самостоятельной числовой способностью: на мире размера 3 она даёт свою +1. Для общей прибавки +2 остаётся чисто условная альтернатива Big, поэтому мир размера 12 по-прежнему получает +2, а размера 6 не получает ничего. Условие одной собственной способности не должно выключать соседнюю. Чтобы сохранить прежнюю общую альтернативу Small, не добавляйте в неё отдельную операцию.
Источник условий и корректировка параметра
Иногда бонус достаётся миру, а условие нужно проверить у его владельца. Например: к вместимости мира прибавляется 2, пока у игрока есть хотя бы 100 науки. Запись Requires.Owner.Has.Science.Min прямо называет, чей запас проверяется: науки у владельца. Получателем прибавки остаётся мир; остальные множители вместимости применяются к ней обычным порядком.
Фрагмент ниже присоединяет черту к существующей категории World. WellFundedWorld - придуманное имя черты. Owner у собственного мира ссылается на игрока; его запас науки и проверяется. Код добавляется внутрь массива Logic-файла.
["World", "Has", "WellFundedWorld"],
["WellFundedWorld", "Is", "Trait"],
["WellFundedWorld", "Requires.Owner.Has.Science.Min", 100],
["WellFundedWorld", "Adds.Workplaces", 2]При 99 науки у игрока прибавка выключена, при 100 включается, после траты ниже 100 снова снимается. Если убрать Owner из Requires.Owner.Has.Science.Min, условие будет проверять запас науки самого мира. Черта следит за текущим запасом: однажды выполненное условие не закрепляет бонус навсегда. Сохранение начального порога у событий с Requires или Goal - другой механизм.
В существующих определениях можно встретить Adds.Source. Она выбирает общий объект для проверки Requires: прямую связь Owner, Parent, Target или PlacedAt либо имя существующего объекта. Произвольный путь Owner.Size в Adds.Source не поддерживается. При неразрешённой ссылке проверка остаётся на исходной вещи; опечатка не означает заведомо ложное условие.
Собственное Adds.Source части заменяет родительское; отдельного предиката Source нет. В текущей версии есть ограничение: изменение запаса связанного объекта через Adds.Source может не обновить уже действующий бонус. Поэтому для условия по владельцу используйте прямой путь Requires.Owner.Has.Science.Min, как выше.
Не путайте объект проверки с Per - числом для расчёта - и Target - получателем изменения.
Следующий пример меняет силу существующей способности по мере развития восстания RobotUprising. У события есть Progress, а часть Cap уменьшает вклад построек в рабочие места выбранного мира. Target.PlacedAt выбирает постройки, размещённые на цели события. Собственные базовые места мира эта часть не уменьшает. Фрагмент меняет коэффициент способности; самого события и его расписания не создаёт.
Сначала выберем, чей вклад будет уменьшаться. Это первая часть настройки уже существующей способности Cap.
["RobotUprising.Cap", "Target", "Target.PlacedAt"],
["RobotUprising.Cap", "Multiplies.Workplaces", 1]Target.PlacedAt находит постройки на мире - цели восстания. Множитель 1 пока оставляет их вклад без изменения. Например, постройка с вкладом 8 даёт те же 8 мест. Собственные места мира в этот выбор не входят.
Теперь поменяем коэффициент этой способности по шкале восстания. Здесь Target получает новое конкретное назначение: указывает на саму способность Cap, а не на мир или постройки.
["RobotUprising.Cap.Adjustment", "Target", "RobotUprising.Cap"],
["RobotUprising.Cap.Adjustment", "Per", "Progress"],
["RobotUprising.Cap.Adjustment", "Adds.Multiplies.Workplaces", -0.2]При Progress 1 коэффициент Cap равен 1 − 0.2 = 0.8: вклад постройки 8 станет 6.4 до округления. При Progress 2 коэффициент равен 0.6 и вклад станет 4.8. Собственная база мира сохраняется. Это знакомая прибавка к множителю, но получателем служит существующий параметр постоянной числовой способности. Произвольные поля по строковому адресу так менять нельзя. Ниже обе части собраны вместе.
["RobotUprising.Cap", "Target", "Target.PlacedAt"],
["RobotUprising.Cap", "Multiplies.Workplaces", 1],
["RobotUprising.Cap.Adjustment", "Target", "RobotUprising.Cap"],
["RobotUprising.Cap.Adjustment", "Per", "Progress"],
["RobotUprising.Cap.Adjustment", "Adds.Multiplies.Workplaces", -0.2]Изменяемый параметр должен уже существовать у постоянной числовой операции. Параметры разовых наград и случайного выбора этой формой не задаются. Нельзя создать цикл, в котором способности бесконечно меняют параметры друг друга, или использовать одно имя одновременно для категории получателей и параметра способности. Для обычного бонуса достаточно прямых Adds.F, Multiplies.F и Per.
Min, Max и Round - границы и округление
Начнём с нижней границы запаса. Следующая строка для существующего ресурса Minerals разрешает долг до тысячи минералов:
["Minerals", "Count.Min", -1000]Запас может стать −200 или −1000, но не должен уйти ниже −1000. При Count.Min 0 отрицательного запаса не будет. Это ограничение количества, а не проверка условия и не бесплатная выдача ресурса. Добровольная покупка по-прежнему требует доступной оплаты.
Теперь отдельно выберем округление верхней границы работников. Ceil означает вверх, Floor - вниз. Например, если расчёт максимума дал 3,2, Ceil даст 4, а Floor - 3. Строка для округления вверх выглядит так:
["Workers", "Count.Max.Round", "Ceil"]Round здесь относится именно к вычисленному максимуму Count.Max. Это не приказ округлить все числа работников в игре. Собственное правило заменяет унаследованное. Для округления вниз в этой же строке замените Ceil на Floor.
После двух отдельных объяснений обе независимые настройки можно поместить в один файл:
["Minerals", "Count.Min", -1000],
["Workers", "Count.Max.Round", "Ceil"]Смысл Min и Max зависит от конструкции: Count.Min ограничивает запас, Requires.F.Min проверяет «не меньше», Random.Min задаёт край диапазона, Goal.R.Min - минимальный прирост для задания. Не каждое числовое свойство применяет произвольную границу: одна строка Weight.Max ещё не ограничивает массу. Текстовое поле Icon также не становится числом от окончания .Max.
Adds.Round и Multiplies.Round округляют изменение при разовой операции, а не её коэффициент и не остаток запаса. Например, Multiplies.Workers.Count 0.9 уменьшает запас 11 на 1.1. С Multiplies.Round Floor изменение −1.1 округлится вниз до −2: останется 9 работников. Без Round обязательного минимального списания нет. У Trade.Max своё правило округления вверх; добавлять Trade.Max.Round не требуется.
Scaled - масштаб события
Scaled K вычисляет величину из коэффициента K и масштаба события. Например, Scaled 2 при масштабе 10 даёт 20. Так рассчитываются цены, награды, грузы и цели заданий. При появлении события игра фиксирует его масштаб для цен, наград, начального груза и планок заданий.
В режиме «Казуал» включено Rule.ScaledByPlayer true. Масштаб зависит от населения и числа завершённых технологий:
население × (1 + число завершённых технологий × Rule.ScaledByPlayer.TechMod)Rule.ScaledByPlayer.TechMod задаёт коэффициент технологий. В Pre-Warp Age он равен 0,04, при отсутствии настройки - 0,05. Повторные уровни одной технологии не увеличивают число технологий в расчёте.
В режимах «Классика» и «Хардкор» включено Rule.ScaledByTurn true. Масштаб зависит от номера хода Turn:
ceil(ResMin + (ResMax - ResMin) × ((Turn - 1) / (TurnWin - 1))²)ceil округляет вверх. Параметры Rule.ScaledByTurn.ResMin, Rule.ScaledByTurn.ResMax и Rule.ScaledByTurn.TurnWin в Pre-Warp Age равны 5, 3000 и 120. Поэтому на первом ходу масштаб равен 5, на 120-м - 3000, затем рост продолжается. Включать оба источника одновременно нельзя. Если ни один не выбран, действует расчёт по игроку.
Для коэффициента K количество равно max(1, floor(|K| × масштаб)). floor округляет вниз. Разовые прибавки Adds дополнительно сохраняют знак K: отрицательный коэффициент задаёт потерю, нулевой не меняет запас.
Contains.Scaled у варианта ответа, который увеличивает груз, использует текущий масштаб в момент нажатия. Такая прибавка пересчитывается при каждом использовании варианта.
Ресурсы, население и экономика
Resource, Stat и Currency - роли ресурса
Создадим новый ресурс по имени Alloy - сплав. Сначала только объявим, что это ресурс:
["Alloy", "Is", "Resource"]Resource даёт Alloy правила количества. Пока ресурс лишь описан: строка сама не выдаёт его игроку и не создаёт месторождения. Теперь присоединим запас игроку:
["Player", "Has", "Alloy"]В новой партии у игрока появится отдельный запас Alloy. Без заданного Count он начинается с нуля. Следующей строкой зададим начальное количество:
["Alloy", "Count", 10]Теперь начало запаса - 10 единиц. Это однократное начальное значение, не производство 10 единиц каждый ход. Если другой объект тоже имеет Has Alloy, его запас независим от запаса игрока.
Чтобы количество было видно на панели показателей, добавим отдельную роль Stat:
["Alloy", "Is", "Stat"]Stat отвечает за показ числа. Он не создаёт производство и не назначает Alloy деньгами. Например, Credits в основной игре дополнительно имеет роль Currency:
["Credits", "Is", "Currency"]Это существующее устройство игры, а не строка для добавления второй валюты. В одном наборе данных допускается одна Currency; Alloy в нашем примере остаётся обычным ресурсом.
Ресурс не обязан иметь роль Stat, а показатель Stat - роль Resource. В загруженной игре допускается одна валюта Currency. Is Predicate разрешает использовать само имя ресурса как предикат. Без этого объявления имя всё равно можно ставить после Cost или Production и указывать значением Has, но нельзя превращать его в самостоятельное слово в средней позиции триплета.
Вариант A: фрагмент добавляет игроку 10 единиц сплава Alloy. Производства и месторождений у этого варианта нет. Alloy - придуманное имя нового ресурса, ore_iron - существующий значок игры.
["Alloy", "Is", "Resource"],
["Alloy", "Is", "Stat"],
["Alloy", "Is", "Predicate"],
["Alloy", "Icon", "ore_iron"],
["Alloy", "Count", 10],
["Player", "Has", "Alloy"]Count задаёт начальный запас: без него новый Resource начинается с нуля. Has на другой вещи создаст её независимый запас того же ресурса. Одного Is Resource недостаточно для производства, месторождений и торговли - их правила задаются отдельно. Имя ресурса должно быть без точки. Встроенное слово языка нельзя заново объявить своим предикатом; использовать такое имя как аргумент можно лишь в конструкциях, которые это допускают.
Теперь отдельно добавим производство. В варианте B сплав будут делать работники родного мира. Сначала посмотрим лишь на ставку выпуска в части Factory новой корпорации:
["NewAlloyCorp.Factory", "Production.Alloy", 0.5]Production.Alloy 0.5 означает пол-единицы сплава на одного назначенного работника за ход. Двое дают 1, четверо - 2. Без назначений выпуск равен нулю. Чтобы производство требовало сырьё, зададим расход на того же работника:
["NewAlloyCorp.Factory", "Cost.Minerals", 1]Каждому работающему здесь нужен 1 минерал. Значит, двое выпускают 1 Alloy и тратят 2 Minerals. Это расход производства за ход, а не цена найма человека. Теперь укажем, где работают эти люди, и соберём полный вариант B. Используйте его вместо A: начальный Count здесь 0, а не 10.
NewAlloyCorp наследует способности добытчиков CorpMiner. При создании новой партии выберите её, выделите родной мир и назначьте двух свободных работников. Factory - часть определения корпорации, а Target World.Homeworld направляет её способность на собственный родной мир. При достаточном сырье каждый назначенный там работник дополнительно выпускает 0.5 сплава и расходует 1 минерал за ход.
Двое дают 1 Alloy и расходуют 2 Minerals сверх обычных потоков мира. Если сырья не хватает, полностью выполняются только обеспеченные производственные операции. Price позволяет торговать сплавом за существующую валюту. Природное месторождение и выбор ресурса при разведке разбираются в разделе генерации ресурсов.
Сохраните следующий полный массив в Logic/Alloy.json внутри мода. Название мода и modinfo.json оформляются как в первом примере руководства. Для названий ресурса и корпорации добавьте приведённый после массива словарь Text/ruRU.json.
[
["Alloy", "Is", "Resource"],
["Alloy", "Is", "Stat"],
["Alloy", "Is", "Predicate"],
["Alloy", "Name", "AlloyName"],
["Alloy", "Icon", "ore_iron"],
["Alloy", "Count", 0],
["Alloy", "Price", 4],
["Player", "Has", "Alloy"],
["NewAlloyCorp", "Is", "CorpMiner"],
["NewAlloyCorp", "Name", "NewAlloyCorpName"],
["NewAlloyCorp.Factory", "Target", "World.Homeworld"],
["NewAlloyCorp.Factory", "Production.Alloy", 0.5],
["NewAlloyCorp.Factory", "Cost.Minerals", 1]
]Файл Text/ruRU.json для варианта B:
{
"AlloyName": "Сплав",
"NewAlloyCorpName": "Производители сплава"
}После начала партии за «Производителей сплава» на панели ресурсов появится «Сплав». До назначения работников выпуск равен нулю. После назначения двух работников на родной мир проверьте доход сплава и расход минералов, затем завершите ход. Если заменить Production.Alloy 0.5 на 1, эти двое будут давать 2 сплава за ход при прежнем расходе 2 минерала.
Is Resource разрешает использовать имя нового материала в Income.Alloy, Production.Alloy, Upkeep.Alloy, Cost.Alloy, Growth.Alloy и Alloy.Count. Для этих составных форм отдельный Is Predicate не нужен. Он требуется, только если само Alloy используется как слово в средней позиции триплета.
Count - количество и его границы
Count задаёт число единиц запаса. Продолжим Alloy из предыдущей статьи: в его определении заменим начальное количество 10 на 12.
["Alloy", "Count", 12]В новой партии запас Alloy игрока начнётся с 12. У определения ресурса хранится исходное значение, а у каждого владельца - собственный изменяемый запас. Когда первый владелец тратит сплав, количество второго не меняется. Стартовые награды сценария применяются отдельно: например, к исходной воде могут добавиться ресурсы из части Start. В нашем примере сценарий Alloy не выдаёт.
Count на определении ресурса задаёт начальное количество, в том числе дробное. Count.Min и Count.Max задают его пределы; нижний предел Resource по умолчанию равен нулю. У каждого владельца свой запас: в условии он читается через Requires.Has.Minerals.Min, а при разовой выдаче меняется через Adds.Minerals.Count. Эти формы не задают ставку добычи минералов на мире.
["Water", "Count", 12],
["Minerals", "Count.Min", -1000],
["Credits", "Count.Max", 100000],
["Player", "Has", "Water"]Отрицательный минимум разрешает вынужденный долг, но не позволяет добровольно покупать без необходимых средств. Потеря и выдача соблюдают пределы; сообщение показывает фактическое изменение. Не путайте разные пределы: Count.Max ограничивает само количество, R.Max - вместимость данного ресурса у вещи. Workers.Max на игроке ограничивает общее население, а Workplaces на мире - число назначенных туда работников.
Count возможен и у самостоятельного нересурсного количества. Чтобы объект получил такое количество, добавьте его определение с Count в Has этого объекта. Игра создаст для него собственный экземпляр количества. Это не делает количество товаром, производством или валютой. Нельзя одновременно включить два несвязанных определения одного и того же унаследованного количества: чтение стало бы неоднозначным.
Production.Minerals на мире показывает выпуск минералов одним работником за ход. Minerals.Count в запасе игрока - уже накопленные минералы. Изменение Count не создаёт добычу и не назначает работников.
В старых и кратких примерах может встретиться Adds.Minerals без Count. Для существующего ресурса эта форма сохраняется, но Adds.Minerals.Count яснее показывает изменение запаса. Разовую выдачу применяет действие, старт сценария или исход выбора: сама строка в постоянном эффекте технологии запас не пополняет. Масштабированные награды одиночных событий разобраны в статье «Events и Event».
Workforce и FreeWorkers - работники и назначения
Работники принадлежат игроку общим пулом. Если их 10 и трое назначены на мир, свободно остаётся семь. Назначьте на мир ещё одного - свободных станет шесть. Перестановка людей ползунком меняет занятость уже имеющегося населения.
Is Workforce добавляется одному ресурсу работников. Общий запас принадлежит игроку. Назначения на мир, постройку или задачу занимают целых работников из этого пула, но не создают второе население. Дробная часть общего запаса сохраняется и пока не назначается. Уменьшение населения снимает назначения сверх доступного числа.
Workers - готовый общий ресурс людей; WorkersFree - вычисляемый остаток свободных. Фрагмент показывает существующее устройство основной игры. Для свободных людей не создают ещё один Resource/Count.
["Workers", "Is", "Resource"],
["Workers", "Is", "Predicate"],
["Workers", "Is", "Workforce"],
["WorkersFree", "Is", "FreeWorkers"],
["WorkersFree", "Is", "Predicate"],
["WorkersFree", "Is", "Stat"]WorkersFree показывает свободных работников: целую часть общего населения за вычетом занятых людей. В обычной игре торговля работников не занимает. Мод может изменить это отдельным правилом Rule.TradeWorker, разобранным в статье о правилах партии. Для WorkersFree не нужны Has, Resource и Count: значение доступно только для чтения. Применим его к знакомому доходу. Это дополнительная способность существующей технологии DeepExtraction, действующая после её исследования.
["DeepExtraction.FreeScience", "Per", "WorkersFree"],
["DeepExtraction.FreeScience", "Adds.Income.Science", 1]При 10 работниках и трёх назначениях на мир способность добавит 7 науки за ход. Если базовый доход равен 2, общий доход составит 9. Назначьте ещё одного свободного на мир: прибавка уменьшится до 6, а общий доход - до 8. Производство назначенных работников рассчитывается отдельно.
Workplaces - вместимость назначений
Места ограничивают число назначенных работников, но сами людей не добавляют. База мира 3 и аванпост с добавкой 8 дают 11 мест до остальных множителей и ограничений.
Сначала зададим собственные места мира. Следующая строка устанавливает базу категории World:
["World", "Workplaces", 3]У мира с этой базой до других правил есть три места. Прибавим места от готового аванпоста:
["Outpost", "Adds.Workplaces", 8]После строительства аванпоста к местам его мира прибавится 8: база 3 и постройка дают 11. Людей не становится больше - меняется возможность назначить уже имеющихся. Теперь выберем отдельный множитель колонистов:
["CorpColonist", "Multiplies.Workplaces", 1.4]Только в партии за CorpColonist эта сумма умножится на 1,4. Получается 11 × 1,4 = 15,4 до округления. Если дополнительно действуют контроль или иной предел назначения, доступное число может быть меньше. Подсказка и ползунок используют тот же действующий предел.
World - готовая категория миров, Outpost - строящийся аванпост Building/SurfaceBuilding, CorpColonist - выбираемая корпорация колонистов. Фрагмент правит существующие определения. Аванпост должен быть действительно построен; множитель корпорации действует только после её выбора.
["World", "Workplaces", 3],
["Outpost", "Adds.Workplaces", 8],
["CorpColonist", "Multiplies.Workplaces", 1.4]Adds.Workplaces на аванпосте добавляет места миру, где он построен. Людей это не создаёт; отдельного ползунка у каждой поверхностной постройки нет. Множитель без исходных мест не создаёт их из ничего. Блокада, контроль и максимум количества Workers могут дополнительно уменьшить доступные назначения. Если одновременно действуют несколько пределов, используется меньший.
Если у постройки нет собственного количества Workers, её рабочие места добавляются к миру, а людей назначают на мир. Если постройка имеет собственное количество Workers, назначения самостоятельны; её места второй раз к миру не прибавляются. Поэтому поверхностный аванпост и станция с собственными рабочими не должны получать один вклад дважды.
Production - выпуск трудом
Production - выпуск за труд назначенных работников. Ставка 0.5 означает пол-единицы продукта на человека за ход. Cost этой производящей способности задаёт сырьё на занятого работника, а не цену покупки фабрики.
Возьмём вариант B из статьи Resource: дополнительный выпуск сплава на родном мире корпорации NewAlloyCorp. Сначала отдельно прочитаем ставку выпуска. Это часть заготовки, которая целиком приведена ниже.
["NewAlloyCorp.Factory", "Target", "World.Homeworld"],
["NewAlloyCorp.Factory", "Production.Alloy", 0.5]Factory действует на собственном родном мире. Каждый назначенный туда работник дополнительно выпустит 0.5 сплава за ход: двое дадут 1, четверо - 2. Без назначений выпуска нет. Количество людей уже учтено в Production; добавлять Per Workers для тех же людей не нужно.
Теперь сделаем этот выпуск платным по сырью.
["NewAlloyCorp.Factory", "Cost.Minerals", 1]Cost здесь - расход на одного работника за ход. Двое тратят 2 минерала ради 1 сплава. Если заменить Production.Alloy 0.5 на 1, двое выпустят 2 сплава, а расход останется 2 минерала: цена назначена на работника, а не на единицу сплава. Ниже - полный вариант B. Если он уже добавлен из статьи Resource, повторять файл не нужно.
[
["Alloy", "Is", "Resource"],
["Alloy", "Is", "Stat"],
["Alloy", "Is", "Predicate"],
["Alloy", "Name", "AlloyName"],
["Alloy", "Icon", "ore_iron"],
["Alloy", "Count", 0],
["Alloy", "Price", 4],
["Player", "Has", "Alloy"],
["NewAlloyCorp", "Is", "CorpMiner"],
["NewAlloyCorp", "Name", "NewAlloyCorpName"],
["NewAlloyCorp.Factory", "Target", "World.Homeworld"],
["NewAlloyCorp.Factory", "Production.Alloy", 0.5],
["NewAlloyCorp.Factory", "Cost.Minerals", 1]
]Сохраните массив целиком в Logic/Alloy.json. Словарь Text/ruRU.json с названиями AlloyName и NewAlloyCorpName приведён в статье Resource. При создании партии выберите новую корпорацию и назначьте на родной мир двух работников. При достаточном сырье они дополнительно дают 1 сплав и тратят 2 минерала за ход. Проверяйте этот выпуск и расход в подсказках ресурсов и после завершения хода. Работников назначают ползунком мира.
Production.R со значением K означает выпуск K единиц ресурса R одним назначенным работником за ход. Ресурс должен быть объявлен. На мире это ставка его добычи; в способности фабрики - ставка дополнительного производства. При отсутствии работников выпуск равен нулю. Income, напротив, поступает без назначения людей, а Adds.R.Count меняет запас один раз.
Cost производственной способности задаёт затраты на работника, а не на единицу продукта. Поэтому удвоение Production.Alloy в примере удвоит выпуск, но не расход минералов. На мире Production.R задаёт ставку, а Production.R.Base добавляет к ней базовую прибавку.
Другая ситуация - постройка с собственными назначенными работниками. Разберём, откуда такой производитель берёт ставку. Это сравнение настроек существующей постройки MyLab; её объявление и строительство показаны в статье Building. В следующих двух опытах у мира ставка минералов 2, у постройки два собственных работника, других бонусов нет.
["MyLab", "Has", "Workers"],
["MyLab", "Workplaces", 2]Если у MyLab нет собственного Production.Minerals, её производитель использует ставку мира 2: двое назначенных ей работников выпускают 4 минерала за ход. Это именно люди постройки, а не повторный подсчёт работников мира. Собственная база мира участвует в унаследованной ставке, если она объявлена.
Теперь явно зададим постройке свою ставку.
["MyLab", "Production.Minerals", 0.5]Собственная ставка 0.5 заменяет ставку мира 2. Те же два работника MyLab дают 1 минерал за ход, а не 5. Число 0 тоже считается объявленной собственной ставкой; отсутствие поля отличается от нуля. Adds.Production.R и Multiplies.Production.R изменяют ставку, но людей не назначают. Production.R.Name, Description и Hide задают пояснение и показ свойства.
Отдельный опыт - поверхностная добавка без собственных работников. Для него уберите MyLab Has Workers из предыдущего варианта; у самого мира оставьте двух назначенных работников.
["MyLab", "Is", "SurfaceBuilding"],
["MyLab", "Production.Minerals", 0.5]Теперь MyLab не ведёт отдельное производство. Её 0.5 добавляется к ставке мира 2: двое работников мира дают 2 × (2 + 0.5) = 5 минералов за ход вместо 4. Вернуть MyLab собственное количество Workers - значит снова разделить производителей, а не сохранить эту добавку и ещё раз получить её отдельно. Дополнительный Per для подсчёта тех же людей не нужен.
До сих пор бонус действовал вместе с источником. Другой механизм один раз меняет уже существующие ставки. Для первого опыта у готового события SuppliesMinerals замените разовую выдачу минералов на изменение его явной цели; оставлять оба эффекта для опыта не нужно.
["SuppliesMinerals", "Target.Adds.Production.Minerals", 1]Если у выбранного тела ставка минералов была 2, после разового применения она станет 3. Изменён сам показатель тела; это не временный доход минералов игрока. Для срабатывания у события должны оставаться действительный запуск и выбор цели.
Перебор существующих ресурсов покажем отдельно при создании сценария. MyScenario наследует ScenarioG в статье о сценариях. Добавим ему разовую начальную правку: уменьшить только ставки строго больше 1.
["MyScenario.Poor", "Target.Adds.Production.Resource", -1],
["MyScenario.Poor", "Requires.Production.Resource.More", 1]У созданного тела было 3 минерала и 1 вода на работника за ход, добычи науки не было. После правки минералы станут 2; вода останется 1, потому что проверка строго больше 1; добыча науки не появится. Resource здесь перебирает уже существующие ставки, а Requires проверяет каждую отдельно. Краткое Target.Adds.Resource тоже перебирает существующую добычу без такой записи проверки. У постоянного бонуса Adds.Production.Resource не применяется: укажите конкретный ресурс.
Подсказка источника Production.R показывает ставку выпуска и применимые к ней бонусы. Запас ресурса, суммарные поступления и расходы за ход, пределы и прогноз находятся в подсказке самого запаса ресурса. Одна запись Production.R не создаёт у источника такой запас. Если ставка изменена модификаторами, подсказка показывает её базу, применённые изменения и итог.
Income - независимый приход за ход
Income - поступление за ход без назначения работников. Вот самостоятельная настройка дохода уже существующей науки:
["Science", "Income", 2]У каждого владельца запаса Science появляется доход 2 за ход. Если в начале было 10 науки и других потоков нет, после хода станет 12, ещё через ход - 14. Назначать работников для этого дохода не требуется.
Income.R задаёт собственное изменение ресурса за ход без назначенных работников. Число может быть положительным или отрицательным. На определении ресурса используется Income без имени R: [Science, Income, 2] даёт каждому владельцу такого запаса 2 науки за ход. Income без уточнения на произвольной вещи не заменяет Income.R.
Science уже входит в ресурсы игрока. Первый фрагмент задаёт его независимый доход. Второй меняет процентный доход корпорации CorpMagnate: Interest - часть её определения, а Per Credits читает деньги игрока, выбравшего магнатов. Никаких свойств планеты для этого дохода не требуется.
["Science", "Income", 2],
["CorpMagnate.Interest", "Per", "Credits"],
["CorpMagnate.Interest", "Adds.Income.Credits", 0.03]Per Credits и Adds.Income.Credits рассчитывают доход по целой части запаса. Multiplies.Income.Credits умножает положительные поступления. При этом отрицательный собственный Income и отдельное содержание Upkeep считаются по-разному. Рассмотрим два случая при запасе 100 кредитов, процентном доходе 0.03 от запаса и множителе дохода 1.1. Других поступлений и расходов в этих расчётах нет.
- Случай A: у самого игрока задан Income.Credits −2. Он складывается с процентным доходом 100 × 0.03 = 3, получая собственный поток +1. Положительный результат умножается на 1.1: итог (−2 + 3) × 1.1 = +1.1 кредита за ход.
- Случай B: отрицательного Income.Credits нет, вместо него у игрока задано отдельное содержание Upkeep.Credits 2. Доход 3 умножается на 1.1, затем вычитается содержание 2: итог 3 × 1.1 − 2 = +1.3 кредита за ход. Множитель дохода само содержание не увеличивает.
Таким образом, отрицательный Income задаёт слагаемое собственного потока, а Upkeep - отдельный расход содержания. Выбирайте запись по смыслу правила, а не только по знаку числа. Каждая способность сохраняет свои условия; снятие одного источника дохода не должно удалять остальные.
Upkeep - содержание за ход
Upkeep - расход на содержание за каждый ход. Сначала рассмотрим только готовый аванпост:
["Outpost", "Upkeep.Energy", 2]Каждому работающему аванпосту нужно 2 энергии за ход. Число положительное: Upkeep уже означает расход. Это не разовая цена строительства; цену записывают через Cost. Если энергии на работу не хватит, аванпост выключится.
Upkeep.R со значением N требует N единиц ресурса R за ход. Число неотрицательно: минус перед расходом писать не нужно. На постройке это расход, от которого зависит её работа; на игроке - его обязательное содержание. Для расхода на человека используются Per Workers и Adds.Upkeep.Water.
Теперь отдельное правило - расход воды на население. Player.WaterUpkeep - уже существующая часть определения игрока. Per Workers читает число его работников, а Adds.Upkeep.Water задаёт расход воды на каждого. При 10 работниках коэффициент 0,4 даёт спрос 4 воды за ход до остальных правил. Сравните это правило с постоянным расходом постройки:
["Outpost", "Upkeep.Energy", 2],
["Player.WaterUpkeep", "Per", "Workers"],
["Player.WaterUpkeep", "Adds.Upkeep.Water", 0.4]Starvation - существующая реакция на нехватку воды; её определение задаёт потерю работников. Blocks Upkeep.Water убирает сам расход воды, а Blocks Starvation предотвращает только потерю от голода. Hide скрывает строку в интерфейсе, сохраняя расход и его последствия.
Growth, Change и Threshold - рост и накопление
Сначала рассмотрим рост населения. В существующем режиме ModeHardcore за него отвечает часть Natural. Чтение точного количества работников уже знакомо по Per:
["ModeHardcore.Natural", "Per", "Workers.Count"],
["ModeHardcore.Natural", "Adds.Growth.Workers", 0.01]Если выбран этот режим, при населении 100 рост равен 100 × 0,01 = 1 работнику за ход до ограничений. При населении 50 - половине работника; дробь сохраняется в общем запасе. Growth описывает именно рост, а не число уже назначенных людей.
Другой вариант - рост одного ресурса вслед за потоком другого. Например, эти две строки на игроке связывают рост науки с его собственным потоком минералов:
["Player", "Growth.Science.Source", "Minerals"],
["Player", "Growth.Science.PerUnit", 0.1]Source называет ресурс-источник, PerUnit - коэффициент. При собственном потоке 10 минералов получается рост науки 1 до остальных правил. Оба ресурса должны принадлежать этому игроку. Торговые сделки источника не следует автоматически включать в этот расчёт: здесь читается его собственный поток, а не весь итог хода.
ModeHardcore - существующий выбираемый режим, Natural - его часть роста. При его выборе Per Workers.Count берёт точное население: 100 работников и коэффициент 0.01 дают исходный рост 1 за ход до ограничений. Для зависимого потока Growth.Science.Source и PerUnit задаются на объекте, которому принадлежат оба ресурса.
["ModeHardcore.Natural", "Per", "Workers.Count"],
["ModeHardcore.Natural", "Adds.Growth.Workers", 0.01]Change.R показывает итоговое изменение ресурса за ход с учётом торговли и задач. Его можно читать в условии или вставлять в текст обучения. Записывать Change.R или менять его через Adds нельзя: результат вычисляет игра. Предварительный показ учитывает полный спрос, а ход выполняет только обеспеченную работу. Поэтому при нехватке ресурсов фактическое изменение может отличаться от показанного.
Теперь отдельная задача: копить питательную среду Nutrients и тратить её на новых работников. Для этого сначала нужны объявленный ресурс, запас игрока и поступление среды. Следующий фрагмент содержит только эту подготовку:
["Nutrients", "Is", "Resource"],
["Nutrients", "Is", "Stat"],
["Nutrients", "Count", 0],
["Player", "Has", "Nutrients"],
["Player", "Income.Nutrients", 1]Nutrients - новое имя ресурса. Он начинается с нуля и получает одну единицу за ход: после двух ходов будет 2. Пока ни одна из этих строк новых людей не создаёт. Для обмена накопленного запаса на работника нужны ещё две:
["Player", "Threshold.Nutrients", 3],
["Player", "Threshold.Nutrients.Grows", "Workers"]Threshold задаёт порог 3, Grows называет получаемый ресурс Workers. Когда накопится 3 Nutrients, игра потратит их и добавит одного работника. Если накопилось больше порога, остаток сохранится; пока запаса хватает, проверка повторяется, но не превышает максимум Workers.
После каждого пересечения порог равен max(старый + 1, floor(старый × Increasing)); Increasing по умолчанию 1, поэтому даже при нём пороги растут: 3, 4, 5… Это не цена и не Goal. Нужны объявленный Resource, его количество у игрока и поток. Отрицательный баланс такого накопителя не используйте для новой системы наказаний: для жизнеобеспечения предусмотрен Shortage.
["Nutrients", "Is", "Resource"],
["Nutrients", "Is", "Stat"],
["Nutrients", "Count", 0],
["Player", "Has", "Nutrients"],
["Player", "Income.Nutrients", 1],
["Player", "Threshold.Nutrients", 3],
["Player", "Threshold.Nutrients.Grows", "Workers"],
["Player", "Threshold.Nutrients.Increasing", 1]В обычной партии с работниками, без иных потоков Nutrients и ограничений роста, на третьем таком ходе добавится один работник, запас Nutrients станет нулём, следующий работник потребует четыре единицы. Name и Icon ресурса оформляются обычным способом; механика от перевода не зависит.
Price и Trade - курсы и торговля
Сначала зададим базовую цену товара. Minerals - уже существующий ресурс, валютой основной игры служат Credits:
["Minerals", "Price", 1]Базовая цена одного минерала - один кредит. Одна эта строка ничего не покупает. На цену покупки дополнительно влияет общий коэффициент:
["Trade", "Price.Buy", 1.2]При отсутствии личных скидок покупка одного минерала будет стоить 1 × 1,2 = 1,2 кредита. Для продажи есть отдельный коэффициент:
["Trade", "Price.Sell", 0.8]Продажа одного минерала принесёт 0,8 кредита. Разные курсы покупки и продажи означают, что продажа и немедленная обратная покупка убыточны. Price на другом ресурсе задавал бы базу именно того товара.
Чтобы сделка действительно выполнялась, игрок задаёт заявку на экране торговли. Заявка «купить 2 минерала» повторяется каждый ход: при цене 1,2 это спрос на 2,4 кредита за ход. Количество заявки и цена - независимые величины. Если денег или товара не хватает, выполняется обеспеченная часть.
Price на ресурсе задаёт базовую цену его единицы в валюте. Без Price ресурс не участвует в торговле; цена 0 всё ещё допускает торговлю. Trade.Price.Sell и Trade.Price.Buy задают общие коэффициенты продажи и покупки. Price.R и Price.R.Sell или Price.R.Buy уточняют цену конкретного ресурса у игрока. Если ресурс назван Buy или Sell, его имя всё равно остаётся именем ресурса там, где конструкция ожидает ресурс.
Теперь ограничим объём одной товарной строки. Все расчёты ниже предполагают достаточно товара и валюты; ограничения запасов разберём отдельно.
["Trade", "Count.Max", 4]При лимите 4 покупка шести минералов за ход недопустима: заявка ограничится четырьмя. С уже разобранным курсом 1.2 эта строка купит 4 минерала за 4.8 кредита. Изменение лимита не меняет цену единицы товара.
Поднимем лимит за счёт одного реально построенного аванпоста игрока.
["Outpost", "Adds.Trade.Max", 3]Один принадлежащий игроку Outpost даёт лимит 4 + 3 = 7. Теперь можно заново выставить заявку на 6 минералов: она купит 6 за 7.2 кредита. Непостроенный аванпост в меню лимита не даёт; изменение лимита не обязано восстановить прежнюю обрезанную заявку само.
Отдельно изменим курс покупки у магнатов. Лимит здесь не меняется.
["CorpMagnate", "Adds.Trade.Price.Buy", -0.24]У игрока, выбравшего CorpMagnate, коэффициент покупки 1.2 становится 0.96. При базовой цене минералов 1 и отсутствии других поправок шесть минералов стоят 6 × 0.96 = 5.76 кредита вместо 7.2. Это скидка к курсу, а не ещё три единицы торговой вместимости. Ниже настройки собраны вместе.
["Minerals", "Price", 1],
["Trade", "Price.Sell", 0.8],
["Trade", "Price.Buy", 1.2],
["Trade", "Count.Max", 4],
["Outpost", "Adds.Trade.Max", 3],
["CorpMagnate", "Adds.Trade.Price.Buy", -0.24]Курс равен базовой цене товара, умноженной на общий коэффициент покупки или продажи и личный коэффициент этого товара. Объём задаётся отдельно: Trade.Count.R на игроке - его заявка на каждый ход. Положительное число означает покупку, отрицательное - продажу, ноль останавливает заявку. Одно изменение Price ничего не покупает. Игрок задаёт заявки на экране торговли.
Count.Max на Trade задаёт предел одной товарной строки. Trade.Max читает его и личные вклады с округлением вверх. Без предела объём не ограничен этой границей. Заявка приводится к целому и ограничивается лимитом. Потеря родного мира сама по себе не запрещает торговлю. Старые поля Trade.R и Trade.Sell/Buy.Mult не используются.
Остаётся вопрос оплаты нескольких строк. Для отдельного опыта возьмём два товара с базовой ценой 1 и уже знакомые общие курсы. Это условие расчёта, а не изменение всех товаров игры. На экране торговли зададим продажу трёх единиц первого товара и покупку двух второго.
["Trade", "Price.Sell", 0.8],
["Trade", "Price.Buy", 1.2]Без личных поправок продажа трёх даст 2.4 кредита. Продажи обрабатываются до покупок, поэтому даже при начальном нуле кредитов эти 2.4 оплатят две покупаемые единицы по 1.2. Если на продажу есть только две единицы, поступит 1.6 кредита: их хватит на одну целую покупаемую единицу, а не на две. Выполняется обеспеченная часть заявки.
Control - доля доступных мест
Control.Here ограничивает долю доступных рабочих мест. Рассмотрим черту OccupiedSector:
["OccupiedSector", "Is", "Trait"],
["OccupiedSector", "Control.Here", 0.5]Когда объект получает такую черту, доступна половина его рабочих мест. Из 11 остаётся 5 после округления вниз. Люди при этом не исчезают: уменьшается число допустимых назначений. При снятии черты обычная доступность возвращается. Ниже добавим черту готовому классу TinyRock.
Control.Here задаёт доступную долю рабочих мест числом от 0 до 1. При нескольких ограничениях используется наименьшая доля, а количество мест округляется вниз. Значение 0 закрывает работу, 1 сохраняет все места. Если Control.Here задано у черты, ограничение действует на вещь, которой эта черта присоединена.
OccupiedSector - объявленная здесь черта, TinyRock - готовый класс каменных миров. Has присоединяет её к новым телам этого класса. Без Has или событийной выдачи Marks отдельный Is Trait не изменит контроль ни на одном мире.
["OccupiedSector", "Is", "Trait"],
["OccupiedSector", "Control.Here", 0.5],
["TinyRock", "Has", "OccupiedSector"]Control.Rating - отдельная оценка от 0 до 6; это не доля мест. Одно слово Control без уточнения не задаёт ни оценку, ни долю. Is Trait только объявляет черту: для действия её нужно присоединить через Has или выдать правилом. После снятия последнего ограничения вместимость восстанавливается сама.
Approval и Expectations - одобрение и ожидания
Сначала рассмотрим само одобрение совета. Approval - существующий ресурс; его Count задаёт начальный запас доверия:
["Approval", "Count", 3]Игрок начинает с трёх единиц одобрения. Их потеря до нижней границы вызывает предусмотренное игрой поражение. Это запас, который меняется результатами заданий, а не число заданий, выполненных за партию. Теперь отдельно зададим ожидания совета:
["Approval", "Expectations", 1]Ожидания хранятся у количества Approval и начинаются с 1. Они определяют строгость следующей оценки. При успехе готовый исход BoardPleased может их повысить:
["BoardPleased", "Approval.Judgment", 0.5]При ожиданиях 1 такой успех поднимает их до 1,5. Само зачисление одобрения задаётся отдельно. Для провала рассмотрим другую строку:
["BoardDispleased", "Approval.Judgment", -1]Провал сначала снимает одобрение по текущим ожиданиям, затем уменьшает ожидания на 1, но не ниже 1. Например, при ожиданиях 2 игрок теряет 2 одобрения, а новые ожидания равны 1. Теперь можно собрать все четыре независимые настройки в один пример ниже.
Approval - ресурс одобрения совета. Его начальное значение и границы задаются как у остальных количеств. Достижение нижней границы у игрока вызывает поражение с реакцией Defeat из Has одобрения. Expectations на самом количестве Approval - ожидания совета, конечное число не меньше единицы, по умолчанию минимум один.
BoardPleased и BoardDispleased - готовые исходы заданий совета. Judgment 0.5 при успехе повышает ожидания, например с 1 до 1.5. При Judgment −1 провал сначала снимает одобрение по текущим ожиданиям, затем уменьшает их на 1 с минимумом 1: при ожиданиях 2 теряется 2 одобрения, ожидания становятся 1. Само успешное зачисление Approval задаётся отдельно от Judgment.
["Approval", "Count", 3],
["Approval", "Expectations", 1],
["BoardPleased", "Approval.Judgment", 0.5],
["BoardDispleased", "Approval.Judgment", -1]Положительный Approval.Judgment увеличивает будущие ожидания. Отрицательный исход снимает одобрение по текущим ожиданиям и затем уменьшает ожидания на объявленную величину, сохраняя минимум один. Это не то же самое, что простая Adds.Approval.Count: прибавка меняет запас, Judgment описывает оценку совета. У разных владельцев независимые ожидания. Произвольное поле Expectations на игроке не заменяет свойство его количества Approval.
TechLevel - технологический уровень места
Начнём с числового описания мира. Для авторской Земли в сценарии «Солнечная система» оно задаётся так:
["Earth", "TechLevel", 8]Земля получает описательный уровень 8. Эта строка не изучает технологии игрока. Для положения технологии в дереве используется Tier, а для повторных исследований - Level. Дальше добавим к уже заданному TechLevel переводимую подпись.
TechLevel = N задаёт числовой технологический уровень поселения или другого объекта с этим свойством. Tier указывает положение технологии в дереве, а Level считает завершённые повторные исследования. Само изменение TechLevel не изучает технологии игрока и не открывает автоматически все постройки.
В следующем фрагменте авторская Земля Earth получает уровень 8. Она существует в сценарии Солнечной системы; на случайной карте этот фрагмент Землю не создаст. MyDigitalAge - придуманное имя правила подписи для уровня не ниже 8. Добавьте в Text/ruRU.json ключ MyDigitalAgeName со значением «Цифровая эпоха». Это описание мира, а не выдача технологий игроку.
["Earth", "TechLevel", 8],
["MyDigitalAge", "Grants", "TechLevel"],
["MyDigitalAge", "Requires.TechLevel.Min", 8],
["MyDigitalAge", "TechLevel.Text", "MyDigitalAgeName"]Условный вариант дополняет уровень подписью из перевода. Без подходящей черты показывается само число, при нескольких активных подписях они перечисляются. Число и описательные последствия должны оставаться отдельными фактами. Для обычной модификации стоимости исследования используйте Cost.Research, для его кратности Repeatable и Level, а не TechLevel.
Порядок расчёта хода и дефицит
В начале хода добыто 4 минерала. Затем торговая заявка продаёт 2 из них и получает деньги. После торговли оплачиваются содержание и взнос задачи. Если на взнос не хватает хотя бы одного ресурса, задача ждёт. Далее «обеспеченная операция» означает ту часть работы или торговли, для которой действительно хватает ресурсов.
Общий порядок: приход всех ресурсов, торговля, содержание, процессы, жизнеобеспечение. Продажа видит добычу текущего хода, содержание видит результат торговли. Собственный обязательный расход игрока резервируется до отключаемых потребителей. Нехватка одного ресурса оплаты может остановить целый шаг задачи без частичного списания других ресурсов. Рабочее производство и торговля выполняются обеспеченными единицами.
Предварительный расчёт показывает разность всех планируемых поступлений и расходов, даже если часть работы пока нечем оплатить. Отрицательное число предупреждает о дефиците. Оно не означает, что ресурс обязательно уйдёт в минус: запрещённый долг не возникает. История и сообщения показывают фактически выполненные изменения. Дополнительные копии доходов и расходов для исправления этой разницы не нужны.
Действия, строительство и исследования
Cost - цена и её масштаб
Начнём с цены одного действия в одном ресурсе. Полный файл Logic/ExplorePrice.json:
[
["Explore", "Cost.Minerals", 5]
]Cost.Minerals означает цену в минералах. База разведки равна 5; скидки и надбавки могут изменить её в конкретном месте. Это плата за действие, в отличие от курса торговли Price и содержания за ход Upkeep. Цена не может быть отрицательной.
Действие, созданное данными, может требовать два ресурса одновременно. Возьмём уже созданное ExchangeWater из статьи Action и сначала зададим только воду:
["ExchangeWater", "Cost.Water", 20]При такой цене обмену нужно 20 воды. Дополнительная строка требует ещё и энергию:
["ExchangeWater", "Cost.Energy", 5]Теперь нужны одновременно 20 воды и 5 энергии: они не заменяют друг друга. Это возможность действий, созданных данными, и вариантов событий. Готовые Build, Research, Explore, Colonize, GeoSurvey и Probe читают один прямой ресурс цены. Не переносите на них автоматически пример двухресурсного ExchangeWater.
Стоимость повторного использования можно увеличивать отдельно. Следующая строка относится к тому же действию:
["ExchangeWater", "Cost.Multiplies", 1.5]Для первого обмена нужны 20 воды и 5 энергии. После попытки цена следующего становится 30 воды и 7.5 энергии до действующего округления; следующая попытка снова умножит цену на 1.5. Это не бонус к получаемым минералам. Историю применений ведёт сама игра; новая плашка варианта события начинает свою историю с исходной цены. Процентную цену Invest разберём отдельно.
Invest - существующий вариант вложения в эксперимент. Разберём только минеральную часть его цены; у готового варианта сохраняется также цена в кредитах. Для первого опыта оставим в минералах только десять процентов: если ранее меняли его прямую или масштабированную минеральную цену, уберите эти добавки.
["Invest", "Cost.Minerals.Percent", 10]При 100 минералах в момент выдачи предложения процентная часть цены равна 10 минералам. При 20 - равна 2 минералам. Эти числа сохраняются у предложения; позднее получение минералов само эту часть цены не увеличивает. Положительный процент даёт как минимум одну единицу, даже если расчёт меньше единицы. Кредитная цена Invest оплачивается отдельно.
Теперь введём явный минимум три минерала.
["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]При исходном запасе 20 процент дал бы 2 минерала, но Min повышает минеральную часть до 3. При запасе 100 процент даёт 10: минимум не мешает, минеральная часть остаётся 10. Минимум - нижняя граница, а не дополнительный платёж. Цена кредитами от этого не исчезает.
Добавим к той же процентной цене обычную составляющую в пять минералов.
["Invest", "Cost.Minerals", 5],
["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]При исходном запасе 20 сначала складываются 5 и 2 минерала, получается 7. Затем применяется Min 3, поэтому минеральная часть остаётся 7. Минимум ограничивает сумму, а не каждую составляющую по отдельности. Кредиты по-прежнему нужно оплатить отдельно.
В следующей версии вместо прямой цены 5 минералов используется Scaled. Процент и минимум сохраняются.
["Invest", "Cost.Minerals.Scaled", 0.5],
["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]При масштабе 20 и запасе 20 масштабированная часть равна 10 минералам, процентная - 2. Всего 12 минералов, что выше минимума 3. Если оставить ещё и прямую минеральную цену 5, она тоже войдёт в сумму: получится 17 минералов. Кредитная цена сохраняется. Далее приведена короткая сборка обмена и первоначальной процентной версии Invest; это не требование оставить все учебные варианты сразу.
У существующей разведки цена записывается на Explore через Cost.Minerals. В примере ниже используются ещё две операции: ExchangeWater - действие обмена из статьи Action, а Invest - существующий вариант вложения средств в эксперимент. Сначала добавьте полное определение ExchangeWater из следующей статьи; одни строки цены новую кнопку не создадут.
Cost.R со значением N требует заплатить N единиц объявленного ресурса R. Цена неотрицательна. Ноль явно задаёт бесплатность; отсутствие цены не всегда равнозначно нулю - некоторые действия без цены недоступны. Действия, созданные данными, и варианты событий могут требовать несколько ресурсов сразу. Готовые Build, Research, Explore, Colonize, GeoSurvey и Probe читают один прямой ресурс цены.
Этот фрагмент заменяет цену ExchangeWater: обмен требует 20 воды и 5 энергии, а каждая следующая попытка дорожает в 1.5 раза. У Invest цена минералами становится процентной с минимумом 3. Новые значения применяются к уже определённым операциям.
["ExchangeWater", "Cost.Water", 20],
["ExchangeWater", "Cost.Energy", 5],
["ExchangeWater", "Cost.Multiplies", 1.5],
["Invest", "Cost.Minerals.Percent", 10],
["Invest", "Cost.Minerals.Min", 3]- Cost.R.Scaled K: цена по расчёту Scaled. Cost.R.Percent N: N процентов запаса при выдаче, минимум единица для положительной процентной величины. Cost.R.Min ограничивает снизу сумму обычной, процентной и масштабированной цены одного ресурса.
- Cost.Target = Parent: вариант платит объявленную цену своей исходной плашки. Цена должна существовать у события, а не угадываться по имени варианта.
- Cost.R.PerTurn N: регулярный расход в поддерживаемом контексте. Для постоянного содержания построек используйте Upkeep.R. Cost.R рядом с Production в производственной способности - сырьё на одного работника, а не цена покупки.
- Cost.R.PerValue K: цена за единицу добавляемого груза у варианта с Contains.Target и объявленной прибавкой. Без такой прибавки эта форма недопустима.
- Cost.Multiplies K: коэффициент следующего использования действия или варианта. Историю цены хранит реальный носитель применения, новая плашка начинает с исходной цены. Это не разовый множитель дохода.
Скидка задаётся множителем: Multiplies.Cost.Build меняет стоимость строительства, Multiplies.Cost.Research - исследования, Multiplies.Cost.Building - построек, Multiplies.Cost.Outpost - аванпостов. Это разные наборы покупок. Cost.Build.Hot и Cost.Build.Distance — отдельные ценовые оси жары и удалённости. Прямой Multiplies.Cost.Build.Distance умножает полный коэффициент этой оси: коэффициент 1,6 при множителе 0,7 становится 1,12. Это отличается от ослабления черты через Multiplies.RemotenessTrait; его формулу и пример разбирает статья Multiplies. Множитель цены не сокращает длительность. Если имя ресурса совпало с именем действия, смысл определяется тем, что описывает запись: цену покупки этим ресурсом или бонус к стоимости действия.
Проверяйте модифицированную цену в подсказке действия: она показывает базовую цену, реально применённые модификаторы и итог после округления и ограничений. У выполняющегося процесса показывается оставшаяся неоплаченная цена, а не новая полная покупка. Без модификаторов одинаковые база и итог не повторяются. Итоговая цена уже учитывает показанную скидку; не вычитайте её второй раз.
Action - действие, заданное данными
Создадим действие «Обменять воду». Начнём с его объявления:
["ExchangeWater", "Is", "Action"]ExchangeWater - новое имя, Action - существующая роль действия. Пока мы лишь объявили, что это действие; ещё не задали, где его предложить и что оно сделает. Предоставим его мирам:
["World", "Able", "ExchangeWater"]Able означает способность выполнить действие. Когда игрок выбирает подходящий World, игра может предложить ему ExchangeWater. Следующим шагом зададим уже знакомые цену и разовую выдачу:
["ExchangeWater", "Cost.Water", 5],
["ExchangeWater", "Adds.Minerals.Count", 3]При выполнении игрок платит 5 воды и получает 3 минерала. Это разовая операция: доход за ход не меняется. В режиме с длительными действиями результат будет выдан после завершения задачи; её базовый срок ниже задан отдельно через Processing.Duration. Теперь соберём действие с названием и значком.
ExchangeWater - придуманное имя нового действия. Фрагмент ниже добавьте в массив Logic-файла, а в Text/ruRU.json запишите ключ ExchangeWaterName со значением «Обменять воду». Значок ore_iron уже есть в игре. Если ранее добавляли пример цены из статьи Cost, выберите нужную цену обмена: она не должна случайно остаться в двух разных файлах.
Новому действию нужна хотя бы цена или ненулевая разовая выдача: одно Is Action не объясняет, что оно делает. Able определяет, где доступна кнопка, а Requires - когда её можно нажать. Для действия определённой корпорации укажите Requires.Corporation. Прикреплять само действие через Corporation Has не нужно: действие предоставляется местом, а корпорация проверяется как условие.
["World", "Able", "ExchangeWater"],
["ExchangeWater", "Is", "Action"],
["ExchangeWater", "Name", "ExchangeWaterName"],
["ExchangeWater", "Icon", "ore_iron"],
["ExchangeWater", "Cost.Water", 5],
["ExchangeWater", "Adds.Minerals.Count", 3],
["ExchangeWater", "Processing.Duration", 1]Начните новую партию, выберите мир и найдите кнопку обмена. После выполнения у игрока станет на 5 воды меньше и на 3 минерала больше, если пределы запасов это допускают. Processing.Duration задаёт базовый срок; режим может сделать действие мгновенным. Для кнопки, доступной без выбора мира, предоставьте действие игроку вместо места.
Если добавить Requires.Corporation CorpRobots, пользоваться им смогут только роботы. Необязательный Chance задаёт риск провала; без него риск равен нулю. Неудачный исход включается через Has и отмечается Failure. Даже неудачная попытка может повысить цену следующей.
Увеличим только награду минералами после каждой попытки. Начните с исходного обмена: цена 5 воды, награда 3 минерала, без других коэффициентов повторения. Добавьте одну строку.
["ExchangeWater", "Adds.Minerals.Count.Multiplies", 2]Первая успешная попытка выдаст 3 минерала, вторая - 6, третья - 12 до границ запаса. Каждая стоит прежние 5 воды: рост награды не повышает цену. Множитель продвигается после попытки, поэтому первая награда ещё не удвоена.
Чтобы отличить рост одного ресурса от общего, добавим обмену вторую награду.
["ExchangeWater", "Adds.Energy.Count", 1]С прежним множителем минералов первая награда составит 3 минерала и 1 энергию, вторая - 6 минералов и ту же 1 энергию. Энергия не названа в Adds.Minerals.Count.Multiplies, поэтому не растёт.
Теперь заменим множитель минералов общим: уберите Adds.Minerals.Count.Multiplies 2 и оставьте следующую строку вместо него.
["ExchangeWater", "Adds.Multiplies", 2]Первая успешная попытка по-прежнему даст 3 минерала и 1 энергию. Вторая даст 6 минералов и 2 энергии: общий коэффициент увеличивает обе выдачи. Он задаётся числом; диапазон Random здесь не поддерживается.
Осталось различие между попыткой и успешным получением. Для отдельной проверки провала добавим обмену неуспешный исход и стопроцентный риск. Это учебный вариант, а не полезный обмен для партии.
["ExchangeWater", "Chance", 100],
["ExchangeWater", "Has", "ExchangeFailed"],
["ExchangeFailed", "Is", "Event"],
["ExchangeFailed", "Is", "Failure"],
["ExchangeWater", "Cost.Multiplies", 2]Первая попытка стоит 5 воды и проваливается без награды. Несмотря на это, вторая стоит 10 воды, а её потенциальная награда уже равна 6 минералам и 2 энергии. При прежнем риске она снова провалится; если для проверки следующую попытку сделать успешной, выдаст именно эти количества. Истории цены и награды продвигаются после попытки независимо от её успеха. Чтобы вернуться к фиксированному обмену, уберите все строки этого опыта, а не добавляйте их к постоянному рецепту.
Building, Project, Upgrade - строимые вещи
Сначала объявим, что MyLab - постройка:
["MyLab", "Is", "Building"]Building относит объект к постройкам и позволяет общим правилам строительства работать с ним. Но эта строка ещё не задаёт место, цену и результат. Следом уточним, что лаборатория находится на поверхности:
["MyLab", "Is", "SurfaceBuilding"]SurfaceBuilding - поверхностная постройка. У орбитальной вместо неё была бы роль Orbital. Теперь можно добавить знакомые по Requires и Cost ограничения места, технологию и цену, затем доход и содержание готовой лаборатории. В полном примере ниже эти части собраны вместе.
MyLab ниже - новая поверхностная лаборатория. World - планета, OutpostConstruction - готовая технология аванпостов. После её изучения лабораторию строят за минералы: готовая постройка даёт доход науки и требует энергию. Работников этот рецепт сам не создаёт. MyLabName переведите как «Лаборатория».
SurfaceBuilding обозначает поверхностную постройку, Orbital - орбитальную. В Requires указывают технологию, подходящие категории места и, для Upgrade, непосредственную базу улучшения. Технологию проверяют у игрока, место - у выбранного тела. В качестве категорий места подходят существующие World, Giant, Asteroid, Earthlike и другие объявленные категории.
["MyLab", "Is", "Building"],
["MyLab", "Is", "SurfaceBuilding"],
["MyLab", "Name", "MyLabName"],
["MyLab", "Icon", "outpost"],
["MyLab", "Requires", "World"],
["MyLab", "Requires", "OutpostConstruction"],
["MyLab", "Cost.Minerals", 15],
["MyLab", "Duration", 2],
["MyLab", "Income.Science", 1],
["MyLab", "Upkeep.Energy", 1]В новой партии изучите OutpostConstruction и выберите мир: лаборатория станет доступна для строительства. Она стоит 15 минералов, после завершения даёт 1 науку за ход и требует 1 энергию. Duration 2 задаёт базовые два хода строительства, а не срок жизни готового здания. Фактический срок зависит от режима. У обычных действий срок задаётся Processing.Duration; в этом рецепте его вместо Duration не используют. До исследования лаборатория видна, но недоступна. Нулевую цену, если она нужна, указывайте явно.
Project - другой результат строительного проекта. Например, классификация нового MyProject могла бы начинаться так:
["MyProject", "Is", "Project"]Это только фрагмент классификации, не законченный проект. Project тоже использует строительную цену и процесс, но не считается Building: скидка именно на Building его не обязана затронуть. У лаборатории остаётся Is Building.
Дополнительный Is Unique ограничивает одновременные экземпляры постройки. SpaceStation - семейство орбитальных станций; его варианты могут предлагаться отдельно. Для появления лаборатории среди строительных вариантов не требуется Player Has MyLab. Если выбранное место имеет Blocks MyLab или блокирует её категорию, строительство запрещено даже при выполнении требований места через Or.
В условиях можно читать Build - набор доступных здесь построек - и Build.Cost - цену самой дешёвой из них при одном ресурсе цены. Explore.Cost читает текущую цену разведки. Это вычисляемые сведения, а не настройки цены. Например, Target.Build HQ отбирает места, где действительно можно построить штаб; все требования штаба в самом задании повторять не нужно.
Пример существующего улучшения основной игры: HQ - штаб, Metropolis - его улучшение до мегаполиса. Metropolis уже объявлен Building/SurfaceBuilding, имеет технологию, цену и эффект. Две записи ниже показывают именно обязательную базу улучшения, а не объявляют новую пустую постройку:
["Metropolis", "Is", "Upgrade"],
["Metropolis", "Requires", "HQ"]Игроку нужен свой готовый HQ в том же месте; улучшение заменяет одну такую базу, не чужой штаб и не любой предыдущий объект. Обычный MyLab без Upgrade ничего не заменяет.
Tech, Researching и Repeatable - исследование
Сначала объявим MyStudy технологией, затем включим её в дерево игрока. Это две разные строки:
["MyStudy", "Is", "Tech"],
["Player", "Has", "MyStudy"]Is Tech задаёт роль, Player Has добавляет технологию в набор каждого игрока. Один игрок может изучить её, другой оставить неизученной. Добавим бонус, который включится только после завершения исследования:
["MyStudy", "Adds.Income.Science", 1]Первое изучение добавит 1 науку за ход. Чтобы разрешить второе изучение той же технологии, нужна отдельная настройка:
["MyStudy", "Repeatable", true]Теперь завершённый второй уровень добавит ещё 1: суммарно технология даст 2 науки за ход. Пока второй уровень ещё исследуется, первый продолжает работать. Следующий полный набор строк добавляет название, значок и предшественника; эти свойства не заменяют Repeatable.
Добавим «Полевые исследования», MyStudy. Сначала потребуется изучить существующую OutpostConstruction. Затем каждый завершённый уровень новой технологии будет добавлять 1 науку за ход. Фрагмент ниже добавьте в Logic, а ключ MyStudyName со значением «Полевые исследования» - в Text/ruRU.json.
Is Tech объявляет вид вещи, Player Has включает технологию в дерево каждого игрока. У каждого получается свой экземпляр с собственным исследованием. Requires задаёт предшественников, Or - их альтернативы, Tier и Order - положение в дереве. Постоянные Adds и Multiplies действуют после исследования, включая бонусы будущим подходящим владениям. Разовую награду такое объявление технологии не выдаёт.
["MyStudy", "Is", "Tech"],
["MyStudy", "Name", "MyStudyName"],
["MyStudy", "Icon", "flask"],
["MyStudy", "Tier", 2],
["MyStudy", "Requires", "OutpostConstruction"],
["MyStudy", "Adds.Income.Science", 1],
["MyStudy", "Repeatable", true],
["Player", "Has", "MyStudy"]Researching - состояние экземпляра InProgress или Done. Отсутствие означает, что первое изучение не начато. Не задавайте Done в исходном определении, чтобы имитировать стартовую технологию. Repeatable - логическое разрешение повторного изучения, собственное false сильнее наследованного true. Level хранит число завершённых изучений. Во время повторного исследования прежние уровни продолжают действовать. Отмена первого снимает статус, отмена повторного сохраняет прежние завершённые уровни.
Технология может не иметь числовых Adds или Multiplies. Достаточно Is Tech, включения в Player.Has и необходимых имени, иконки, положения и цены исследования. Её единственным результатом может быть доступ к событию или миссии: на открываемой карте укажите Requires.Researched со ссылкой на эту технологию. Если у карты есть Name, описание эффекта технологии автоматически показывает «Разблокирует событие» с её именем. У безымянной вложенной колоды отдельной такой строки нет. Дополнительный фиктивный бонус или копия списка разблокировок не нужны.
Цена по умолчанию берётся из Cost.R действия Research, рост - из его Cost.Multiplies. После каждого завершённого исследования игрока, включая повторное, коэффициент больше единицы умножает уже округлённую базовую цену. При базе 10 и коэффициенте 1.23 получаются 10, 13, 16, 20. Личные скидки применяются после этого и не уменьшают базу следующего шага. Собственные Cost.R и Cost.Multiplies технологии заменяют соответствующие настройки Research. Без роста или при коэффициенте не больше 1 база остаётся прежней. Tier на цену не влияет.
Rule.AccumulatedResearch true включает оплату накопленным запасом: выбранная технология ждёт действующей цены науки, затем списывает её целиком. Отмена сохраняет запас. В обычном режиме Research платит и завершает изучение сразу. Researching.Steps - вычисляемое минимальное число изучений до цели, включая саму технологию и общий путь предпосылок. Его не задают вручную. Событие после исследования связывается Then, а не разовой наградой в Tech.
Собственный Description технологии поясняет её в тултипе. Текст сообщения после изучения хранится на отдельной реакции, подключённой через Has. Для MyStudy добавьте рядом с её существующим определением следующие строки:
["MyStudy", "Description", "MyStudyHelp"],
["MyStudy", "Has", "MyStudyResearched"],
["MyStudyResearched", "Is", "TechResearched"],
["MyStudyResearched", "Description", "MyStudyCompleted"]Добавьте MyStudyHelp и MyStudyCompleted в словарь Text мода. Первый ключ поясняет технологию до изучения, второй содержит сообщение о завершении. TechResearched — готовая реакция базовой игры на Completed со стандартным оформлением и звуком. MyStudyResearched — выбранное для примера имя реакции, а не обязательный суффикс. Связь задаётся через Has, а Notifies Completed наследуется через Is. Это сообщение не выдаёт бонус технологии повторно.
Предпросмотр разблокировки строится из обычных определений, без отдельного текста эффектов. У постройки он показывает результат под заголовком «После постройки», у улучшения — разницу с его непосредственной базой. Для открываемого действия показываются объявленные прибавки и базовая цена. Если технология меняет действие с единой базовой ценой, подсказка сравнивает цену до и после исследования; у повторяемой технологии — после следующего уровня. Учтены текущие бонусы игрока, но не надбавки конкретного мира. Из скидки на категорию построек или силу черты без конкретной покупки не выводится единая цена для всех случаев.
Processing и Duration - задачи и сроки
Начнём с настройки срока уже созданного ExchangeWater из статьи Action. Эта строка задаёт базовые три хода выполнения:
["ExchangeWater", "Processing.Duration", 3]В режиме с длительными действиями обмен создаст задачу, а ресурсы результата будут выданы после её завершения. Мгновенный режим может сократить фактический срок до нуля. Цена действия по-прежнему задаётся через Cost: Processing.Duration её не меняет.
Когда задача уже создана, у места работы появляется ссылка Processing. Следующий блок - только пример чтения состояния партии, его не записывают в мод:
["Earth_0", "Processing", "Construction_0"],
["Construction_0", "Progress", 2]Первая строка говорит: на Earth_0 есть задача Construction_0. Вторая: у этой задачи выполнено 2 шага работы. Это не два новых срока и не два созданных здания. Processing - связь с задачей, Progress - её уже выполненная работа, а Duration был настройкой требуемого срока. Имена живых экземпляров в другой партии могут отличаться.
У длительной задачи Progress считает выполненные шаги. Оплаченные ресурсы хранятся отдельно; задача с трудом работников может учитывать накопленный ресурс и порог. Прошедшие ходы не равны выполненной работе: без нужной оплаты задача ждёт. У событий Progress применяется и к шкалам противостояния - это разобрано в отдельной статье.
Чем заканчивается отсчёт, зависит от описываемой вещи. Duration у постройки - срок строительства: готовое здание после этого не исчезает. Processing.Duration у действия - срок выполнения его задачи. Duration у временного события - срок до истечения сообщения и его эффекта.
Задача оплачивается частями за успешные шаги. Например, при фиксированной цене 12 минералов и сроке 3 шага каждый взнос равен 4. После двух шагов оплачено 8. Если на третий взнос не хватает хотя бы одного ресурса, весь шаг ждёт: частичного списания нет, результат не выдаётся. Выполненная работа и оплата сохраняются при загрузке, а изменение цены или срока учитывает уже уплаченное. Если новая цена стала ниже оплаченной суммы, излишек не возвращается.
Отмена удаляет задачу и освобождает назначенных на неё работников; уже списанные взносы не возвращаются, у незавершённого строительства не появляется готовая постройка и у разведки - открытие тела. Это отличается от накопительного исследования: оно ждёт полный запас и до завершения не списывает части, поэтому отмена сохраняет этот запас.
Нельзя объявить произвольный Cancel.Refund или обработчик завершения именем в JSON. Снос готовой постройки - отдельное действие Demolish со своим возвратом, не отмена стройки. Срок Duration у обычного Event означает жизнь эффекта, а не финансовые взносы; запущенная Mission имеет собственное завершение по своему Duration.
Processing.Duration на действии задаёт базовое число ходов, без этой записи - 1. Чем заканчивается задача, определяет само действие: строительство создаёт постройку, разведка открывает тело, обмен выдаёт ресурс. Одно придуманное имя задачи такого результата не задаёт.
ExchangeWater в примере - действие обмена из статьи Action: оно уже имеет Is Action, цену, разовую награду и право World Able ExchangeWater. Explore - готовая разведка, NuclearDrives - готовая технология ядерных двигателей. Этот блок меняет только сроки существующих или уже объявленных операций.
["ExchangeWater", "Processing.Duration", 3],
["Explore", "Processing.Duration", 1],
["NuclearDrives", "Adds.Explore.Duration", -1]Разведка использует базовый срок, орбитальное расстояние от дома и прибавки Explore.Duration с округлением вверх и минимумом один ход. Ценовая скидка не сокращает этот срок. Multiplies.Action.Duration 0 отключает временные действия, затем стройка и разведка учитывают Rule.ProgressTasks. Это существующие режимы выполнения, а не общий способ заставить любое событие работать как задачу.
Сам Processing на живом объекте ссылается на созданную задачу. Progress хранит выполненные ходы, количества ресурсов на задаче - фактическую оплату. Processing.Accumulates относится к созданному накопительному процессу. Эти записи принадлежат игре, их не добавляют в мод вместо объявления действия. Рабочая задача использует назначенных работников и обеспеченные единицы труда. Новое имя вида задачи само по себе не создаёт её завершение.
Голый Duration на событии, эффекте или живой сущности задаёт срок жизни в ходах. Отсутствие - бессрочность. Ход рождения не сокращает срок. По истечении выполняется объявленный исход, затем снимается сущность и её временные вклады. Досрочное решение и уничтожение не являются истечением. Для миссии Duration - длительность полёта, а Expires - срок предложения. Duration.Turn - внутренний штамп, а не авторская настройка.
Длительность категории событий изменяется теми же числовыми операциями. GameEvent — существующий потомок Event в PreWarpAge; задания, возможности, угрозы и миссии наследуют эту категорию. Казуал использует следующую настройку:
["ModeMeditation", "Multiplies.GameEvent.Duration", 1.5]Положительный срок событий этой категории увеличивается в полтора раза, округляется вниз и занимает хотя бы один ход: 3 превращается в 4. Учитываются категории по Is и именованные модификаторы, например BoardQuest.Duration или EventChoice.Duration. Это относится и к собственному эффекту выбранного варианта, если он также Event. Вариант вне категории Event сохраняет прежний срок. Action.Duration задаёт время выполнения действия и не меняет срок жизни события, даже если вариант имеет обе роли.
Множитель не создаёт отсутствующий срок и не превращает нулевой срок события в положительный. План полёта Mission рассчитывается при рождении и сохраняется; запуск и загрузка используют его, а Expires остаётся отдельным сроком принятия предложения. Медали и обычные уведомления без категории GameEvent не удлиняются этой настройкой. Requires.Turn.More/Less и мировой Turn.Max остаются абсолютными условиями ходов, а не множителями срока. Предупреждение о выбранном финале без собственного Duration показывает оставшееся время мирового Turn.Max.
Creates и Then - результат и продолжение
После завершения работы часто нужно продолжить сюжет: постройка закончена - игра выбирает финал, исследование закончено - открывается следующая группа событий. Then связывает уже существующий результат с таким продолжением. Creates называет, что должен создать поддерживающий его механизм, но само по себе ничего не исполняет.
Сначала продолжим настоящее строительство. WarpDrivePrototype - готовый прототип варп-двигателя, WarpVictories - готовая группа его финалов.
["WarpDrivePrototype", "Then", "WarpVictories"]Только после завершения прототипа игра передаст очередь группе WarpVictories. Она выберет доступный итог. Сама запись Then не строит прототип и не отменяет его цену. Обычная передача группе учитывает её Turn.Pause.
Для немедленного продолжения у события используется Then.Now. TutorialContinue и Quests - готовые продолжение обучения и группа заданий.
["WarpDrivePrototype", "Then", "WarpVictories"],
["TutorialContinue", "Then.Now", "Quests"]Когда строительство прототипа действительно завершится, Then передаёт выбор группе финалов. Then.Now у события выполняет продолжение немедленно; обычный Then группы учитывает её Turn.Pause. Наличие ссылки не делает произвольное имя событием.
Пример Creates также использует готовое обучение: Tut29 - его объявленный шаг, TutorialAsteroid - создаваемое событие астероида, Europa - существующее тело сценария обучения.
["Tut29", "Creates", "TutorialAsteroid"],
["Tut29", "Creates.Target", "Europa"]Астероид создаётся, когда обучение Солнечной системы доходит до Tut29. Эти строки не включают обучение в другом сценарии и не создают астероид сразу при загрузке файла. Для собственного шага нужны Is TutorialStep, включение в набор, порядок и условия перехода - они разобраны в статье Tutorial.
Продолжение в общую колоду Events использует игрока-человека и его модификаторы периода, как обычный розыгрыш этой колоды. Прямое Then в именованное событие сохраняет игрока-инициатора. Это различие получателя не меняет Turn.Pause или смысл Then.Now.
Toggle - выбор политики показателя
Переключаемые политики через Is Toggle и Stat не входят в поддерживаемые возможности модов текущей Pre-Warp Age. Такие записи не подключают кнопки выбора политики, а строка с предикатом Stat не проходит загрузку.
Если вам нужен постоянный бонус науки после исследования, используйте технологию с Adds.Income.Science. Полный порядок включения технологии приведён в статье «Tech, Researching и Repeatable». Получится исследуемый бонус, но не переключатель: кнопок выбора между двумя политиками он не создаёт.
События, варианты, миссии и задания
Events и Event - группа и игровое событие
Создадим событие, которое один раз добавляет игроку минералы, и включим его в случайные события. Сначала объявим само событие. Его сообщение в интерфейсе далее называется плашкой. Определение события в файле и его конкретное появление в партии различаются.
["MySupply", "Is", "Event"],
["MySupply", "Adds.Minerals.Count.Scaled", 1]Event объявляет событие, а Adds.Minerals.Count.Scaled 1 задаёт разовую выдачу минералов по расчёту Scaled. Событие должно произойти в партии, чтобы игрок получил награду.
Теперь добавим событие MySupply в существующую группу RandomEvents.
["RandomEvents", "Deck.MySupply", 1]Deck.MySupply 1 добавляет одну карту события в колоду. Группа Events выбирает событие по своему расписанию Turn. Игрок получит минералы, когда группа выберет и запустит MySupply, а не сразу при включении мода. Строка Has для включения в колоду не нужна. Далее добавим событию оформление.
Is Events объявляет группу или вложенную колоду, Is Event - событие. У события указывают название, описание, значок, место и последствия. По этим данным игра определяет, что должно произойти: выдать ресурс, включить эффект, предложить варианты, дождаться срока или запустить миссию. Одного Is Event без содержания для этого недостаточно.
Фрагмент ниже добавляет событие MySupply с разовой выдачей минералов в существующую группу RandomEvents. Включение задаёт Deck.MySupply; Has здесь не нужен. В Text/ruRU.json добавьте MySupplyName, например «Дополнительные минералы», и MySupplyDescription с объяснением, почему игрок получает минералы.
["MySupply", "Is", "Event"],
["MySupply", "Name", "MySupplyName"],
["MySupply", "Description", "MySupplyDescription"],
["MySupply", "Icon", "ore_iron"],
["MySupply", "Adds.Minerals.Count.Scaled", 1],
["RandomEvents", "Deck.MySupply", 1]Событие появится, когда RandomEvents выберет его из колоды. Requires.Turn.Min ограничивает ход появления, Requires.Researched проверяет исследование игрока. Target выбирает место отдельно. Если событие пока недоступно, его карта возвращается в колоду.
Для события, которое может оставаться открытым, можно запретить вторую одновременную плашку. Например, добавим это ограничение готовой комете.
["CometMinerals", "Is", "Unique"]Пока у игрока есть CometMinerals, вторая такая комета не появится. После закрытия первой новый розыгрыш снова допустим. Чтобы запретить повтор навсегда после успешного розыгрыша, нужна другая роль.
["MySupply", "Is", "Once"]С Once событие MySupply может произойти только один раз за партию. Если оно уже выдало минералы, повторной выдачи через это событие не будет. Это не ограничение количества одновременно открытых окон. Ещё один независимый случай: несовместимость двух разных событий.
["MySupply", "Conflicts", "CometMinerals"]Conflicts симметричен: обратная строка не нужна. Обе стороны учитывают наследование Is, поэтому отношение категории действует на её потомков. Проверяется тот же игрок, а не все игроки мира. Связь можно поместить в условную ветку с Requires: условия проверяются у игрока, мировой факт указывается через Simulation. Это условие конфликта, а не запрет на появление каждого события по отдельности.
["BadEvent", "Conflicts", "BadEvent"]BadEvent — существующая категория угроз PreWarpAge. Эта строка уже запрещает их одновременное выпадение во всех режимах, включая повтор одного вида. Пока конфликтующая плашка или её прогноз живы, новая карта пропускается и возвращается в колоду. Продолжения и результаты выбора не отсекаются заново: предупреждение не блокирует собственное последствие. Unique отдельно запрещает повтор конкретного события. Events.Level, Held и счётчики розыгрышей — состояние партии, а не настройки мода.
Дополнительная граница - пауза обучения. Она не нужна для обычной собственной колоды:
Events.Hold true на Simulation включает общую паузу событийного расписания, используемую обучением. При ней назначенные сроки групп отодвигаются на прошедшие ходы; не разыгрываются ни очередные карты, ни условные ветви групп. Кроме того, уже появившиеся события не могут досрочно завершиться по дочерним Requires/Goal, в том числе при достижении границы Progress.
После снятия паузы подходящие ветви снова проверяются при изменениях состояния. Поэтому Hold нельзя использовать лишь для отключения мешающей случайной колоды: для этого изменяйте состав конкретной группы.
Events.Hold не останавливает само время мира: у уже созданных плашек продолжают идти Duration и шаги Progress, истечение срока разрешает свой исход, а сработавшие шаговые ветви Progress со своими Has могут выдавать непосредственные последствия. Отдельные события, явно создаваемые действием или продолжением, тоже не становятся автоматически запрещены этим флагом.
Для собственных сценариев оставляйте Events.Hold отсутствующим либо false, если такая неполная пауза специально не нужна. Не объявляйте true постоянно, рассчитывая сохранить работу ранних Goal/Progress-развязок.
Adds.Minerals.Count.Scaled и краткая запись Adds.Minerals.Scaled используют Scaled. Фиксированная Adds.Minerals.Count применяется к исходу выбора, а не к самостоятельному событию. Пример есть в статье «EventChoice, Failure и исходы выбора». Доля запаса у груза задаётся через Contains.Percent. Adds.Minerals.Percent для разовой награды не поддерживается.
Прогноз до начала события задаётся двумя независимыми решениями: событие указывает срок предупреждения, а выбранный режим разрешает прогнозы. Следующие строки включают их в уже объявленном MyInstantMode и добавляют пятиходовой прогноз к существующей комете:
["MyInstantMode", "Rule.EventWarns", true],
["CometMinerals", "Warns.Turns", 5]Warns.Turns — конечное неотрицательное целое число. Ноль или выключенный Rule.EventWarns сохраняет запуск без прогноза. В PreWarpAge прогнозы включены в Классике и Хардкоре, выключены в Казуале. Пометка наследуется обычным Is: задания получают её от BoardQuest. У вложенной колоды помечается выбираемое событие, а не сама колода. Положительная или отрицательная награда и наличие платного варианта сами по себе прогноз не создают.
При розыгрыше сначала появляется прогноз с обратным отсчётом. До его окончания эффекты и цели задания не действуют, варианты недоступны, ход не блокируется. Затем событие запускается со своим полным сроком. Уже выбранная цель сохраняется; если она исчезнет или перестанет подходить, прогноз отменяется без другой цели, награды или штрафа, а расписание продолжает свою паузу. Прогноз занимает место для Unique и Conflicts. Сохранение сохраняет отсчёт и продолжение, а не разыгрывает их заново.
Окно прогноза само выводит названия ресурсов из цен вариантов, ресурсных целей и действий, нужных для исследования, строительства или разведки. Это подсказка для подготовки, а не обещание оплаты или фиксированной суммы. Отдельный список ресурсов не задаётся. Ставьте Warns.Turns на исходную карту: её исходы и продолжения не должны получать ещё один прогноз только ради повторения задержки.
Период колоды изменяется обычным числовым модификатором. Например, эта альтернативная настройка Казуала увеличивает интервалы только RandomEvents в полтора раза:
["ModeMeditation", "Multiplies.RandomEvents.Turn.Every", 1.5]Это пример замены настройки, а не добавка к уже существующему Multiplies.Turn.Every 1.5 в Modes.json: одновременные множители складываются по обычным правилам. Категории колоды также учитываются по Is. Модификатор применяется к каждому новому периоду; целочисленный исход округляется до целого хода, авторский дробный период сохраняется дробным. Первый запуск Turn.Starts, пауза Turn.Pause и уже назначенный Turn.Next не переписываются. Загрузка не разыгрывает назначенный ход повторно.
EventChoice, Failure и исходы выбора
EventChoice - вариант решения в окне события. Игрок выбирает вариант, платит его цену и получает исход с ролью Event. Неудачный исход дополнительно отмечается Failure. Например, образцы можно переработать в минералы или изучить ради временного дохода науки. Выбор одного исключает другое.
Сначала разберём одну кнопку из будущего примера: переработку образцов. Это часть заготовки, а не самостоятельное событие.
["OGSampleDilemma", "Has", "OGRecycleSamples"],
["OGRecycleSamples", "Is", "EventChoice"]Has связывает предложение OGSampleDilemma с кнопкой OGRecycleSamples. EventChoice определяет её роль. Эта связь ещё не выдаёт минералы: у кнопки пока нет результата.
Теперь назначим кнопке единственный успешный исход.
["OGRecycleSamples", "Has", "OGSamplesRecycled"],
["OGSamplesRecycled", "Is", "Event"],
["OGSamplesRecycled", "Adds.Minerals.Count", 8]Второй Has ведёт уже от кнопки к результату. После выбора результат один раз прибавит 8 минералов игроку: например, запас 10 станет 18, если действующий предел это допускает. Награда записана у исхода, а не у кнопки. Ниже соберём это решение вместе со вторым вариантом и оформлением окна. Один вариант можно включить в разные события: при нажатии он работает с той плашкой, в которой выбран.
Для второй кнопки возьмём знакомый доход науки и добавим ему срок.
["OGSampleResearch", "Is", "Event"],
["OGSampleResearch", "Adds.Income.Science", 2],
["OGSampleResearch", "Duration", 3]Если второй выбор запустит этот исход, игрок получит дополнительные 2 науки на каждом из трёх следующих ходов. После этого исчезнет только прибавка этого события. Например, постоянный доход 5 временно станет 7, затем снова 5. Duration относится к исходу, который даёт бонус.
Успешный исход имеет Is Event. Неудачный исход дополнительно получает Is Failure; к риску вернёмся после рабочего примера без случайности.
Сохраните следующий полный массив в Logic/Samples.json. Словарь после него - в Text/ruRU.json. Если этот файл уже существует, добавьте ключи в его объект, сохранив остальные переводы. После включения мода начните новую партию и дождитесь события «Геологические образцы» в группе RandomEvents. Первый вариант даст 8 минералов, второй - 2 науки за ход на три хода.
[
["OGSampleDilemma", "Is", "Event"],
["OGSampleDilemma", "Name", "OGSampleDilemmaName"],
["OGSampleDilemma", "Description", "OGSampleDilemmaDesc"],
["OGSampleDilemma", "Icon", "ore_iron"],
["OGSampleDilemma", "Has", "OGRecycleSamples"],
["OGSampleDilemma", "Has", "OGStudySamples"],
["RandomEvents", "Deck.OGSampleDilemma", 1],
["OGRecycleSamples", "Is", "EventChoice"],
["OGRecycleSamples", "Name", "OGRecycleSamplesName"],
["OGRecycleSamples", "Description", "OGRecycleSamplesDesc"],
["OGRecycleSamples", "Icon", "ore_iron"],
["OGRecycleSamples", "Order", 1],
["OGRecycleSamples", "Cost.Credits", 0],
["OGRecycleSamples", "Has", "OGSamplesRecycled"],
["OGSamplesRecycled", "Is", "Event"],
["OGSamplesRecycled", "Name", "OGSamplesRecycledName"],
["OGSamplesRecycled", "Description", "OGSamplesRecycledDesc"],
["OGSamplesRecycled", "Icon", "ore_iron"],
["OGSamplesRecycled", "Adds.Minerals.Count", 8],
["OGStudySamples", "Is", "EventChoice"],
["OGStudySamples", "Name", "OGStudySamplesName"],
["OGStudySamples", "Description", "OGStudySamplesDesc"],
["OGStudySamples", "Icon", "flask"],
["OGStudySamples", "Order", 2],
["OGStudySamples", "Cost.Credits", 0],
["OGStudySamples", "Has", "OGSampleResearch"],
["OGSampleResearch", "Is", "Event"],
["OGSampleResearch", "Name", "OGSampleResearchName"],
["OGSampleResearch", "Description", "OGSampleResearchDesc"],
["OGSampleResearch", "Icon", "flask"],
["OGSampleResearch", "Duration", 3],
["OGSampleResearch", "Adds.Income.Science", 2]
]Содержимое Text/ruRU.json для этого примера:
{
"OGSampleDilemmaName": "Геологические образцы",
"OGSampleDilemmaDesc": "Образцы можно переработать или изучить.",
"OGRecycleSamplesName": "Переработать образцы",
"OGRecycleSamplesDesc": "Получить минералы из собранной породы.",
"OGSamplesRecycledName": "Образцы переработаны",
"OGSamplesRecycledDesc": "Сырьё поступило на склад.",
"OGStudySamplesName": "Изучить образцы",
"OGStudySamplesDesc": "Провести временную программу исследований.",
"OGSampleResearchName": "Изучение образцов",
"OGSampleResearchDesc": "Образцы помогают текущим исследованиям."
}Оба варианта бесплатны: Cost.Credits 0 явно задаёт нулевую цену, а не расход одного кредита. Выбирается только один результат. Первый исход разово выдаёт ровно восемь минералов до действующих границ запаса. Второй создаёт +2 дохода науки на три следующих хода, затем снимает только свой бонус. Duration находится на временном исходе, а не на бесплатном варианте и не на самом предложении.
Adds.Minerals.Count записана у исхода OGSamplesRecycled. Выбор варианта OGRecycleSamples запускает этот исход и выдаёт награду. Для события без выбора используйте Scaled.
Requires варианта проверяет игрока, а не тело-цель плашки. Недоступный вариант остаётся серым и не списывает цену. Не рассчитывайте на наследование Requires варианта-наследника: его условие задаётся явно. Порядок вариантов определяет Order.
Предложение из примера без Duration ждёт выбора и блокирует завершение хода. С положительным Duration игрок может отложить решение до истечения; само ожидание выбранную награду не выдаёт. Если исход имеет собственные варианты или длительный эффект, он появляется как отдельное событие и получает допустимую цель исходного предложения.
Событие может сначала предупредить игрока, а результат выдать после ожидания. Для этого не нужна новая роль: событие имеет Is Event, а Has у самого события ссылаются на исходы с Is Event, вместо того чтобы перечислять кнопки с Is EventChoice. Duration задаёт время ожидания. Когда срок истечёт, игра выберет подходящий исход; при наличии риска выберет между успехом и Failure по этому риску.
Без Duration у события с такими исходами результат определяется сразу при появлении. Если предусмотрены защитные варианты и выбранный вариант убирает предупреждение раньше срока, отложенный исход не происходит. Не переносите Has с исходами на корень обычного предложения из примера с образцами: это изменит способ и момент получения результата.
После обычного выбора можно добавить риск. Следующий отдельный пример RiskTest - альтернатива простой дилемме, а не обязательное продолжение её фактов. Он уже содержит роли, Has и включение в RandomEvents.
Сначала зададим единственный возможный процент риска будущей плашки RiskTest. Это часть отдельного примера ниже.
["RiskTest", "Chance.Deck.25", 1]Chance.Deck выбирает процент неудачи при рождении. Здесь есть одна карта значения 25, поэтому риск будет 25%, а вероятность успеха - 75%. Это не вероятность появления самого RiskTest.
Теперь разрешим два возможных значения риска с одинаковым количеством карт.
["RiskTest", "Chance.Deck.25", 1],
["RiskTest", "Chance.Deck.50", 1]При появлении конкретной плашки выбирается риск 25% или 50%. После выбора он сохраняется: окно не перебрасывает его при каждом показе. В полном наборе у кнопки будут один успех и два провала.
Наконец, разделим неудачу на лёгкую и тяжёлую. Обе должны быть объявленными Failure и входить в Has кнопки.
["AttemptRiskTest", "Deck.RiskLostSmall", 1],
["AttemptRiskTest", "Deck.RiskLostLarge", 1]Этот Deck выбирает тяжесть только уже выпавшего провала. При сохранённом риске 25% успех вероятен на 75%, каждый провал - на 12.5%. При риске 50% успех вероятен на 50%, каждый провал - на 25%. Ниже все роли, связи и награды собраны вместе.
Для авторского процента используйте числа от 0 до 100. Числа справа в Chance.Deck - конечные количества карт; дробные допустимы, положительный остаток участвует, после выбора расходуется min(1, остаток). Неположительные карты не выбираются.
Deck на варианте EventChoice использует конечные веса пропорционального разового выбора: участвуют только положительные веса, включая дробные; этот выбор не уменьшает остаток карт обычной колоды.
["RiskTest", "Is", "Event"],
["RiskTest", "Name", "RiskTestName"],
["RiskTest", "Icon", "flask"],
["RiskTest", "Chance.Deck.25", 1],
["RiskTest", "Chance.Deck.50", 1],
["RiskTest", "Has", "AttemptRiskTest"],
["AttemptRiskTest", "Is", "EventChoice"],
["AttemptRiskTest", "Name", "AttemptRiskTestName"],
["AttemptRiskTest", "Cost.Credits", 0],
["AttemptRiskTest", "Has", "RiskWon"],
["AttemptRiskTest", "Has", "RiskLostSmall"],
["AttemptRiskTest", "Has", "RiskLostLarge"],
["AttemptRiskTest", "Deck.RiskLostSmall", 1],
["AttemptRiskTest", "Deck.RiskLostLarge", 1],
["RiskWon", "Is", "Event"],
["RiskWon", "Name", "RiskWonName"],
["RiskWon", "Adds.Science.Count", 5],
["RiskLostSmall", "Is", "Event"],
["RiskLostSmall", "Is", "Failure"],
["RiskLostSmall", "Name", "RiskLostSmallName"],
["RiskLostSmall", "Adds.Minerals.Count", -1],
["RiskLostLarge", "Is", "Event"],
["RiskLostLarge", "Is", "Failure"],
["RiskLostLarge", "Name", "RiskLostLargeName"],
["RiskLostLarge", "Adds.Minerals.Count", -5],
["RandomEvents", "Deck.RiskTest", 1]- Один успех Has, без Failure: безопасный вариант, общий шанс неудачи плашки не создаёт отсутствующий провал.
- Один успех и один Failure в Has: обычный бросок успех/провал по риску плашки; без риска провал не придумывается.
- Несколько Failure: обязательна колода Deck на варианте; каждый её член должен одновременно быть его Has-исходом и Is Failure. Колода не выбирает между успешными результатами.
- Несколько успешных Has не исполняются все: используется первый подходящий по Order, затем по идентификатору определения в порядковом сравнении строк, не по переведённой подписи Name. Для однозначного сценария оставляйте один успех либо непересекающиеся условия.
- Chance.Add с Chance.Target Parent.Part улучшает шанс ветви шкалы Progress (пример ниже), но не сохранённый шанс провала события RiskTest. Для изменяемого общего риска используйте Mission и её Risk, а не неподдерживаемый Chance.Target Parent на обычном Event.
Шанс провала хранится у конкретной плашки миссии или рисковой колоды. Has связывает успешный и неуспешный исходы, Deck на варианте может распределять веса нескольких неуспешных исходов. Это не порядок вызовов JSON. Вариант урона, правки Progress, изменения груза или улучшения миссии может оставлять исходную плашку живой. Его результат следует из конкретной операции, а не имени варианта.
В связи Has роль EventChoice имеет приоритет над Event: определение с обеими категориями остаётся кнопкой выбора, а не ещё одним исходом. Если выбранный вариант создаёт собственный временный эффект Event, его плашка сохраняет вариант источником эффекта, срока и истории. Обычный Action в Has события — отдельная кнопка действия: такое событие может держать постоянное окно, но Action не становится EventChoice, не получает выдуманный исход и сам отвечает за доступность и выполнение.
Временные эффекты и Blocks
Временный эффект действует указанное число ходов, затем снимается. Например, сезон даёт на 20% больше энергии в течение пяти ходов. Blocks означает запрет: постройки, действия, роста или другого поддерживаемого понятия. Срок и запрет - независимые свойства события.
Сначала зададим только временный бонус. MyEnergySeason - придуманное имя события. В заготовке ниже знакомый множитель получает срок.
["MyEnergySeason", "Is", "Event"],
["MyEnergySeason", "Multiplies.Income.Energy", 1.2],
["MyEnergySeason", "Duration", 5]После появления события доход энергии 10 станет 12 на пять следующих ходов. Затем этот множитель исчезнет и доход вернётся к 10, если за это время не изменились другие условия. Для показа события добавим имя, значок и включение в RandomEvents; полный набор приведён ниже. MyEnergySeasonName нужно перевести в Text/ruRU.json, например «Энергетический сезон».
Отдельная задача - запретить штрафы заданий в режиме «Казуал». Срок временного бонуса для этого не нужен.
["ModeMeditation", "Blocks", "QuestPenalty"]ModeMeditation - уже существующий режим, QuestPenalty - готовая категория штрафов заданий. Blocks запрещает её для партии с этим режимом. Эта строка не меняет доход энергии и не ограничивает запрет пятью ходами. В следующем наборе две независимые настройки просто записаны рядом.
Без Duration числовой эффект события сохраняется после сообщения; при повторном получении прибавки складываются, множители применяются снова. Duration делает этот эффект временным. По окончании снимается только его вклад: другие бонусы и исходная база сохраняются. Закрытие сообщения само по себе не заменяет истечение срока способности.
["MyEnergySeason", "Is", "Event"],
["MyEnergySeason", "Name", "MyEnergySeasonName"],
["MyEnergySeason", "Icon", "energy"],
["MyEnergySeason", "Duration", 5],
["MyEnergySeason", "Multiplies.Income.Energy", 1.2],
["ModeMeditation", "Blocks", "QuestPenalty"],
["RandomEvents", "Deck.MyEnergySeason", 1]На выбранной корпорации Blocks запрещает указанное понятие или поток её игроку, на режиме - действует как правило партии. Например, Blocks Growth.Workers отключает естественный рост, Blocks Upkeep.Water - расход воды на содержание. Указывать можно объявленную категорию или поддерживаемое поле. Запрет не распространяется автоматически на всё, что косвенно связано с этим именем.
На событии Blocks World или Blocks Icy задаёт категории мест для блокады. Нужен положительный Duration. При появлении выбирается конкретное место; блокада выключает его потребителей и рабочие места. После снятия последней блокады работа снова разрешена. Это отличается от [Earthlike, Blocks, Outpost], которое запрещает строительство аванпоста на землеподобном мире.
Не совмещайте саму карту блокады с разовой выдачей Adds.Minerals.Scaled или разовым изменением тела через Target.Adds: при обычном розыгрыше такая карта обрабатывается как разовое изменение и блокаду не включает. Для награды после снятия блокады задайте отдельный исход.
Resource - выбор ресурса при разведке
После разведки тело иногда предлагает несколько ресурсов. Игрок выбирает один для добычи; окно заранее показывает ставку каждого варианта. Resource в таком варианте означает выбранный ресурс мира. Награда на склад при выборе не выдаётся.
WorkFocus - готовое окно выбора добычи, FocusMinerals - его существующий вариант минералов. Следующий фрагмент показывает полностью подключённую связь с этим окном. Parent.Target означает исследуемое тело плашки WorkFocus.
Resource со ссылкой на объявленный ресурс называет выбранный вариант разведки, а не запас. На EventChoice обязательна Resource.Target с явным путём к телу, например Parent.Target. Величина возможной отдачи бросается при рождении предложения, показывается числом и после выбора применяется к этому телу. Несовместимый с телом ресурс не предлагается.
["WorkFocus", "Has", "FocusMinerals"],
["FocusMinerals", "Is", "EventChoice"],
["FocusMinerals", "Name", "Minerals"],
["FocusMinerals", "Resource", "Minerals"],
["FocusMinerals", "Resource.Target", "Parent.Target"]Окно WorkFocus вызывает готовая разведка Explore при нескольких совместимых кандидатах. Если тело не совместимо с минералами по ресурсным колодам, этот вариант не появится. Фрагмент не заставляет любой мир стать минеральным. Для своего ресурса нужны его объявление Resource, запас игрока, совместимые колоды тела и такой же подключённый EventChoice; полный пример криоруды находится в статье ресурсной генерации.
Find - находка и исследование зондом
Находка - неизвестный объект или тайник на уже раскрываемом теле. Он появляется по отдельной раздаче, а игрок может исследовать его зондом Probe за цену. Результат - событие, а не автоматическое открытие нового ресурса на складе.
MyCache - новая находка, MyFinds - её колода для существующего ScenarioG. Rocky - каменистая категория места. В качестве результата используется готовое событие доставки минералов SuppliesMinerals: оно уже имеет Event, награду, название и оформление сообщения.
Сначала объявим находку и цену её исследования.
["MyCache", "Is", "Find"],
["MyCache", "Cost.Minerals", 5]MyCache станет находкой. Исследующий её зонд Probe заплатит базовые 5 минералов; окончательная цена учитывает множители разведки. Это цена исследования, не награда тайника.
Теперь укажем допустимое место и результат зонда.
["MyCache", "Target", "Rocky"],
["MyCache", "Deck.SuppliesMinerals", 1]Эта часть рассчитана на каменистые тела. После оплаченного исследования сработает готовое событие SuppliesMinerals, которое один раз добавит игроку минералы. Количество задано в самом событии; Cost находки его не меняет. Для разных категорий места используйте отдельные части находки со своими Target и Deck. Два разных состава исходов одного контекста неоднозначны.
Осталось распределить находки по новым раскрываемым телам сценария.
["MyFinds", "Deck.MyCache", 1],
["MyFinds", "Deck.None", 3],
["ScenarioG", "Has", "MyFinds"]В колоде одна находка и три пустые карты. При раздаче без возвращения на четыре подходящих тела одна карта даст MyCache, три - отсутствие находки. Ниже собраны эти связи и оформление. На живом теле Find None писать не нужно: этот факт означает уже прошедшую раздачу.
["MyCache", "Is", "Find"],
["MyCache", "Name", "MyCacheName"],
["MyCache", "Icon", "question"],
["MyCache", "Cost.Minerals", 5],
["MyCache", "Target", "Rocky"],
["MyCache", "Deck.SuppliesMinerals", 1],
["MyFinds", "Deck.MyCache", 1],
["MyFinds", "Deck.None", 3],
["ScenarioG", "Has", "MyFinds"]При первом раскрытии подходящих тел выбранного сценария колода раздаёт находку или None без возвращения. SuppliesMinerals - уже определённое событие основной игры; находка и его целевой контекст здесь относятся к каменистым телам. Пустая карта None относится к составу колоды. У авторского тела без находок просто не пишите Find None: этот факт на живом теле фиксирует уже прошедшую раздачу.
Факт [BodyClass, Find, MyCache] закрепляет авторскую находку и имеет приоритет над случайной раздачей. Probe оплачивается с учётом множителей разведки и выполняется по правилам выбранного режима. После исследования находка снимается, а у того же тела появляется её исход. Если результат увеличивает добычу выбранного ресурса, этот ресурс уже должен быть определён; иначе исследование пока недоступно. Колоду исходов задают на находке, а не через Find.MyCache.Deck на теле.
Contains - груз события
Груз принадлежит живому предложению события до того, как игрок его заберёт. Например, комета содержит сохранённое количество минералов, а успешный сбор переносит его на склад. Другой вариант может увеличить именно груз этой плашки, не забирая его и не закрывая предложение.
Сначала выберем, что лежит в грузе готовой кометы CometMinerals. Изменяем существующее событие, поэтому его имя, значок и варианты повторять не нужно.
["CometMinerals", "Contains", "Minerals"]Contains называет ресурс груза: минералы. Пока груз находится у кометы, на складе игрока его нет. Если величина не задана, используется Scaled с коэффициентом 1.
Теперь зададим груз как долю запаса игрока. Для этого нужно убрать Contains.Scaled, уже объявленный у CometMinerals. Создайте файл Logic/CometPercent.json по правилам изменения записей:
{
"remove": [["CometMinerals", "Contains.Scaled"]],
"set": [["CometMinerals", "Contains.Percent", 10]]
}При запасе 100 минералов в момент появления кометы груз составит 10. Если запас позднее вырастет до 200, груз останется равен 10. Для положительного груза действует минимум один. В следующем примере используется Scaled. Перед ним уберите файл CometPercent.json из Logic и создайте новую партию. Contains.Percent и Contains.Scaled нельзя задавать одновременно.
CometMinerals - готовое событие кометы с минералами; CometCollect - его вариант сбора; CometReturn - успешный исход. Все три уже объявлены и связаны в игре. Следующий фрагмент показывает саму обязательную цепочку груза:
["CometMinerals", "Contains", "Minerals"],
["CometMinerals", "Contains.Scaled", 2.5],
["CometMinerals", "Has", "CometCollect"],
["CometCollect", "Has", "CometReturn"],
["CometReturn", "Contains.Target", "Parent"]При масштабе 10 груз этой кометы равен 25 минералам. Если до успешного сбора на складе было 100 минералов, исход CometReturn пополнит запас до 125. Само появление кометы запаса не увеличивает. Возможный провал сбора остаётся правилом готового CometCollect.
Для наращивания груза используем другую уже готовую цепочку: SpaceFashion - событие потока желающих переселиться работников, SpaceFashionBoost - его платное продвижение. Это отдельный пример, не вторая часть кометы:
["SpaceFashion", "Has", "SpaceFashionBoost"],
["SpaceFashionBoost", "Contains.Target", "Parent"],
["SpaceFashionBoost", "Contains.Percent", 5]Здесь ресурс груза - Workers: он объявлен на самой SpaceFashion через Contains. Число 5 означает 5% населения игрока, а не 5% уже собранного груза. При населении 100 один оплаченный клик добавит 5 желающих. Если в окне их было 10, станет 15; население игрока пока останется равным 100, окно останется открытым.
Теперь нажмите готовый вариант принятия работников SpaceFashionAccept. Его исход SpaceFashionAcceptDone содержит только Contains.Target Parent и заберёт все 15 работников из плашки. Если между действиями население не менялось, оно вырастет со 100 до 115. Percent на варианте увеличивает груз, а исход без собственной величины выдаёт весь груз игроку. Вместо Percent можно указать Scaled.
Исход с одним Contains.Target Parent забирает сохранённый груз своей плашки. Вариант с тем же путём и объявленной величиной добавляет к грузу, повторяем и оставляет плашку. У такого варианта не должно быть независимых исходов или эффекта, маскирующего повторное применение. Contains.Name задаёт подпись груза. Contains.Count.R - сохранённый результат расчёта, его не пишут вместо декларации груза. Cost.R.PerValue может оплачивать каждую добавляемую единицу.
Mission, Expires, Risk, Reward и Launched
Миссия сначала появляется как предложение. Если игрок успевает оплатить запуск, начинается полёт; после него риск определяет успех или провал. При успехе игрок получает заранее рассчитанную награду. Провал сам по себе оплату не возвращает. Expires задаёт, сколько можно откладывать запуск, Duration - сколько длится уже запущенный полёт.
MyExpedition - новая экспедиция за наукой. Сохраните два первых блока в один массив Logic: первый объявляет предложение, второй - запуск и исходы.
Начнём со времени на решение. Это первая часть заготовки MyExpedition; пока у неё нет кнопки запуска. Mission уже является Event в основной игре, поэтому второго Is Event не требуется.
["MyExpedition", "Is", "Mission"],
["MyExpedition", "Expires", 8]Expires 8 оставляет восемь ходов для решения. Предложение, появившееся на ходу 10, можно принять на ходах 10-17; переход на 18 удалит его, если запуск не оплачен. Сам полёт эти восемь ходов не описывают.
Отдельно зададим длительность уже оплаченного полёта.
["MyExpedition", "Duration", 4]Duration 4 начинает новый отсчёт при запуске. Запуск на ходу 12 даст исход на ходу 16. Неиспользованный срок предложения на длительность полёта не влияет.
Теперь добавим риск возвращения без награды.
["MyExpedition", "Risk", 30]Risk 30 означает 30% провала и 70% успеха. Процент сохраняется у конкретного предложения; его загрузка не бросает риск заново. Платёж за запуск при провале автоматически не возвращается.
Последняя часть предложения - награда успешного полёта.
["MyExpedition", "Reward", "Science"],
["MyExpedition", "Reward.Scaled", 2]Reward выбирает науку, Reward.Scaled 2 задаёт её количество через Scaled. При масштабе 11 награда составит 22 единицы науки. Risk, Reward, Expires и Launched уже объявлены через Is Predicate. Теперь соберём параметры предложения и подключим запуск с исходами.
["MyExpedition", "Is", "Mission"],
["MyExpedition", "Name", "MyExpeditionName"],
["MyExpedition", "Expires", 8],
["MyExpedition", "Duration", 4],
["MyExpedition", "Risk", 30],
["MyExpedition", "Reward", "Science"],
["MyExpedition", "Reward.Scaled", 2]Предложению нужен вариант запуска с Has, перечисляющими исходы. Одни Duration, Risk и Reward исходов не объявляют. Duration и Risk используют обычный Random: фиксированное число, диапазон Min/Max или повторные факты .Random с допустимыми значениями. Случайные значения и границы должны быть конечными целыми числами от 0 до 2147483647, для Duration — не меньше 1. Обе границы диапазона обязательны, но отсутствующую границу можно унаследовать. Собственное фиксированное число дочернего определения заменяет случайный выбор предка; не смешивайте число и Random на одном определении. Step, Peak и PowerLaw работают по статье Random. Результат сохраняется на предложении и не перебрасывается при чтении или загрузке. Expires поддерживает обычный Random. Reward называет объявленный ресурс, а не случайное число.
В базовых «Рискованных экспериментах» начальный шанс провала равен только 40, 60 или 80%. Этот фрагмент показывает определение варп-изоляции и общий вариант инвестирования; два других эксперимента используют те же три значения:
["ExperimentWarp", "Risk.Random", 40],
["ExperimentWarp", "Risk.Random", 60],
["ExperimentWarp", "Risk.Random", 80],
["Invest", "Adds.Risk", -20]Каждое перечисленное значение выбирается независимо и с одинаковой вероятностью. Adds.Risk −20 вычитает 20 процентных пунктов, а не умножает риск на 0,8: первое оплаченное вложение снижает риск с 40 до 20%, второе — до 0%. У экспериментов уже задан Risk.Min 0, поэтому ниже нуля риск не падает, а дальнейшее вложение недоступно и ничего не списывает. Цена и её рост остаются на Invest. Deck, напротив, расходует карты с заданными весами без возвращения; используйте его, когда нужно именно такое распределение.
["MyExpedition", "Has", "LaunchMyExpedition"],
["LaunchMyExpedition", "Is", "EventChoice"],
["LaunchMyExpedition", "Name", "LaunchMyExpeditionName"],
["LaunchMyExpedition", "Cost.Minerals", 10],
["LaunchMyExpedition", "Has", "MyExpeditionSuccess"],
["LaunchMyExpedition", "Has", "MyExpeditionFailure"],
["MyExpeditionSuccess", "Is", "Event"],
["MyExpeditionSuccess", "Name", "MyExpeditionSuccessName"],
["MyExpeditionFailure", "Is", "Event"],
["MyExpeditionFailure", "Is", "Failure"],
["MyExpeditionFailure", "Name", "MyExpeditionFailureName"],
["RandomEvents", "Deck.MyExpedition", 1]Вместе с предыдущим блоком получается предложение миссии на восемь ходов. Оплата запускает четырёхходовый полёт, затем сохранённый риск выбирает успех или провал. Успех выдаёт объявленную Reward, поэтому не дублируйте ту же награду дополнительной Adds на успешном исходе. Имена в примере переводятся обычным словарём Text.
Ресурс награды задаёт поле Reward, а коэффициент - Reward.Scaled. Если коэффициент не указан, он равен 1.
Эта величина фиксируется при появлении предложения, а не при запуске или возвращении. Рост населения, новые исследования и торговля после этого сами её не меняют. Оплаченное улучшение награды меняет именно награду данной плашки, если такое улучшение явно объявлено через Adds.Reward.Count или Multiplies.Reward.Count.
Успех зачисляет её с соблюдением действующих границ количества Science, сообщение показывает фактически зачисленное. Провал не выдаёт Reward и сам по себе не возвращает цену запуска. Возврат или дополнительный штраф должны быть собственными фактами исхода.
Точный срок предложения: если оно появилось на ходу B с целым Expires E, его можно принять на ходах B…B+E−1 включительно. Переход на B+E удаляет непринятое предложение. Например Expires 6 при появлении на ходу 10 даёт решение на ходах 10…15, после перехода на 16 предложения нет. Дробный положительный Expires заканчивается при первом обнулении отсчёта, то есть на B+ceil(E). Без запуска исходы запуска не разыгрываются и оплата не списывается. Самостоятельная история истечения возможна только при её явном объявлении.
Запуск на ходу L заменяет оставшийся срок предложения длительностью процесса D и начинает новый отсчёт. Результат наступает при переходе на L+D: запуск четырёхходовой миссии на ходу 12 даёт исход на ходу 16. В ход запуска процесс не теряет первый ход. Удаление или превращение его цели обрабатывает соответствующий вид события, а не предполагаемое продолжение таймера. Для удобного календаря задавайте целые Expires и Duration.
Добавим к предложению MyExpedition платную кнопку снижения риска. Это отдельный вариант рядом с запуском: он меняет открытую плашку, а не создаёт новый полёт. Переведите ReduceMyRiskName обычным словарём Text.
["MyExpedition", "Has", "ReduceMyRisk"],
["MyExpedition", "Risk.Min", 10],
["ReduceMyRisk", "Is", "EventChoice"],
["ReduceMyRisk", "Name", "ReduceMyRiskName"],
["ReduceMyRisk", "Cost.Credits", 1],
["ReduceMyRisk", "Adds.Risk", -10]При начальном риске 30 первый оплаченный клик оставляет риск 20, второй - 10. Дальше снижать некуда: кнопка становится серой и кредит не списывается. Предложение остаётся открытым, полёт ещё не запущен. Risk.Min принадлежит самой миссии; он не равен условию доступности кнопки Requires.
Уменьшать риск можно и множителем. Для альтернативного опыта замените Adds.Risk −10 следующей строкой; цену кнопки и подключение сохраните.
["ReduceMyRisk", "Multiplies.Risk", 0.5]Из риска 30 получится 15, следующий клик упрётся в минимум 10, а не даст 7.5. Риск сохраняется с точностью до 0.1 процентного пункта. Это множитель риска провала, поэтому вероятность успеха меняется с 70% на 85%, затем на 90%.
Следующая альтернативная кнопка уменьшает время полёта. Возьмите тот же каркас ReduceMyRisk, смените имя перевода и замените только операцию риска операцией длительности; саму кнопку для ясности можно переименовать. Ниже показана эта операция и её предел на миссии.
["ReduceMyRisk", "Multiplies.Duration", 0.5],
["MyExpedition", "Duration.Min", 1]При сроке 4 хода первый клик даст 2, второй - 1. Третий недоступен и ничего не списывает. Здесь меняется будущий полёт, а не Expires предложения. Срок хранится целым числом ходов и не опускается ниже 1. Для прибавки или вычитания фиксированных ходов используется Adds.Duration вместо Multiplies.Duration.
Наконец, тем же способом изменяется сохранённая награда. Для отдельного варианта замените операцию длительности на следующую; не оставляйте обе операции в одной учебной кнопке.
["ReduceMyRisk", "Multiplies.Reward.Count", 2]Обещанные 22 науки станут 44, следующий клик - 88 до границ последующего зачисления. Это изменение количества Reward.Count, а не выбор нового ресурса Reward. Награда округляется до целых единиц. Фиксированную добавку задаёт Adds.Reward.Count; например, +3 превратит 22 в 25. Нижняя граница количества записывается на миссии как Reward.Count.Min; Reward.Min её не заменяет. Улучшение любого параметра оплачивается только пока действительно может его изменить.
Launched true запускает миссию сразу при рождении. Тогда нужны Duration и исходы Has самого события, Expires и отдельный вариант запуска не нужны. Доступные улучшения могут оставаться в окне. Для обычного предложения запуск меняет его в процесс и скрывает варианты до исхода. Notifies Started в Has миссии задаёт название и оформление сообщения о запуске. Награда и риск не перебрасываются при загрузке.
Risk.Show = Success показывает вероятность успеха 100 − риск, не меняя самого броска. Другие значения Show не поддерживаются. Failure.Description - ключ явного последствия провала. Visual = Departure задаёт поддерживаемый визуальный вылет. Для обычного риска вне миссии Multiplies.Risk улучшает существующий шанс этой плашки и не создаёт миссию. Mission.Duration, Mission.Risk, Mission.Reward и Reward.Count на плашке - исторические результаты, не исходные авторские параметры.
Чтобы полёт из полного примера выше открывался отдельным исследованием и появлялся по собственному расписанию, замените строку включения MyExpedition в RandomEvents следующим блоком. Остальные факты MyExpedition и её запуска сохраняются. Технология здесь специально не имеет числового бонуса.
["MyCartography", "Is", "Tech"],
["MyCartography", "Name", "MyCartographyName"],
["MyCartography", "Icon", "flask"],
["MyCartography", "Tier", 1],
["MyCartography", "Cost.Science", 9],
["Player", "Has", "MyCartography"],
["MyDispatches", "Is", "Events"],
["MyDispatches", "Turn.Starts", 3],
["MyDispatches", "Turn.Every", 7],
["MyDispatches", "Deck.MyExpedition", 1],
["MyExpedition", "Requires.Researched", "MyCartography"],
["MyExpedition", "Target", "World"],
["MyExpedition", "Target.Is", "Rocky"],
["MyExpedition", "Target.Explored", true],
["MyExpedition", "Target.Not", "Homeworld"]Предложение проверяется на ходах 3, 10, 17 и далее, пока мир позволяет продолжать игру. Оно появится только после изучения MyCartography и при наличии разведанного каменистого мира, отличного от дома. Исследование после пропущенной проверки не выдаёт предложение немедленно: нужно дождаться следующего срока. Если не нужны одновременные предложения той же миссии, добавьте ей Is Unique. Новый ключ MyCartographyName переводится обычным словарём.
Progress - накопленное выполнение и шкалы
Progress хранит, насколько продвинулся конкретный процесс или как изменилось его состояние. Это общий числовой механизм: длительная задача Processing использует его для выполненных шагов, а событие может использовать как шкалу противостояния. Противостояние - лишь один пример, а не обязательный смысл слова Progress.
Задачу связывает с объектом Processing; её оплатой и завершением управляет действие. Progress хранит значение, но сам по себе не создаёт стройку, награду или победу. Duration задаёт срок: в течение этого срока Progress может расти, уменьшаться или оставаться на месте. Например, недовольство растёт за ход, уступка его снижает, а достижение одной из границ ведёт к объявленному исходу. Дальше показано именно такое событийное применение; работа задач объясняется в статье «Processing и Duration - задачи и сроки».
Разберём шкалу будущего PressureTest по частям. Сначала зададим её начальную точку и пределы; остальные части события подключим в полном файле.
["PressureTest", "Progress", 2],
["PressureTest", "Progress.Min", 0],
["PressureTest", "Progress.Max", 5]Новая плашка начнёт со значения 2. Изменения смогут довести шкалу до 0 или 5, но не вывести за эти границы. Пока достижение края ничего не выдаёт: исходы нужно назначить отдельно.
Теперь добавим кнопку, уменьшающую шкалу именно открытого события.
["PressureRelief", "Progress.Target", "Parent"],
["PressureRelief", "Progress.Gain", -1]Parent у кнопки - плашка, в которой она нажата. Первый клик изменит 2 на 1, второй - 1 на 0. Операция не закрывает предложение сама; в полном примере его завершит проверка нижней границы. Роль кнопки, её цена и включение через Has показаны в сборке ниже.
Вместо клика шкалу может менять ход времени. Зададим один случайный неблагоприятный шаг.
["PressureTest.Drift", "Progress.Add", 1],
["PressureTest.Drift", "Chance", 30]Drift - часть события. На очередном ходу она с вероятностью 30% добавит 1: например, шкала 2 станет 3. При несработавшем броске останется 2. В ход рождения события этот шаг не выполняется; без Chance прибавка происходила бы каждый ход.
Наконец, назначим исход для нижней границы.
["PressureTest.Lower", "Requires.Progress", 0],
["PressureTest.Lower", "Has", "PressureWon"]Lower проверяет точное значение 0 и при его достижении запускает PressureWon. В полном файле этот исход даёт 5 науки. До подключения этой ветви ноль был только числом шкалы; теперь он означает успех. Аналогичная Upper свяжет 5 с неуспехом. Необязательный Insurance добавляется только после знакомства с готовым противостоянием.
Полный пример самостоятельного противостояния со сроком 12 ходов. Duration здесь задаёт крайний срок, а не разрешение завершать ход. Событие со шкалой Progress не блокирует переход хода и без Duration. Можно закрыть окно, не выбирать Relief и завершить ход — Drift получит свой бросок 30%.
Relief бесплатен, уменьшает шкалу на единицу и оставляет событие открытым, пока не определится исход. Два нажатия с исходных 2 доведут шкалу до нуля и дадут успех. Нижняя граница даёт науку, верхняя забирает минералы. Подходящая ветвь завершает событие досрочно даже при Duration; если к концу срока ни одна граница не достигнута, Has на корне задаёт исход неуспеха.
[
["PressureTest", "Is", "Event"],
["PressureTest", "Name", "PressureTestName"],
["PressureTest", "Icon", "flask"],
["PressureTest", "Duration", 12],
["PressureTest", "Progress", 2],
["PressureTest", "Progress.Min", 0],
["PressureTest", "Progress.Max", 5],
["PressureTest", "Has", "PressureRelief"],
["PressureTest", "Has", "PressureLost"],
["PressureTest.Drift", "Progress.Add", 1],
["PressureTest.Drift", "Chance", 30],
["PressureTest.Lower", "Requires.Progress", 0],
["PressureTest.Lower", "Has", "PressureWon"],
["PressureTest.Upper", "Requires.Progress", 5],
["PressureTest.Upper", "Has", "PressureLost"],
["PressureRelief", "Is", "EventChoice"],
["PressureRelief", "Name", "PressureReliefName"],
["PressureRelief", "Cost.Credits", 0],
["PressureRelief", "Progress.Target", "Parent"],
["PressureRelief", "Progress.Gain", -1],
["PressureWon", "Is", "Event"],
["PressureWon", "Name", "PressureWonName"],
["PressureWon", "Adds.Science.Count", 5],
["PressureLost", "Is", "Event"],
["PressureLost", "Is", "Failure"],
["PressureLost", "Name", "PressureLostName"],
["PressureLost", "Adds.Minerals.Count", -5],
["RandomEvents", "Deck.PressureTest", 1]
]Progress = N задаёт начальное значение шкалы события. Progress.Min и Progress.Max - границы, нижняя по умолчанию ноль. Любая правка ограничивается диапазоном. Progress.Name и Progress.Hide задают подпись и показ. Дочерняя часть с Progress.Add меняет шкалу каждый ход, с Progress.Set устанавливает значение. Chance этой ветви задаёт вероятность шага, без Chance ветвь действует каждый ход.
Вариант PressureRelief мгновенно уменьшает шкалу своей плашки и оставляет её живой. Progress.Set с Progress.Target Parent задаёт точное значение. Ветки шага упорядочены Order, затем идентификатором в ordinal-порядке. Случайные ветки с Chance или Chance.Deck — альтернативы одного хода: после первой успешной остальные случайные ветки не бросаются. Ветки без шанса применяются независимо от этого выбора. Первая ветка, реально достигшая границы, завершает весь шаг. Ход рождения не шагает.
Развязки шкалы объявляются обычными условиями Requires.Progress и исходами Has соответствующей части. Сам минимум или максимум не называет победу. Подходящая ветвь может завершить плашку при изменении состояния до дедлайна, в том числе если у неё есть Duration.
Без Duration событие со шкалой может ждать своей развязки неограниченно; шкала и объявленные ветки по-прежнему управляют его завершением. Обычный обязательный выбор без шкалы и без срока остаётся отдельным случаем блокировки хода. Progress.Turn и Progress.Fired — сохранённые служебные факты, их не записывают в файлы мода. Числовой механизм общий с задачами Processing, но событийные исходы шкалы не заменяют оплату и выполнение работы.
Необязательное дополнение после знакомства с основным PressureTest - платная страховка против его шага Drift. Включите этот фрагмент в тот же Logic-массив; он не является самостоятельным новым событием.
Для управления вероятностью шага PressureTest.Drift из полного примера добавьте следующий вариант. Каждый клик стоит один кредит и снижает шанс неблагоприятного шага именно открытого события на 10 процентных пунктов. Событие остаётся открытым; сам шаг в момент клика не выполняется. Шанс ограничен 0..100; при достижении нижней границы уменьшать больше нечего.
Chance.Target принимает Parent.<имя части>, а не произвольный адрес. Chance.Max на самой части ограничивает верхнюю границу при положительном Chance.Add; по умолчанию 100. Эта операция меняет шанс ветви Progress, а не общий риск обычного Event без шкалы.
["PressureTest", "Has", "PressureInsurance"],
["PressureInsurance", "Is", "EventChoice"],
["PressureInsurance", "Name", "PressureInsuranceName"],
["PressureInsurance", "Cost.Credits", 1],
["PressureInsurance", "Chance.Target", "Parent.Drift"],
["PressureInsurance", "Chance.Add", -10]Goal - цель задания
Задание просит игрока добиться определённого результата к сроку. Goal проверяет этот результат, а Event и его ветви определяют, что считать успехом и какой исход выдать при опоздании.
HQ - готовый штаб основной игры. Перед выдачей такого задания у игрока уже должно быть реальное право построить штаб: изучена нужная технология, подходит место и нет запрещающего ограничения. Target.Build HQ проверяет эту возможность; у совсем нового игрока без права стройки карта пока недоступна.
Начнём с цели будущего задания: дождаться готового собственного штаба в выбранном месте. Место уже выбрано знакомыми Target; ниже разбирается только проверка результата.
["HeadquartersQuest.Done", "Goal.Has", "HQ"],
["HeadquartersQuest.Done", "Has", "HeadquartersBuilt"]Goal.Has HQ проверяет завершённый штаб игрока на мире этого задания. Стройка, чужой штаб или собственный штаб на другом мире не подходят. Как только условие выполнено, ветвь Done запускает HeadquartersBuilt; в полном файле он выдаёт 8 науки. Сам Goal штаб не строит.
Теперь ограничим ожидание и назначим запасной исход.
["HeadquartersQuest", "Duration", 12],
["HeadquartersQuest", "Has", "HeadquartersLate"]Duration даёт 12 ходов на выполнение. Если к концу срока проверка Done не подходит, корневой Has запускает HeadquartersLate: в примере игрок потеряет 3 минерала. Успешная проверка может завершить задание раньше. Теперь соберём объявление события, выбор места, обе ветви и определения исходов в полный файл. Имена переводятся обычным словарём Text.
[
["HeadquartersQuest", "Is", "Event"],
["HeadquartersQuest", "Name", "HeadquartersQuestName"],
["HeadquartersQuest", "Icon", "flask"],
["HeadquartersQuest", "Duration", 12],
["HeadquartersQuest", "Target", "World"],
["HeadquartersQuest", "Target.Explored", true],
["HeadquartersQuest", "Target.Build", "HQ"],
["HeadquartersQuest", "Has", "HeadquartersLate"],
["HeadquartersQuest.Done", "Goal.Has", "HQ"],
["HeadquartersQuest.Done", "Has", "HeadquartersBuilt"],
["HeadquartersBuilt", "Is", "Event"],
["HeadquartersBuilt", "Name", "HeadquartersBuiltName"],
["HeadquartersBuilt", "Adds.Science.Count", 8],
["HeadquartersLate", "Is", "Event"],
["HeadquartersLate", "Is", "Failure"],
["HeadquartersLate", "Name", "HeadquartersLateName"],
["HeadquartersLate", "Adds.Minerals.Count", -3],
["RandomEvents", "Deck.HeadquartersQuest", 1]
]Подходящая ветвь задания может завершить плашку досрочно при изменении мира; Duration задаёт крайний срок, а не запрет раннего успеха. На последней проверке подходящий успех имеет приоритет над запасным провалом. Если одновременно подходят несколько дочерних ветвей, выбирается первая по полному имени в порядковом сравнении; называйте приоритетные ветви A…, B… и делайте условия непересекающимися.
Потеря или уничтожение выбранного места не переводит Goal.Has на игрока: цель остаётся невыполненной и сработает неуспех срока. Для собственного специального исхода потери места нужна отдельная ветвь с проверяемым условием и Has; сама пропажа не изобретает такой исход. Если общие условия существования задания отпали либо партия завершена, очистка плашки не выдаёт автоматически её награду или штраф.
Goal.F проверяет требуемое состояние теми же сравнениями, что Requires. Goal.Has HQ означает иметь завершённый собственный штаб на выбранном мире плашки. Чужой штаб, стройка и штаб в другом месте не выполняют цель. Если цели нет у такого задания, она не подменяется игроком. Без объявленного выбора места состояние относится к владельцу задания.
Goal.R N требует прироста ресурса на N после выдачи задания. Goal.R.Percent задаёт процент прироста от исходного запаса, Goal.R.Scaled использует Scaled, Goal.R.Min задаёт минимальный прирост. Требуемый запас сохраняется при выдаче задания.
Для задания на прирост населения используйте другую цель вместо Goal.Has HQ. Сначала зададим только процент. Это альтернативная версия ветви Done, а не дополнение к штабу.
["HeadquartersQuest.Done", "Goal.Workers.Percent", 40]При населении 20 в момент выдачи задания требуется получить ещё 8 работников: целевой уровень будет 28. Уже имевшиеся 20 не выполняют задание. Порог сохраняется при выдаче и не пересчитывается вслед за текущим населением.
Если восемь работников - слишком мало, добавим минимальный прирост.
["HeadquartersQuest.Done", "Goal.Workers.Percent", 40],
["HeadquartersQuest.Done", "Goal.Workers.Min", 15]Теперь при тех же 20 работниках нужно ещё 15, то есть всего 35. При начальных 100 процентная часть требует 40 и превышает минимум: цель будет 140. Остальное устройство задания - срок, исходы, включение в группу - сохраняется.
Количество цели положительное, Min допускает ноль и требует основную величину того же ресурса. Независимые ветви имеют независимые пороги. Goal называет успех задания, Requires - общие обстоятельства, например потерю цели. Для полного задания нужны Event, срок, ветви успеха и неуспеха с Has на исходы и включение в существующую группу. Голый Goal без поля, старый Request и технические Goal.*.Required не являются авторскими формами.
Награда задания — обычный исход Event, связанный с успешной веткой через Has. Отдельного Reward для задания нет. Окно и тултип автоматически показывают разовые ресурсы и постоянные модификаторы исхода. Например, к уже объявленному HeadquartersBuilt можно добавить отдельную процентную прибавку рабочих и постоянную скидку:
["HeadquartersBuilt.Growth", "Target", "Workers.Count"],
["HeadquartersBuilt.Growth", "Adds.Percent", 20],
["HeadquartersBuilt.Growth", "Adds.Percent.Min", 5],
["HeadquartersBuilt.Growth", "Adds.Round", "Floor"],
["HeadquartersBuilt", "Multiplies.Cost.Build", 0.9]Самостоятельная Growth меняет запас рабочих владельца, а не мир-цель задания. 20% округляются вниз, затем применяется минимум 5 рабочих. При населении 20 на момент выдачи обещано 5; если до выполнения население станет 40, награда всё равно 5, а не 8. Количество фиксируется при рождении активного задания, в том числе для исходов, пока недоступных по условиям, и сохраняется с партией. Разовая прибавка не становится постоянным процентным эффектом; независимую скидку поэтому записываем на другом субъекте. Multiplies.Cost.Build 0.9 остаётся обычным постоянным эффектом исхода, а не частью процентного снимка.
Условия Requires исхода и запреты Blocks проверяются при выдаче награды. Достигнутая цель не разрешается досрочно, пока ни один объявленный исход её ветки не доступен; задание продолжает ждать в пределах своего срока. На сроке по-прежнему действует объявленная развязка. Не снимайте условия ради показа будущей награды. Одобрение в наградах совета выводится после остальных ресурсов и модификаторов. Процентные ресурсы, постоянная скидка и Одобрение не требуют отдельного кода окна.
Для события, которое игрок несёт через Player Has, собственный Duration отсчитывается от рождения; условие Requires.Turn.More/Less лишь ограничивает допустимое появление. Если собственного срока нет, верхняя граница Requires.Turn.Less задаёт оставшееся окно. Это разные способы задать время, а не два значения для сложения. Общие категории медалей задают одинаковые окна для предварительных целей и итоговых событий; показанное имя цели не выбирает медаль вместо условий.
Notifies - реакция и сообщение
Notifies связывает сообщение с определённым случаем: разведка завершена, задаче не хватает ресурсов, работники потеряны. У действия или ресурса Has перечисляет реакции, а у самой реакции Notifies указывает случай. Название и значок задаются обычными Name и Icon. Сообщение появляется после настоящего результата, а не от одного наличия этих полей.
Explore - готовая разведка. ExploreDone - её готовая реакция успешного завершения, уже переведённая базовой игрой. Это действующая связка, не новое событие:
["Explore", "Has", "ExploreDone"],
["ExploreDone", "Notifies", "Completed"],
["ExploreDone", "Name", "ExploreDone"]После настоящего завершения разведки игрок получает сообщение ExploreDone. Реакции не нужна дополнительная роль Event; операция и её результат принадлежат действию Explore.
Has у Explore включает ExploreDone. Notifies Completed у ExploreDone означает «сообщить о завершении», а не ссылается на перевод. Реакция может иметь Name, Description, Icon, Color, Popup и Sound. Для обычного сообщения не нужны дополнительные Is Notification и Is Event. Name, Has или Adds сами по себе не вызывают сообщение.
- Completed: успешное завершение действия, результата или награды. Started: запуск процесса миссии. Unlocked: разблокировка возможности.
- Shortage: нехватка ресурса и её причинный эффект. Offline: выключение потребителя при нехватке. Stopped: приостановка задачи.
- Destroyed: уничтожение объекта. Spread: распространение. Defeat: причина поражения.
- Casualties: фактические потери работников. Withdrawn: снятие назначений. Другие произвольные слова случая не объявляются одним Notifies.
Реакция Shortage может не только сообщить о нехватке ресурса, но и применить её последствие. Заменим голод от нехватки воды своим правилом. Сохраните весь объект ниже в Logic/WaterShortage.json: remove убирает прежнюю реакцию Starvation, add включает новую MyWaterShortage. Дополнительное удаление старого Has перед этим файлом не нужно.
Вода в основной игре расходуется на население через Upkeep.Water с мерой Workers. Если расчёт хода требует опустить её запас ниже нуля, вода обнуляется и один раз применяется заданная реакцией потеря работников. Ровно нулевой остаток без нехватки потерь не вызывает. Размер недостачи штраф не умножает. При продолжающемся дефиците следующий ход проверяет уже уменьшенное население. Реакции не нужен Is Event: её вызывает проверка жизнеобеспечения.
{
"remove": [
["Water", "Has", "Starvation"]
],
"add": [
["Water", "Has", "MyWaterShortage"],
["MyWaterShortage", "Notifies", "Shortage"],
["MyWaterShortage", "Name", "MyWaterShortageName"],
["MyWaterShortage", "Icon", "cosmo_helmet_minus"],
["MyWaterShortage", "Multiplies.Workers.Count", 0.9],
["MyWaterShortage", "Multiplies.Round", "Floor"]
]
}В Text/ruRU.json добавьте MyWaterShortageName, например «Нехватка воды». При населении 11 множитель 0.9 даёт изменение −1.1. Multiplies.Round Floor округляет именно потерю вниз до −2: останется 9 работников. Blocks MyWaterShortage отменяет это последствие, отсутствие Popup меняет только показ.
Для нового ресурса жизнеобеспечения нужна не одна реакция Has, а расход Upkeep с мерой Per S.Count: так игра определяет, какое количество S этот ресурс поддерживает. Фиксированный расход без меры этого не задаёт. Одна реакция Shortage меняет ровно одно количество.
Реакции наследуются вместе с действием или ресурсом, у которых они включены. Общее сообщение можно заблокировать через Blocks, чтобы заменить своим и не получить два уведомления. Реакция Shortage принадлежит ресурсу, которого не хватило: Water Has Starvation. Менять она может другое количество, например Workers.Count. Скрытое сообщение всё ещё применяет последствие. Обычному событию, которое само имеет Is Event, дополнительный Notifies ради названия не нужен.
Marks и Unmarks - постоянная черта цели
После захвата мира состояние может остаться навсегда, даже когда сообщение события закрыто. Marks прикрепляет такое состояние, Unmarks снимает его после освобождения. Trait подходит для состояния с собственными свойствами и поведением; простой Is-тег сообщает только принадлежность категории.
Используем готовое восстание роботов. Сначала прочитаем состояние захваченного мира.
["RobotHeldTrait", "Is", "Trait"],
["RobotHeldTrait", "Control.Here", 0]Это уже существующая черта: мир с RobotHeldTrait теряет доступную для работы территорию. Одно определение RobotHeldTrait ни на один мир её не помещает.
Теперь прикрепим черту при настоящем неуспешном исходе восстания.
["WorldLost", "Target", "Parent.Target"],
["WorldLost", "Marks", "RobotHeldTrait"]WorldLost получает выбранный мир исходного события через Parent.Target. Marks оставляет на нём RobotHeldTrait для затронутого игрока. Например, прежде доступные рабочие места станут недоступны; закрытие сообщения черту не снимет.
Для освобождения мира нужна обратная операция в настоящем результате миссии возврата.
["RetakeDone", "Target", "Parent.Target"],
["RetakeDone", "Unmarks", "RobotHeldTrait"]RetakeDone снимает именно эту черту с возвращённого мира. Другие запреты остаются. Ниже - вся готовая цепочка: её события, миссия и запуск уже существуют в основной игре.
["RobotHeldTrait", "Is", "Trait"],
["RobotHeldTrait", "Control.Here", 0],
["WorldLost", "Target", "Parent.Target"],
["WorldLost", "Marks", "RobotHeldTrait"],
["RetakeDone", "Target", "Parent.Target"],
["RetakeDone", "Unmarks", "RobotHeldTrait"]WorldLost оставляет на мире ограничение работы. Оно не пропадёт от закрытия плашки: его снимает только соответствующий возврат. Другие остающиеся ограничения не удаляются. Для собственной цепочки нужны объявленные Event-исходы, их реальный запуск и переданная цель; отдельная Marks на произвольном имени никого не захватит.
Marks = Definition присоединяет указанное к явной цели при рождении события или разрешении исхода. Unmarks снимает его. Обычная категория становится Is-тегом тела. Если указанное определение имеет Is Trait, цель получает эту черту постоянно для затронутого игрока. У события или создаваемого им исхода должен быть Target, определение должно существовать.
Утрата сектора запрещает работу здесь до явного возврата. Исчезновение плашки события не снимает постоянную черту. Снятие одного присутствия не удаляет чужое или оставшееся от другого источника. Здесь не нужны промежуточный технический тег и правило, угадывающее его по имени. Временный числовой эффект со сроком проще выражается Duration и обычными операциями.
Turn - ход и расписание
Каждый завершённый ход игрока продвигает время мира на единицу. Группа Events делает попытку разыграть карту по своему календарю. Например начало 3 и интервал 7 означают попытки на ходах 3, 10, 17.
Simulation Turn хранит номер хода. Автор события обычно не меняет это состояние, а задаёт расписание группы. Начнём с одной попытки: это заготовка MyEvents, к которой ниже подключим готовое событие с разовой выдачей минералов.
["MyEvents", "Is", "Events"],
["MyEvents", "Turn.Starts", 3]Turn.Starts 3 назначает первую попытку на ход 3 обычной партии. Без интервала она будет единственной: если на этом ходу подходящей карты нет, на ходу 4 автоматического повтора не будет.
Чтобы группа продолжала делать попытки, зададим интервал.
["MyEvents", "Turn.Every", 7]Every 7 добавляет семь ходов между попытками: после 3 будут 10, 17 и так далее. Недоступная карта не сдвигает следующую попытку на ближайший ход. Теперь подключим событие с выдачей минералов и соберём расписание. Turn.Max и передача через Then разбираются после этого примера.
MyEvents обозначает новую самостоятельную группу. SuppliesMinerals является готовым событием: оно один раз добавляет игроку минералы. В игре оно называется «Найдены припасы»; название берётся из ключа перевода Supplies. Фрагмент включает его в собственное расписание, не объявляя награду повторно:
["MyEvents", "Is", "Events"],
["MyEvents", "Turn.Starts", 3],
["MyEvents", "Turn.Every", 7],
["MyEvents", "Deck.SuppliesMinerals", 1]Turn.Starts 3 и Turn.Every 7 назначают попытки на ходах 3, 10, 17 и далее. Начальная подготовка мира не разыгрывает карту: если Starts уже не позже начального хода, первая возможность приходится на следующую обычную проверку после продвижения времени. Starts без Every даёт одну назначенную попытку. Every без Starts назначает первый срок от первой очередной проверки группы, а не обещает розыгрыш сразу при создании; задавайте Starts явно, когда важен первый номер хода.
Новая группа с Is Events и собственным расписанием обнаруживается игрой сама. Не нужен второй указатель Events на Simulation или Deck событий на Simulation. Дочерняя часть группы с Requires и Deck задаёт условную ветвь, проверяемую по её условиям, а не отдельный постоянный таймер. Ветка без Requires недопустима. Одно расписание у произвольного субъекта без событийного потребителя не создаёт исполнение. Для случайного начала и паузы работают стандартные диапазоны Random. Turn.Next - служебный назначенный ход, не исходная авторская настройка.
Период следующей попытки назначается до выбора карты. Если карта пока недоступна из-за технологии, конфликта, активной Unique-плашки или отсутствия подходящей цели, она возвращается в колоду и не тянется повторно в том же розыгрыше. Игра пробует другие доступные карты этого состава. Если подходящих карт нет, ничего не появляется, но следующая попытка остаётся по расписанию.
При Starts 3 и Every 7 неудачная попытка на ходу 3 не превращается в повтор на ходу 4: следующая будет на 10. Новое исследование или раскрытие тела между этими ходами не обходит период.
Без Every назначенная одиночная попытка не повторяется сама, даже если все карты тогда были недоступны. Then может отдельно передать новую очередь по Turn.Pause. Условные ветви группы и цели, реагирующие на состояние, имеют свой объявленный контекст и не являются неявным повтором пропущенного расписания. Обучение приостанавливает часы групп и сдвигает назначенные сроки на время паузы, поэтому пример календаря относится к обычной партии без такой паузы.
Дополнительное правило передачи очереди: Then может переназначить время группы; это отличается от независимых периодических попыток.
Turn.Pause на группе - задержка передачи Then, не добавка к каждому Turn.Every. При обычном Then новое назначение равно текущему ходу + Pause, но не раньше Starts; оно заменяет прежний назначенный срок группы. Если получившийся срок строго больше Turn.Max, назначение удаляется и попытки на Max не будет; равенство Max допускает попытку на этом ходу.
Когда назначенный срок наступит и попытка выполнится, следующий назначается через Every от фактического хода попытки. Например передача на ходу 10, Pause 3, Starts 20, Every 5 даёт первую попытку на 20, затем 25, 30… Без Starts первая была бы 13. Then.Now обходит Pause и разыгрывает немедленно, после чего Every рассчитывается от текущего хода.
Начальный независимый запуск по Starts и последующая передача одной группе могут переназначать её часы; для двух независимых сюжетных расписаний объявляйте две разные группы.
Turn.Max на Simulation или выбранном режиме - предел партии, Turn.Ending - определение завершающего события. При попытке перейти за последний ход оно разрешается вместо обычного расчёта. Условие Requires.Turn.Max N означает сравнение номера хода ≤ N и не устанавливает предел времени. Эти два употребления границы различаются.
Выбор партии, обучение и результаты
Corporation, Rule и Scenario - выбранные определения
Перед новой партией игрок выбирает корпорацию, режим и сценарий. Корпорация даёт ему собственные способности. Режим задаёт правила партии, например способ оплаты действий. Сценарий определяет карту и стартовые условия. Это три разных определения с разными задачами.
MyCorporation ниже - новая корпорация с прибавкой к добыче. MyScenario - новый вариант готового ScenarioG, жёлтой звезды с обычным стартом. Наследование сохраняет работников и все базовые запасы; ExtraStart добавляет минералы сверх них. Новые ключи имён переводятся в Text/ruRU.json.
Начнём с способности корпорации. Оформление новой карточки добавим в полном примере; здесь показано только объявление и бонус.
["MyCorporation", "Is", "Corporation"],
["MyCorporation", "Adds.Production.Minerals", 0.2]После выбора MyCorporation её игрок получает прибавку 0.2 к ставке добычи минералов. При исходной ставке 1 каждый назначенный добытчик даст 1.2 вместо 1. Корпорация не создаёт этих работников и не выдаёт минералы до их работы.
Независимо от корпорации создадим сценарий с дополнительным стартовым запасом.
["MyScenario", "Is", "ScenarioG"],
["MyScenario.ExtraStart", "Adds.Minerals.Count", 20]MyScenario наследует карту и весь стартовый набор ScenarioG. ExtraStart один раз добавит игроку 20 минералов сверх обычного старта: если тот выдавал M, получится M + 20. Отдельное имя ExtraStart сохраняет родительскую часть Start. Полные карточки корпорации и сценария ниже добавляют необходимые имя, значок и параметры сценария.
В партии выбранная корпорация хранится у игрока, а Rule и Scenario - у Simulation. Один Default true задаёт начальный вариант; явный выбор игрока имеет приоритет. Name, Icon и Description описывают карточку варианта. Собственное название корпорации игрока задаётся через InputName, а не заменой Name этой карточки.
["MyCorporation", "Is", "Corporation"],
["MyCorporation", "Name", "MyCorporationName"],
["MyCorporation", "Icon", "corp_miner"],
["MyCorporation", "Color", "orange"],
["MyCorporation", "Adds.Production.Minerals", 0.2],
["MyScenario", "Is", "ScenarioG"],
["MyScenario", "Name", "MyScenarioName"],
["MyScenario", "Icon", "star_yellow00"],
["MyScenario", "Difficulty", "DifficultyNormal"],
["MyScenario", "Orbit.Center", "ClassG"],
["MyScenario.ExtraStart", "Adds.Minerals.Count", 20]Корпорация требует имя и иконку, а если варианты используют Color, цвет задаётся всем. Для собственного названия игрока InputName принадлежит корпорации. Начальная технология может входить в Has корпорации, а игровое действие принадлежит месту и ограничивается Requires.Corporation. Сценарий требует Name, Icon и Difficulty. Orbit.Center - явный структурный выбор звезды.
Даже у наследника сценария задайте его явно. Стартовые выдачи применяются игроку один раз. Start полностью задаёт основной набор, самостоятельная ExtraStart добавляет к унаследованному набору.
Is ScenarioG сохраняет весь родительский ScenarioG.Start, пока у потомка нет собственной части Start. Так наследуются текущие стартовые работники и запасы основной игры. Собственное обычное поле сценария заменяет то же поле предка. С частями определения правило другое: хотя бы одна строка MyScenario.Start заменит весь родительский блок Start, а не одну строку ресурса. Поэтому для добавки к старту в примере используется другое имя части - ExtraStart.
["MyYellowScenario", "Is", "ScenarioG"],
["MyYellowScenario", "Name", "MyYellowScenarioName"],
["MyYellowScenario", "Orbit.Center", "ClassG"],
["MyYellowScenario.ExtraStart", "Adds.Science.Count", 3]Здесь обычные стартовые выдачи ScenarioG сохраняются, а самостоятельная часть ExtraStart добавляет три науки. Чтобы полностью заменить стартовый набор, создайте свою часть Start и объявите в ней весь нужный набор. Один факт с субъектом MyScenario.Start и предикатом Adds.Minerals.Count не сохраняет остальные строки родительского Start. Часть и составной предикат остаются разными конструкциями. Срок, место, требования и последствия нового сценария проверяйте в новой партии.
Rule-режим требует Name, Icon и Description. Его обычные эффекты задаются Multiplies, Adds, Blocks, Has и сроками. Для постоянного бонуса не нужен новый Rule-флаг, если закон уже выражается сроком или обычным эффектом. Вариант, выбранный в главном меню, становится фактом мира при создании партии, не меняет уже запущенную партию задним числом.
Стартовая выдача может зависеть от выбранной корпорации. Не меняя обычный Start, добавим самостоятельную часть для добытчиков:
["MyScenario.MinerStart", "Requires.Corporation", "CorpMiner"],
["MyScenario.MinerStart.Grant", "Adds.Science.Count", 5]Только игрок CorpMiner получит ещё 5 Науки один раз при начале партии. Условие родительской MinerStart действует и на вложенную Grant. Предпросмотр стартовых запасов учитывает выбранную корпорацию. Переключение выбора, повторное применение или загрузка не выдают старт повторно. Это условия начальной выдачи, а не доход за ход.
Rule.* - поддерживаемые настройки партии и сцены
Rule.* задаёт предусмотренные игрой настройки партии или сцены. На определении режима они действуют после его выбора; на Simulation - как общие настройки мира. Новый режим должен иметь Is Rule, Name, Description и Icon. Придуманное имя после Rule не создаёт нового закона: ниже перечислены поддерживаемые настройки.
Различайте настройки мира и показываемой сцены. Правила партии задаются на Simulation или выбранном режиме. Настройки вида читаются у текущей сцены: игровая карта и главное меню могут иметь разные значения. Поэтому изменение подписи в меню не обязательно меняет подписи карты в начатой партии.
Выполнение действий и оплата. Наблюдаемый пример - выбрать режим, в котором стройка платит сразу, вместо ходовых взносов:
Сначала уберём временную длительность у действий нового режима. MyInstantMode пока только заготовка; его карточка объявлена в полном примере ниже.
["MyInstantMode", "Multiplies.Action.Duration", 0]Этот множитель даёт нулевой действующий срок. Однако сам по себе он ещё не делает стройку мгновенной: при обычном Rule.ProgressTasks true вместо таймера появится задача для назначенных работников.
Теперь отключим такой способ выполнения работ.
["MyInstantMode", "Rule.ProgressTasks", false]В сочетании с нулевым сроком стройка и разведка сразу платят полную действующую цену и завершаются. Например, доступная постройка ценой 12 минералов при запасе 20 оставит 8 и появится сразу. При положительном сроке действует временная задача с оплатой по ходам: одно ProgressTasks false этот срок не обнуляет. Ниже обе настройки собраны в полноценный выбираемый режим.
Накопительное исследование - отдельный режим Rule.AccumulatedResearch: оно ждёт полный запас, не списывает взносы и не занимает работников. Все эти пути используют одну действующую цену, уже оплаченная работа и отмена сохраняют свой смысл.
["MyInstantMode", "Is", "Rule"],
["MyInstantMode", "Name", "MyInstantModeName"],
["MyInstantMode", "Description", "MyInstantModeDescription"],
["MyInstantMode", "Icon", "gear"],
["MyInstantMode", "Multiplies.Action.Duration", 0],
["MyInstantMode", "Rule.ProgressTasks", false]- Rule.AccumulatedResearch: true/false, по умолчанию false. True выбирает исследование накоплением запаса до действующей полной цены. Другие действия от этого не переходят на накопление.
- Rule.ProgressTasks: true/false, при отсутствии true. Выбирает рабочую задачу или мгновенную оплату стройки и разведки после проверки их временного срока. Это не замена длительности обычного события.
- Rule.TradeWorker: ссылка на объявленный ресурс. Каждая единица заявки торговли занимает единицу этого ресурса. При выборе Workforce используется его свободный пул. Без правила торговля работников не занимает.
Отдельная задача - разрешить партию без работников. Следующая настройка добавляется к уже объявленному режиму MyInstantMode; со скоростью стройки она не связана.
["MyInstantMode", "Rule.ExtinctionEnds", false]При падении количества работников ниже единицы партия продолжится. Поражение от совета и другие объявленные причины завершения сохраняются.
- Настройки масштаба событий описаны в разделе Scaled.
- Rule.ExtinctionEnds: true/false, при отсутствии true. False отключает именно поражение от запаса работников меньше единицы, сохраняя остальные причины завершения.
- Rule.SuppressNotifications: true/false, по умолчанию false. True подавляет обычные уведомления. Это настройка показа сообщений, а не способ отменить сами игровые последствия.
- Rule.EventWarns: true/false, по умолчанию false. Разрешает предварительные прогнозы событий с Warns.Turns. Сам по себе не добавляет предупреждение каждому событию. Срок, цель и ресурсы прогноза описаны в разделе Events и Event.
- Rule.ScaledByPlayer и Rule.ScaledByTurn принимают true/false и не могут одновременно быть включены после учёта режима, наследования и настроек Simulation. Явный false режима может отключить правило мира. Для масштаба по ходу нужны все три параметра: конечные ResMin и ResMax не меньше нуля, ResMax не меньше ResMin, TurnWin больше 1. TechMod должен быть конечным и неотрицательным.
Для новой карты можно заранее раскрыть окрестности родного мира. Эта настройка применяется при создании партии.
["MyInstantMode", "Rule.StartExplore", 2]StartExplore 2 бесплатно раскрывает тела в начальном радиусе 2 от дома по расстояниям симуляции. Это орбиты и вложенность спутников, а не экранные пиксели. Без настройки раскрыт только родной мир. Изменение уже созданную карту заново не раскрывает. Ниже - справочник настроек генерации.
- Rule.StartExplore: число радиуса бесплатного начального раскрытия. Без факта раскрывается только родной мир. Для этого радиуса расстояние учитывает орбиты и вложенность спутника, а не экранные пиксели.
- Rule.FlankOrbit: номер орбитального кольца. Тела на кольцах не ближе этого порога размещаются на горизонтальных дугах, орбиты остаются круглыми. При отсутствии такого ограничения нет.
- Rule.SatelliteMinSize: числовая нижняя граница типичного Size создаваемого спутника, при отсутствии 0, без отсечения. Используется явный Size класса или середина его объявленного диапазона. Единицы те же, что у Size этой симуляции: не считайте число универсально километрами, в PreWarpAge Size описывает территорию.
Последняя отдельная задача - показать имена тел на игровой карте. Используем Simulation как владельца настроек игрового мира.
["Simulation", "Rule.MapNames", true]MapNames true включает подписи тел у показываемой игровой сцены. Запасы, добыча и состав карты сохраняются. Настройка на отдельной сцене меню относится к меню, поэтому не заменяет настройку игрового мира. Ниже - справочник остальных настроек вида и ввода; каждое поле имеет отдельную задачу.
- Rule.Language: повторяемые строковые коды доступных локалей, например ruRU и enUS. Без списка доступны все загруженные. Код - не название языка для показа.
- Rule.Zoom: положительное целое число видимых орбит для стартового кадра. Без положительного значения используется обзор содержимого.
- Rule.Zoom.Target: Center или Home. Center показывает центр системы, Home родной мир игрока. При нескольких значениях Center имеет приоритет, без выбора используется Center. Применяется вместе с Rule.Zoom.
- Rule.MapNames: true/false, при отсутствии false. Включает подписи карты у показываемой сцены.
- Rule.OrbitMotion: true/false, при отсутствии false. True добавляет визуальное обращение всех орбитальных тел, даже без физического периода. False не является общей командой остановить любые физические анимации.
- Rule.OrbitPauseOnSelect: true/false, при отсутствии false. Включает приостановку орбитального движения при выделении.
- Rule.WorkersSlider: true/false, при отсутствии false. Включает слайдеры и связанный показ рабочих. Не создаёт сам ресурс населения, назначения или рабочие места.
- Rule.GuiSkin: строка имени общего оформления, по умолчанию steel. Поддерживаемое общее альтернативное оформление classic. Это не путь к произвольному CSS и не объявление нового интерфейсного компонента.
- Rule.NoSubMaps: true/false, при отсутствии false. Отключает подкарты вне декоративного режима. В Decorative влияет на плоский сектор, но сохраняет компаньонов радиальной отдельной системы.
Чтобы проверить изменение генерации, начните новую партию. Правка минимального размера спутников или размещения не пересоздаёт уже существующую карту. Настройки интерфейса также не меняют запасы ресурсов и смысл условий.
Tutorial и TutorialStep - обучение
Обучение состоит из шагов: выбрать родной мир, назначить работника, завершить ход. Tutorial связывает сценарий с набором, а Is TutorialStep объявляет отдельный шаг. У шага есть текст подсказки, объект, возле которого её показывать, и условие завершения. Создавать отдельную панель интерфейса для этого не нужно.
Сохраните полный массив ниже в Logic/Training.json, а следующий словарь - в Text/ruRU.json. В новой партии выберите сценарий «Учебная система» и корпорацию добытчиков CorpMiner. SmallTutorial - придуманное имя набора из трёх шагов; Homeworld - существующее обозначение родного мира игрока.
Разберём первый шаг отдельно. Сценарий и набор подключим в полном файле.
["SelectHome", "Is", "TutorialStep"],
["SelectHome", "Order", 1],
["SelectHome", "Text", "SelectHomeText"],
["SelectHome", "Target", "Homeworld"],
["SelectHome", "Tutorial.Awaits", "Select"]Order 1 ставит шаг первым. Text указывает ключ подсказки, Target - родной мир, а Tutorial.Awaits Select ждёт его выделения игроком. Простое появление подсказки шаг не завершит. После выделения обучение перейдёт ко второму шагу.
Во втором шаге будем ждать определённое число назначенных людей, а не простое выделение.
["StaffHome", "Target", "Homeworld"],
["StaffHome", "Tutorial.Awaits", "Workers.Count"],
["StaffHome", "Tutorial", 1],
["StaffHome", "Tutorial.Unlocks", "Workers.Count"]Tutorial 1 здесь означает ровно одного своего работника на родном мире. Ноль или двое не подходят. Unlocks разрешает изменить назначение на этом шаге; рабочие места остаются местами самого мира. Роль, номер и текст StaffHome показаны в полном файле. Третий шаг будет ждать продвижения хода через Requires.Turn: одно разрешение Unlocks EndTurn такой проверки не заменяет.
Теперь соберём три шага и подключим их к сценарию. Карта наследуется от ScenarioG. CorpMiner в Has набора ограничивает обучение добытчиками: другая корпорация не заменяется автоматически, обучение для неё не включится. Options доступен постоянно, изменение Workers.Count - на втором шаге.
[
["TrainingScenario", "Is", "ScenarioG"],
["TrainingScenario", "Name", "TrainingScenarioName"],
["TrainingScenario", "Orbit.Center", "ClassG"],
["TrainingScenario", "Tutorial", "SmallTutorial"],
["SmallTutorial", "Has", "CorpMiner"],
["SmallTutorial", "Tutorial.Unlocks", "Options"],
["SmallTutorial", "Has", "SelectHome"],
["SmallTutorial", "Has", "StaffHome"],
["SmallTutorial", "Has", "PassTurn"],
["SelectHome", "Is", "TutorialStep"],
["SelectHome", "Order", 1],
["SelectHome", "Text", "SelectHomeText"],
["SelectHome", "Target", "Homeworld"],
["SelectHome", "Tutorial.Awaits", "Select"],
["StaffHome", "Is", "TutorialStep"],
["StaffHome", "Order", 2],
["StaffHome", "Text", "StaffHomeText"],
["StaffHome", "Target", "Homeworld"],
["StaffHome", "Tutorial.Awaits", "Workers.Count"],
["StaffHome", "Tutorial", 1],
["StaffHome", "Tutorial.Unlocks", "Workers.Count"],
["PassTurn", "Is", "TutorialStep"],
["PassTurn", "Order", 3],
["PassTurn", "Text", "PassTurnText"],
["PassTurn", "Target", "EndTurn"],
["PassTurn", "Requires.Turn.More", 1],
["PassTurn", "Tutorial.Unlocks", "EndTurn"]
]Следующий блок - полный словарь Text/ruRU.json для этого примера. Если такой файл в моде уже есть, добавьте эти ключи внутрь существующего объекта, сохранив остальные переводы.
{
"TrainingScenarioName": "Учебная система",
"SelectHomeText": "Выделите родной мир.",
"StaffHomeText": "Оставьте на родном мире одного работника.",
"PassTurnText": "Завершите ход."
}Tutorial = TutorialName на сценарии подключает обучение. Сам набор объявляет шаги через Has, каждый шаг имеет Is TutorialStep, уникальный конечный Order больше нуля (дробный ранг, например 1,5, допустим) и Text с ключом подсказки. Target задаёт якорь и объект проверки. Без Tutorial.Awaits и Requires повествовательный шаг ждёт клика по подсказке.
После полного примера - словарь поддерживаемых целей интерфейса. «Якорь» означает существующий объект или кнопку, к которым прикрепляется подсказка:
Target - существующее определение, из которого интерфейс выводит якорь: Homeworld либо иной класс тела → экземпляр на карте; имя Action, например Technologies или EndTurn → кнопка; EventChoice → кнопка выбора; ресурс/показатель, например Science → показатель игрока; Tech → собственная карточка технологии; Event → его живая плашка; Building → вариант строительства.
Новое произвольное имя не создаёт UI-якорь. Для Trade ресурс-цель указывает торговую заявку; для Workers.Count якорь переключается между телом и его ползунком; для Build.Class - между телом и кнопкой постройки. Tutorial.Marks Panel выделяет существующую панель, а не создаёт новую.
- Tutorial.Awaits Select: цель выделена. Deselect: окна и выделение закрыты. Tooltip: показана подсказка цели.
- Explore: цель разведана. Research: технология цели изучена. Build.ClassName: своя готовая постройка класса на цели.
- Workers.Count и Tutorial N: ровно N своих работников на цели. Trade и Tutorial N: заявка торговли ресурсом-целью равна N. Tutorial на самом шаге здесь число, а на сценарии ссылка.
- Имя Event в Tutorial.Awaits: у игрока появилась плашка этого класса. Unaffordable: вариант-цель перестал быть по карману.
- Requires.Turn и другие условия шага проверяют мир. Creates создаёт событие при входе, Creates.Target выбирает его место.
- Tutorial.Unlocks на шаге дополнительно открывает действие, поле или категорию. На всём наборе объявляется постоянно разрешённое. Замок определяется текущим шагом, разрешения прошлых шагов не накапливаются.
- Tutorial.Marks Panel выделяет панель якоря. Tutorial.Side принимает Above или Below. Подсказка без явной стороны размещается клиентом по доступному месту.
Has набора может ограничить доступные варианты выбранных осей, например оставить одну корпорацию. Во время обучения часы случайных событий стоят. Обратимые ожидания могут вернуть предыдущий шаг, если состояние откатилось. Текущий Tutorial.Step и Tutorial.Done - состояние партии, их не задают для пропуска обучения. Подстановки Text читают живые значения: {Workers.Count}, {Change.Water}, {Cost}, {Damage}, {Target.Size}, {ClassName.Cost}, {ChoiceName.Shortfall}. Числа не переписывают вручную в переводе.
Шаги можно включать не только прямыми Has набора, но и через его условные части. Например, часть с Requires.Corporation CorpTechnocrat и Has нужного шага добавит его только Технократам. Условия проверяются для текущего игрока, затем прямые и подходящие условные шаги объединяются без повторов и сортируются по Order. Ограничение Has CorpMiner из полного примера при этом нужно убрать, если курс должен запускаться и для других корпораций; роль Has на выбранной оси и включение TutorialStep не взаимозаменяемы.
Tutorial.Awaits также может называть объявленное действие, например Cloning. Для такого действия проверяется настоящий результат Completed игрока, а не одно нажатие кнопки. Target Cloning задаёт существующий якорь действия; {Cost} и {Gains} читают его действующую цену и результат, без ручных чисел в тексте.
Действие TutorialDisable отключает курс без перезапуска мира и без отметки о полном прохождении. Текущие события, назначения работников и торговые заявки сохраняются. Учебная пауза прекращается вместе с курсом, но независимо заданный Events.Hold не снимается. Tutorial.Step хранит ссылку на текущий шаг, а не номер Order; это сохранённое состояние, его не задают в Logic для пропуска уроков.
History и Statistics - хроника и счётчики
History задаёт запись в хронике о произошедшем результате: постройка завершена, груз доставлен, предложение истекло. Statistics считает действия и поступления за всю партию. Хроника хранит фразы, статистика - числа; одно не заменяет другое.
Сначала поменяем запись о настоящем получении груза кометы. CometReturn - готовый успешный исход её сбора.
["CometReturn", "History", "MyCargoReceivedHistory"]History ссылается на ключ перевода MyCargoReceivedHistory. Если в Text/ruRU.json этому ключу соответствует «Получен груз кометы.», эта фраза появится после успешного сбора. Одна запись History комету не создаёт и груз не выдаёт.
Другая задача - записать строительство только первого аванпоста за партию.
["Outpost", "History", "MyLabBuiltHistory"],
["Outpost", "History.OnlyFirst", true]Первое завершение Outpost добавит фразу, последующие завершения того же класса - нет. OnlyFirst управляет хроникой и не запрещает строить второй аванпост. Ниже объединим эти записи и добавим отдельную фразу истечения предложения SpaceFashion.
["CometReturn", "History", "MyCargoReceivedHistory"],
["Outpost", "History", "MyLabBuiltHistory"],
["Outpost", "History.OnlyFirst", true],
["SpaceFashion.Ignored", "Requires.Duration", 0],
["SpaceFashion.Ignored", "History", "MyOfferIgnoredHistory"]Это замена текстов существующих результатов, не создание события от одного History. Словарь Text/ruRU.json:
{
"MyCargoReceivedHistory": "Получен груз кометы.",
"MyLabBuiltHistory": "Построен {subject} на {target}.",
"MyOfferIgnoredHistory": "Предложение переселения истекло."
}History хранит ключ фразы из Text. History.OnlyFirst true оставляет только первое завершение данного класса за партию. History.Independent true начинает отдельную последовательность записей, History.Begin на Simulation задаёт её начальное событие основания корпорации. Вместо {subject} подставляется сохранённое название постройки или другой описываемой вещи, вместо {target} - имя цели. Эти имена сохраняются даже после исчезновения тела.
В примере SpaceFashion.Ignored добавляет фразу при истечении срока. Она не создаёт отдельное событие и не выдаёт его эффект. Закрытие окна, удаление и истечение срока - разные случаи. Одновременно подходящие разные тексты History считаются ошибкой. Если History не задан, завершённый результат использует своё Name или имя основного события. Одного названия недостаточно, чтобы любое незавершённое предложение попало в хронику.
Статистику включают независимо от фраз хроники. Следующая строка относится к игроку.
["Player", "Statistics", true]Для отдельного опыта начните с нулевого запаса некоторого ресурса и без прежних поступлений. Настоящая награда добавила 5: запас стал 5, Received для него - 5. Потом действие потратило 3: запас стал 2, а Received остался 5. Полученное за партию не равно оставшемуся на складе. Счётчик меняет сама игра после реального получения, а не строка мода с желаемым итогом.
Счётчики Seconds, Loads, Explored, Built, Studied, Received, Mined, Bought и Sold обновляет игра. Торговые ресурсы определяются объявленными курсами и валютой, отдельный список Statistics.Resource.R не нужен. Состояния History.Entry/Turn/Source и Statistics.Run - не авторские команды и не способ накрутить прогресс. Отсутствующий счётчик Statistics читается как ноль, в том числе в Requires, без создания факта. Но это не подтверждение полноты истории: отсутствие собственного Statistics.Loads у игрока не доказывает, что загрузок не было.
History.Hide исключает техническое уведомление из хроники корпорации, не скрывая само уведомление. Существующее определение TradeShortage общее для сообщений о нехватке ресурсов при торговле. Этот пример скрывает их историю и явно возвращает её для сообщения о Минералах:
["TradeShortage", "History.Hide", true],
["TradeMineralsShortage", "History.Hide", false]Настройка принадлежит определению источника. Она наследуется через Is; ближайший явный false отменяет true предка. Скрытый источник не создаёт новую запись хроники, а техническое лицо со скрытой историей не переписывает существующий сюжет. Старые сохранённые записи этого источника исключаются при чтении истории без удаления их фактов. Иконки, попапы, сроки и игровые эффекты уведомлений продолжают работать. History.Hide подавляет и явный текст History, и подстановку имени события.
Completed и Track - подтверждённые результаты
Track считает совершённые действия и результаты. Например, он может считать построенные аванпосты, включая уже снесённые, но не начатую стройку. Для этого игра сохраняет Completed - запись о завершении с его обстоятельствами. Track читает эти записи; сам он ничего не строит и не выполняет.
Completed может описывать завершение действия, создание объекта, производство, изменение населения или финал. В Requires.Completed читаются сведения именно того результата, который сейчас проверяется. Например, Requires.Completed.Credits.Min сравнивает деньги на момент завершения, даже если позднее они потрачены. Создавать такие записи вручную в Logic нельзя: они должны соответствовать настоящему результату игры.
Track с именем действия или вещи объявляет счётчик её завершений, включая наследников через Is. Имя счётчика придумывает автор: оно должно быть простым и не совпадать со встроенным полем, предикатом или оператором. Это имя сразу можно читать в условии; Is Predicate не требуется. Requires у счётчика добавляет условия результата, а не повторяет то, что уже указано в Track.
Сначала посчитаем завершённые аванпосты. MyBuiltOutposts - придуманное имя счётчика; Outpost уже существует.
["MyBuiltOutposts", "Track", "Outpost"]После трёх завершённых аванпостов значение MyBuiltOutposts равно 3. Снос одного не уменьшит счётчик: он считает завершения, а не оставшиеся здания. Начатая стройка ещё не засчитана. Player Has не нужен, Is Predicate для имени счётчика тоже не требуется.
Для разведки иногда нужно считать разные места. Сначала объявим наблюдение Explore, затем укажем, как различать его результаты.
["MyExploredPlaces", "Track", "Explore"],
["MyExploredPlaces", "Track.Key", "Completed.Target"]Completed.Target сохраняет идентификатор разведанного тела. MyExploredPlaces читает число завершений, а MyExploredPlaces.Unique - число разных ключей. Например, у двух результатов с одной и той же целью первое значение было бы 2, второе - 1. Это объяснение различия счётчиков, а не обещание возможности повторной разведки. Для полноты всей карты понадобится ещё фиксированный список - он разбирается после задания на аванпосты.
["MyBuiltOutposts", "Track", "Outpost"],
["MyExploredPlaces", "Track", "Explore"],
["MyExploredPlaces", "Track.Key", "Completed.Target"]Теперь используем счётчик в задании CensusTask: завершить три аванпоста за партию. Следующие строки составляют один пример; поместите их внутрь общего массива Logic-файла. Ключи CensusTaskName, CensusWonName и CensusLateName добавьте в Text/ruRU.json.
Сначала потребуем три завершённых аванпоста за всю партию. Это проверка ветви будущего CensusTask.
["CensusOutposts", "Track", "Outpost"],
["CensusTask.Done", "Requires.CensusOutposts.Min", 3]При двух завершениях условие ложно, при трёх - истинно. Аванпосты до выдачи задания тоже учитываются. Завершения наследников Outpost входят в тот же счётчик. Именно эта версия используется в полном файле ниже.
Если нужны три новых аванпоста после появления задания, замените строку условия следующей. Не оставляйте обе версии одновременно.
["CensusTask.Done", "Requires.CensusOutposts.Min.Add", 3]Если при выдаче задания уже было два завершения, порог один раз станет 2 + 3 = 5. Третий и четвёртый аванпост ещё не выполнят задание, пятый выполнит. Порог не пересчитывается вслед за растущим счётчиком. Так можно потребовать новую работу, сохраняя счётчик всей партии.
["CensusWon", "Name", "CensusWonName"],
["CensusLate", "Name", "CensusLateName"],
["CensusOutposts", "Track", "Outpost"],
["CensusTask", "Is", "Event"],
["CensusTask", "Name", "CensusTaskName"],
["CensusTask", "Icon", "outpost"],
["CensusTask", "Duration", 20],
["CensusTask", "Has", "CensusLate"],
["CensusTask.Done", "Requires.CensusOutposts.Min", 3],
["CensusTask.Done", "Has", "CensusWon"],
["CensusWon", "Is", "Event"],
["CensusWon", "Adds.Science.Count", 10],
["CensusLate", "Is", "Event"],
["CensusLate", "Is", "Failure"],
["RandomEvents", "Deck.CensusTask", 1]Для проверки всей карты нужно различать разведанные тела. Track.Key Completed.Target сохраняет идентификатор каждого из них. Track.Required Owner.Explored.Required сравнивает разведанные тела со списком требовавших разведки в начале партии. Requires.ChartedBodies.Covers true требует охватить весь этот непустой список. ChartedBodies.Unique лишь считает разные тела и само по себе полноту не проверяет.
Explored.Required формирует игра при создании мира, Researching.Required - фиксированный перечень требуемых технологий. Это не произвольные декларации: не записывайте туда вручную имена классов вместо устойчивых идентификаторов экземпляров. Для собственного произвольного множества задач используйте обычные предметные условия/Goal; отдельного универсального автора списка Required нет.
["ChartedBodies", "Track", "Explore"],
["ChartedBodies", "Track.Key", "Completed.Target"],
["ChartedBodies", "Track.Required", "Owner.Explored.Required"],
["CensusTask.Done", "Requires.ChartedBodies.Covers", true]Последняя строка этого фрагмента, CensusTask.Done Requires.ChartedBodies.Covers true, добавляет к заданию ещё одно обязательное условие - разведать все исходно требуемые тела. Если проверяете только три аванпоста, не добавляйте её. Объявления ChartedBodies можно использовать в другом задании независимо от CensusTask.
Track.Required указывает фиксированный список обязательных идентификаторов, например Explored.Required или Researching.Required. Тогда имя.Covers = true проверяет полноту. Само имя по-прежнему читает число совпадений, а Count не заменяет список. Произвольные Sum, Streak, Max и Track.Operation не поддерживаются. Счётчики и списки заполняет игра: повторное чтение или загрузка действие заново не засчитывают. Неполная история не доказывает, что нарушений было ноль.
- Читаемые поля подтверждения: Completed.Turn, BirthTurn, Duration, Age, Mission.Risk, Amount, Workers, Rate и Distance - числа, когда соответствующий результат действительно их публикует.
- Completed.From, In, Previous, Target, Corporation, Scenario, Mode и Resource - ссылки/наборы ссылок контекста завершения. Поля не обязаны присутствовать у любого вида результата; отсутствие не является нулём или успехом.
- Completed.R и Completed.R.Count — сохранённый запас ресурса R в момент результата. Completed.R.Delta сохраняет то же числовое изменение, которое показано в HUD, включая потери от голода, с округлением до сотых. При положительном обычном нетто может действовать отрицательный прогноз голода; снимок сохраняет показанную потерю. Нечисловой прогноз роста в ходах не является дельтой ресурса. Requires.Completed.Science.Min 20 сравнивает исторический запас Науки, а не сегодняшний.
- Completed.EpisodeClosed и HistoryComplete - признаки достоверности; EpisodeKey, Sequence, Batch и Run - служебные идентификаторы и порядок записей. Их читаемость не разрешает создавать выдуманные подтверждения в Logic.
Можно ограничить счётчик одним эпизодом события, если нужное завершение действительно публикует такие сведения. Например, SpaceFashionBoost - существующий платный вариант продвижения переселения - увеличивает груз конкретного предложения и сохраняет подтверждение. Следующий фрагмент объявляет наблюдение его результатов в одном эпизоде:
["MyEpisodeBoosts", "Track", "SpaceFashionBoost"],
["MyEpisodeBoosts", "Track.Scope", "Episode"]Сравним этот счётчик с наблюдением той же операции за всю партию.
["MyRunBoosts", "Track", "SpaceFashionBoost"],
["MyRunBoosts", "Track.Scope", "Run"]Пусть в первом предложении SpaceFashion игрок оплатил продвижение дважды, а во втором - один раз. В настоящем подтверждении продвижения второго предложения MyRunBoosts читает 3 завершения за партию, а MyEpisodeBoosts - 1 завершение его эпизода. Первые два клика принадлежат другой плашке и в Episode второго предложения не входят. Это сравнение доступно там, где игра передала настоящее подтверждение результата со ссылкой на эпизод; обычное активное задание такого контекста не получает.
Track.Scope принимает Run, по умолчанию партия, или Episode, отдельный эпизод плашки. Track.Key называет устойчивый ключ подтверждённого результата. Имя наблюдения читает число совпадений, имя.Unique - число разных ключей. Например Requires.MyBuiltOutposts.Min 3 требует три завершённых аванпоста. Для проверки результата эпизода используются свидетельства именно этой плашки, не сумма прошлых плашек.
Scope Episode ограничивает счётчик эпизодом, но не превращает обычное задание CensusTask в наблюдение за его плашкой. Такой счётчик можно прочитать при проверке настоящего завершения, для которого игра передала ссылку Completed.Evidence с идентификатором Completed.EpisodeKey.
У обычного активного задания при проверке Requires нет такого подтверждения; запрос вернёт отсутствие значения. Записывать Completed.Evidence в мод, чтобы подделать привязку, нельзя. Поэтому для нового задания используйте счётчик Run с порогом .Add или Goal. Episode подходит тем результатам, для которых игра действительно сохраняет принадлежность эпизоду.
Завершённый эпизодический счётчик живёт до следующего пакета подтверждений; устойчивым результатом остаётся само свидетельство.
В PreWarpAge определения официальных достижений находятся вне модифицируемой Vanilla, включённые моды отключают их получение. Не копируйте Achievement.Eligible, Completed.HistoryComplete, внутренние номера подтверждений и Track-счётчики в Logic. Для условий Completed доступны поля действительного результата, например Completed.From, Completed.Target, Completed.In, Completed.Age и запасы Completed.R. Отсутствие доказательства не означает успешное выполнение условия.
Для собственного задания обычно достаточно Goal, Requires и исходов событий. Моды могут использовать историю, статистику и результаты настоящих действий, но не добавляют официальные награды профиля. Это отдельная система вне конструктора модовых заданий.
GameOver и Victory - завершение партии
Событие с Is GameOver завершает партию. Для победы у него дополнительно указывают Is Victory. Например, после строительства прототипа Then запускает группу, выбирающую победный итог. Одного значка медали для завершения игры недостаточно.
WarpDrivePrototype - готовый прототип варп-двигателя основной игры с ролью Building, технологией, ценой и местом. MyPrototype ниже наследует его, поэтому уже имеет действующий путь строительства. Then заменяет его продолжение своим MyWinDeck, а MyWin - единственный объявленный итог этой группы.
Сначала объявим сам победный итог. Это часть полного примера ниже, пока без способа его вызвать.
["MyWin", "Is", "Event"],
["MyWin", "Is", "GameOver"],
["MyWin", "Is", "Victory"]При реальном запуске MyWin остановит партию и отметит победу. GameOver отвечает за завершение, Victory - за победный вид результата. Объявление этих ролей не запускает итог сразу после загрузки мода.
Теперь привяжем итог к настоящему завершению прототипа.
["MyWinDeck", "Is", "Events"],
["MyWinDeck", "Deck.MyWin", 1],
["MyPrototype", "Then", "MyWinDeck"]MyWinDeck содержит единственный итог MyWin. После завершения строительства MyPrototype передаст очередь этой группе через Then. Она запустит победу. Сам прототип ниже наследует готовую постройку WarpDrivePrototype, сохраняя цену и требования. Затем отдельно настроим оформление итогового окна.
["MyPrototype", "Is", "WarpDrivePrototype"],
["MyWin", "Is", "Event"],
["MyWin", "Is", "Victory"],
["MyWin", "Is", "GameOver"],
["MyWin", "Name", "MyWinName"],
["MyWin", "Icon", "godtech"],
["MyWinDeck", "Is", "Events"],
["MyWinDeck", "Deck.MyWin", 1],
["MyPrototype", "Then", "MyWinDeck"]После настоящего завершения MyPrototype запускается MyWin и появляется итог победы. Требования и цена наследуемого прототипа сохраняются: одна запись Then не делает его бесплатно построенным. MyWinName переведите в Text/ruRU.json. Далее можно отдельно поменять оформление уже понятного результата.
Оформление итогового окна можно изменить отдельным определением, наследующим FinalMenu, и включить его в Has результата. Оно задаёт свои тексты; действия и статистика берутся из общего меню. Придуманные имена кнопок без игровых действий новых команд не создадут. Следующий фрагмент дополняет MyWin из предыдущего примера: MyResultScreen задаёт заголовок и описание окна, MyExplorersMedal - категорию медали с названием и значком. Добавьте переводы MyResultTitle, MyResultDescription и MyExplorersMedalName в Text/ruRU.json.
["MyWin", "Has", "MyResultScreen"],
["MyResultScreen", "Is", "FinalMenu"],
["MyResultScreen", "Name", "MyResultTitle"],
["MyResultScreen", "Description", "MyResultDescription"],
["MyWin", "Is", "MyExplorersMedal"],
["MyExplorersMedal", "Name", "MyExplorersMedalName"],
["MyExplorersMedal", "Icon", "award_gold"]GameOver = MyWin на определении награды связывает уведомляемую награду с этим существующим итогом; само поле не создаёт новую систему выбора медалей. Для обычного модового завершения достаточно Event + Is GameOver + при победе Is Victory. Если хотите золотой/серебряный результат по времени, создайте два таких Event с непересекающимися Requires.Turn и включите оба в колоду Then: выбор идёт через обычную применимость карт, а не через отдельный язык медалей. Официальные достижения профиля этим не добавляются.
GameOver на награде связывает её с итогом, GameOver.Evacuation задаёт вариант эвакуационного режима. На Simulation GameOver - сохранённая причина остановки, true допускает остановку без причины, false отсутствие остановки. GameOver.Continued и GameOver.Plaque - состояние окна результата, их не используют как авторские выключатели правил. Только поддерживаемая победа полной версии без эвакуационного срока разрешает продолжение времени.
FinalMenu из Has результата может задавать отдельные Name и Description итогового окна. Не больше одного подходящего профиля. Состав действий и статистики также объявляет существующее меню через Has. Сообщение Completed из Has итога сообщает результат один раз. Закрытие окна не повторяет звук, награду или историю. Поражение после продолженной победы может заменить причину и снова открыть итог.
Слова и связи
Здесь собраны слова, которыми описывают объекты и связи между ними. Например, Owner указывает владельца, а PlacedAt - место постройки. Примеры опираются на определения основной игры; проверяйте их в новой партии. Числа выбраны для объяснения правил.
Полные файлы в примерах подписаны своим путём, например Logic/Orbit.json. Их можно копировать целиком. Короткий пример может показывать только одну меняемую запись; перед ним указано, какое определение он дополняет. Как добавить такую запись в уже существующий файл, показано на двух полных файлах в разделе «Субъект, предикат и значение».
Большие самостоятельные примеры сценариев выполняйте по одному, в отдельных модах: они могут менять общие правила Player. Перед следующим примером отключайте предыдущий мод. Если вы осознанно объединяете изменения и Text/ruRU.json уже существует, добавляйте новые ключи внутрь его объекта; не заменяйте прежний словарь целиком.
Predicate - собственное слово
Допустим, вы хотите записывать качество руды числом. Назовём новое свойство OreGrade. Сначала сообщим игре, что это имя разрешено использовать как предикат:
["OreGrade", "Is", "Predicate"]Здесь OreGrade - придуманное вами имя. Is Predicate объявляет собственное слово языка. Оно пока не задаёт качество ни одному миру.
Теперь дадим крошечным каменным мирам качество руды 2. Полный файл Logic/OreGrade.json содержит объявление слова и запись его значения:
[
["OreGrade", "Is", "Predicate"],
["TinyRock", "OreGrade", 2]
]TinyRock - готовое определение крошечного каменного мира. Вторая строка означает: «качество руды у TinyRock равно 2». Если заменить 2 на 5, изменится сохранённая оценка. Добыча от этого сама не вырастет: связь оценки с доходом должна быть отдельным игровым правилом.
Выбирайте свободное простое имя, без точки и номера экземпляра. Для второго собственного слова нужно своё Is Predicate: это разрешение не наследуется. Даже если слово обозначает ресурс, одного Is Resource недостаточно. Имя также не должно совпадать со встроенным предикатом или обозначать одновременно несовместимые виды значений.
Type - обозначение типа объекта
У объекта может быть собственное имя «Моя станция», а под ним в подсказке - обозначение типа «Разведывательная станция». Вторую строку выбирает Type. Например, у маркера MyTypeMarker зададим:
["MyTypeMarker", "Type", "SurveyStation"]Игра возьмёт для строки типа перевод ключа SurveyStation. Это не новое собственное имя маркера: Name продолжает задавать «Мою станцию». Замена значения Type меняет обозначение типа, а не изображение Icon и не свойства выбранной категории.
Следующий полный пример создаёт на Земле маркер с двумя категориями: разведывательная станция и исследовательская станция. Type выбирает, какую из них назвать в подсказке его типом. Все имена с My, а также SurveyStation и ResearchStation придуманы для примера. Сохраните первый блок как Logic/Type.json, второй - как Text/ruRU.json и начните новую партию «Солнечной системы».
[
["SurveyStation", "Is", "Building"],
["ResearchStation", "Is", "Building"],
["MyTypeMarker", "Is", "SurveyStation"],
["MyTypeMarker", "Is", "ResearchStation"],
["MyTypeMarker", "Type", "SurveyStation"],
["MyTypeMarker", "Name", "MyTypeMarkerName"],
["MyTypeMarker", "Icon", "outpost"],
["MyTypeMarker", "PlacedAt", "Earth"],
["MyTypeMarker", "Owner", "Player"]
]{
"SurveyStation": "Разведывательная станция",
"ResearchStation": "Исследовательская станция",
"MyTypeMarkerName": "Моя станция"
}На Земле появится объект с рисунком аванпоста. Его собственное название - «Моя станция», а строка типа в подсказке - «Разведывательная станция». Замените только значение Type на ResearchStation и начните новую партию: строка типа станет «Исследовательская станция». Название и рисунок останутся прежними. Для этой строки игра ищет перевод самого значения Type - здесь ключи SurveyStation и ResearchStation, - а не Name выбранной категории.
У тела на карте тип иногда можно не указывать. Рассмотрим простой вариант каменного мира:
["MyRock", "Is", "TinyRock"]Если создать MyRock на карте, игра сможет взять для его типа TinyRock: это его ближайший подходящий класс. Отдельная строка Type TinyRock здесь не требуется. Этот автоматический выбор действует для тел, размещённых в ячейке карты. В состоянии партии связь с ячейкой называется Cell. У постройки без такой связи, как MyTypeMarker выше, подсказка читает явный Type.
Теперь добавим тому же телу вторую независимую категорию. SurveyedRock - придуманная категория мира:
["SurveyedRock", "Is", "World"],
["MyRock", "Is", "TinyRock"],
["MyRock", "Is", "SurveyedRock"]У MyRock теперь две независимые ветви Is. Одна не уточняет другую, поэтому игра не сможет однозначно вывести тип. Выберем TinyRock явно:
["MyRock", "Type", "TinyRock"]В строке типа будет перевод TinyRock. Обе категории Is при этом сохраняются: Type не удаляет SurveyedRock.
Есть другой способ: использовать SurveyedRock только как категорию с отдельной подписью. Для этого варианта уберите собственную строку Type у MyRock и добавьте подпись категории:
["SurveyedRock", "Tag", "SurveyedRockTag"]Добавьте в словарь ключ SurveyedRockTag с текстом «Разведанный». Категория с Tag исключается из автоматического выбора типа. Поэтому у размещённого MyRock тип теперь снова выводится как TinyRock, хотя обе связи Is остаются. «Разведанный» - отдельная подпись категории, а не замена типа. Другие применения Tag разобраны в одноимённой статье.
В примере «Фиксированная система и граница Plane» звезда MyFixedSun наследует только общую категорию Star. Запись Type MyFixedSun явно выбирает её собственное определение вместо Star. Поэтому словарь того примера содержит и ключ MyFixedSun для строки типа, и отдельный MyFixedSunName для имени звезды. Это выбор обозначения, а не команда повторно создать звезду или скопировать её свойства.
Able - доступное действие
Разрешим действие георазведки на крошечном каменном мире. Для этого в определение TinyRock добавляют одну запись:
["TinyRock", "Able", "GeoSurvey"]Этот фрагмент читается так: «на крошечном каменном мире разрешена георазведка». TinyRock и GeoSurvey уже определены в игре. Каменные миры наследуют это разрешение от Rocky, поэтому добавление строки повторит существующее правило. Она приведена, чтобы показать запись Able; второй кнопки не появится.
Able разрешает предлагать действие, но не отменяет его требования. Например, георазведка требует технологию MantleDrilling. Это требование записано у самого GeoSurvey:
["GeoSurvey", "Requires", "MantleDrilling"]Если у игрока нет этой технологии, одно Able не позволит выполнить георазведку. Нужны также разведанное подходящее тело и ресурсы на оплату. Цена и результат принадлежат определению действия; создание собственного действия разобрано в статье Action.
Объекты наследуют Able через Is. Разрешение также может давать действующая черта. Has и Able решают разные задачи: Has включает объект в состав другого объекта, Able разрешает действие.
Imports - библиотека другой симуляции
Imports позволяет использовать определения из другой установленной симуляции: например, её классы миров. Это дополнительная зависимость мода. Игра прочитает данные, но не установит отсутствующую симуляцию, плагин или исполняемый код. Для обычного мода PreWarpAge импорт не нужен: определения основной игры уже доступны.
Укажите имя симуляции или путь «Симуляция/Файл» без расширения .json. Следующий фрагмент подходит только для установленной версии, где есть StarGenerator и его файл Worlds. В составе файлов PreWarpAge их наличие не гарантируется.
["Simulation", "Imports", "StarGenerator/Worlds"]Игра загрузит определения из Logic/Worlds.json указанной симуляции, а затем её собственные импорты. Если файл отсутствует, новая партия не создастся и загрузчик сообщит об ошибке. Настройки основной сцены импортируемой игры не должны заменять сцену PreWarpAge.
Перед использованием библиотеки проверьте, доступны ли нужные изображения, переводы и игровые правила в установленной версии. Загрузка её определений не превращает PreWarpAge в другой игровой режим.
Owner - владелец
Owner отвечает на вопрос «чей это объект». Предположим, маркер MyMarker уже существует на Земле. Назначим его игроку:
["MyMarker", "Owner", "Player"]В PreWarpAge один игрок, поэтому Player однозначно указывает, кому достанется маркер. Эта строка сообщает владельца. Чтобы маркер ещё и появился на карте, нужно отдельно указать место.
Следующий фрагмент создаёт на Земле объект с рисунком аванпоста и назначает его единственному игроку. Проверяйте его в новой партии сценария «Солнечная система», где определена Earth. MyMarker - придуманное имя объекта; Building, Player и outpost уже есть в игре.
["MyMarker", "Is", "Building"],
["MyMarker", "Icon", "outpost"],
["MyMarker", "PlacedAt", "Earth"],
["MyMarker", "Owner", "Player"]PlacedAt создаёт объект на существующей Земле, Icon даёт ему рисунок, а Owner связывает его с созданным игроком. Без PlacedAt эти строки не породят маркер на карте. Обычное строительство назначает владельца своим действием Build.
В Owner можно назвать конкретный существующий объект или его определение. В нашем примере названо определение Player: игра найдёт созданного по нему игрока. При нескольких игроках такая ссылка уже не означает «текущий» или «ближайший». Случайный номер Player_0 из чужого сохранения эту неоднозначность не решает.
По назначенному владельцу можно проверить его запас. Например, черта WellFundedWorld даёт миру бонус при достаточной науке его владельца. Её условие записывается так:
["WellFundedWorld", "Requires.Owner.Has.Science.Min", 100]Owner здесь ведёт от мира к игроку, Has.Science - к принадлежащей игроку науке, Min 100 - к нижней границе. Без Owner проверялся бы запас самого мира. Полное определение WellFundedWorld и включение бонуса разобраны в статье «Источник условий и корректировка параметра».
Чтобы у каждого игрока возникла своя технология, нужен Player Has <технология>. Один общий объект с Owner Player не заменяет это создание отдельных экземпляров.
Parent - породившая сущность
У события астероида есть кнопка обстрела Bombard. Когда игрок нажимает её, урон должен получить сам астероид. Из кнопки к событию, на котором она находится, ведёт связь Parent - «родитель».
Bombard - существующий вариант обстрела астероида. Игрок нажимает кнопку в карточке события с астероидом. Для этого варианта Parent указывает на саму карточку, поэтому следующий фрагмент назначает её получателем урона.
["Bombard", "Damage.Target", "Parent"]Эта строка уже входит в определение обстрела и показывает чтение существующего механизма, а не самостоятельную атаку. Чтобы изменить силу готового обстрела, меняют его Damage; одного Parent для создания оружия недостаточно.
Иногда нужен не родитель, а его цель. У исхода эксперимента NanobotsEscaped такая ссылка записывается как Parent.Target:
["NanobotsEscaped", "Transforms.Target", "Parent.Target"]Parent ведёт от исхода к событию эксперимента, а Target от этого события - к выбранному миру. Поэтому превращается мир эксперимента, а не его сообщение. Полный разбор этого случая - в статье Transforms.
Если существующая цепочка содержит ещё одного родителя, Parent.Parent проходит два звена подряд. Связи создаёт игра при появлении событий и результатов. Ни имя части определения, ни номер объекта из чужой партии такую связь не заменяют. Parent также не означает наследование Is или владение Owner.
PlacedAt - место объекта
PlacedAt отвечает на вопрос «где находится объект». У маркера MyMarker можно указать Землю местом размещения:
["MyMarker", "PlacedAt", "Earth"]В новой партии «Солнечной системы» игра создаст описанный маркер на Earth. Это стартовое размещение: игрок не нажимает «Построить» и не платит цену. Для обычной стройки, требующей действий игрока, используется Build.
Теперь зададим маркер целиком. Следующие строки добавляются в Logic-файл мода: Is Building сообщает его роль, Icon выбирает готовый рисунок, Owner назначает владельца.
["MyMarker", "Is", "Building"],
["MyMarker", "Icon", "outpost"],
["MyMarker", "PlacedAt", "Earth"],
["MyMarker", "Owner", "Player"]Этот фрагмент использует Землю Earth из сценария «Солнечная система». MyMarker - имя нового объекта, Building - его роль, outpost - имя готового изображения. PlacedAt размещает маркер на Земле, Owner назначает его игроку. В сценарии, где нет Earth, эти строки не создадут ни Землю, ни маркер на ней.
PlacedAt может охватывать несколько мест. Рассмотрим отдельный вариант: на карте уже размещены два авторских мира MyHostA и MyHostB, оба относятся к нашей категории MyMarkerHost, а самого MyMarkerHost на карте нет. Размещение миров сделайте через Orbit, как в одноимённой статье. Тогда правило маркера можно записать так:
["MyMarkerHost", "Is", "World"],
["MyHostA", "Is", "MyMarkerHost"],
["MyHostB", "Is", "MyMarkerHost"],
["MyMarker", "PlacedAt", "MyMarkerHost"]Игра не найдёт тела самого определения MyMarkerHost и перейдёт к его потомкам. На двух размещённых мирах появятся два маркера - по одному на каждом. Один PlacedAt не означает «выбрать случайный мир». Собственные Owner, Name и Icon маркера остаются такими же, как в полном примере выше.
Теперь изменим только состав карты: дополнительно разместим само определение MyMarkerHost. Например, в отдельном варианте Солнечной системы добавим ему явные центр и кольцо:
["MyMarkerHost", "Orbit.Center", "Sun"],
["MyMarkerHost", "Orbit", 3]При наличии размещённого экземпляра именно MyMarkerHost поиск берёт его. MyHostA и MyHostB больше не добавляются как запасной вариант: маркер появится на прямом месте, а не на всех трёх. Это приоритет точного определения перед потомками. Для различимых миров добавьте им обычные Name и Icon; эти строки показывают только изменение размещения.
Место должно уже находиться на карте. Если в отдельном варианте указать будущий мир, но ещё не создать его, маркера пока не будет:
["MyMarker", "PlacedAt", "MyLateHost"]Когда MyLateHost будет создан и получит ячейку Cell, отложенное размещение сможет создать маркер. Одного определения MyLateHost Is World без появления тела недостаточно. Это ожидание места при создании карты, а не постоянная фабрика маркеров на всех будущих мирах: повторное выполнение размещения может пересоздать объекты. Не используйте его для накопления экземпляров при каждом повторе.
Укажите Owner отдельно, если объект должен принадлежать игроку. Кроме того, PlacedAt не переносится через обычное наследование Is: у нового определения размещение нужно задать явно. При строительстве через Build место и владельца назначает само действие.
Карта и генерация тел
Center - центр сцены
Карта звёздной системы состоит из колец вокруг центрального тела. Center указывает это тело, обычно звезду. Сама карта и звезда описываются отдельно: карта хранит расположение ячеек, звезда - свои свойства и число колец. Полный пример подключения такой системы к новой партии приведён в статье «Фиксированная система и граница Plane».
Сначала укажем центр прямо. MyMap - имя нашей карты, Sun - существующее определение Солнца. Запись Center связывает карту с центральным телом:
["MyMap", "Center", "Sun"]Это ещё не число колец. Кольца относятся к самой звезде. Добавим восемь колец отдельной строкой; вместе обе записи выглядят так:
["MyMap", "Center", "Sun"],
["Sun", "Orbits", 8]MyMap - придуманное имя карты. Она получает Sun в качестве центра, а у Sun задаются восемь колец. Эти строки не добавляют сценарий в меню. Для этого нужны MyFixedSystem и остальные определения из полного примера.
В PreWarpAge центральную звезду выбирают через сценарий. Например, новая SurveySystem использует ClassG:
["SurveySystem", "Orbit.Center", "ClassG"]Этот выбор сценария имеет приоритет перед колодой Center.Deck. Полное включение SurveySystem в меню показано в рецепте «Сценарий». Одна строка Center у отдельной карты карточку сценария не создаёт.
У генератора есть и необязательные звёзды-компаньоны. Например, следующий диапазон разрешает от нуля до двух компаньонов:
["MyMap", "Center.Companions.Min", 0],
["MyMap", "Center.Companions.Max", 2]Без Center.Companions.Max компаньоны не создаются. С этими границами возможны ноль, один или два. Чтобы предпочесть одного, сохраним границы и добавим Peak:
["MyMap", "Center.Companions.Min", 0],
["MyMap", "Center.Companions.Max", 2],
["MyMap", "Center.Companions.Peak", 1]Значение один становится предпочтительным, но предел остаётся равным двум: Peak не гарантирует ровно одного компаньона.
Размер тесной системы компаньона - отдельная настройка. Здесь такой системе отводится от одного до двух колец:
["MyMap", "Center.Companions.Reach.Min", 1],
["MyMap", "Center.Companions.Reach.Max", 2]Без этих двух настроек предел равен трём кольцам. Оба примера описывают генерацию; они не добавляют в PreWarpAge кнопку перехода между системами.
Orbits - кольца, зоны и спутники
Сначала зададим число колец у звезды. У ClassK восемь колец:
["ClassK", "Orbits", 8]Это восемь колец звёздной системы, на которых размещаются планеты. Количество лун каждой планеты эта строка не задаёт.
Теперь зададим число спутников планеты. У GasGiantMedium те же Orbits относятся уже к лунам, а диапазон позволяет разным гигантам получить разное число:
["GasGiantMedium", "Orbits.Random.Min", 0],
["GasGiantMedium", "Orbits.Random.Max", 2]У нового среднего газового гиганта будет ноль, одна или две луны. Дополнительная Orbits.Random.Peak позволяет предпочесть определённое число внутри этих границ. Сам выбор случайных чисел разобран в статье Random.
Состав лун задаётся отдельно от их числа. В Orbits.Deck после последней точки пишут класс спутника. Например, такая карта разрешает каменистый спутник TinyRock:
["GasGiantMedium", "Orbits.Deck.TinyRock", 1]Число 1 - количество карты TinyRock в колоде. Оно не заменяет предел двух лун. Общие пределы для всех лун системы записываются у центральной звезды через Orbits.Moons.Min и Orbits.Moons.Max.
Вернёмся к кольцам звезды. Их делят между климатическими зонами. Например, вес обитаемой зоны ClassK записывается так:
["ClassK", "Orbits.Habitable.Weight", 2]Вес сравнивается с весами других зон. При восьми кольцах и четырёх одинаковых весах по 2 каждая зона получает по два места. Для каждой зоны считается Orbits × её вес / сумму положительных весов; результат округляется до целого, ровно половина - вверх. Сумма отдельно округлённых чисел иногда отличается от Orbits.
У потомка вес работает как добавка. Пусть у ClassK вес обитаемой зоны равен 2, как в записи выше. Добавим свой вариант звезды:
["MyStar", "Is", "ClassK"],
["MyStar", "Orbits.Habitable.Weight", 1]Для MyStar обитаемая зона получает вес 2 + 1 = 3. Это её вес перед распределением колец, а не обещание трёх планет. Заменим только добавку на ноль:
["MyStar", "Is", "ClassK"],
["MyStar", "Orbits.Habitable.Weight", 0]Вес остаётся равным 2 + 0 = 2: ноль не удаляет унаследованную зону. Если унаследованного вклада нет, нулевой вес исключает зону. После изменения весов проверьте, что для родного мира осталось место.
Когда число мест определено, выберем, какие миры появятся в обитаемой зоне. Следующие две карты дают ей землеподобный и океанический мир:
["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 1],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1]При двух местах колода раздаст оба вида в случайном порядке. При одном месте появится только один из них. У колоды другое правило наследования: она заменяется целиком. Например, оставим у ClassK две карты выше, а у MyStar зададим одну свою:
["MyStar", "Is", "ClassK"],
["MyStar", "Orbits.Habitable.Deck.StandardEarthlike", 1]В обитаемой колоде MyStar теперь только StandardEarthlike. StandardOcean родителя к ней не добавляется. В отличие от веса зоны, собственная колода не прибавка к прежней. При удалении своей строки колоды снова доступен весь состав ClassK.
Для физической модели зону можно описать температурной границей. Например, нижняя граница обитаемой зоны:
["ClassK", "Orbits.Habitable.Temperature.Min", 240]Число измеряется в кельвинах. Если вы применяете температурные границы, задайте их для всех зон с положительным весом. Внутренний предел всей системы - отдельная настройка:
["ClassK", "Orbits.UltraHot.Temperature.Max", 4000]Эта строка задаёт внутреннюю границу всей системы при 4000 K вместо исходных 5000 K. Для этой задачи используется именно UltraHot.Temperature.Max. Max у другой зоны не заменяет этот общий внутренний предел.
Без температурных границ зоны располагаются изнутри наружу в порядке объявления. В PreWarpAge используются UltraHot, Hot, Habitable, Snow и Outer. Своя зона может задавать размещение тел, но не получает автоматически экономические эффекты существующих климатических зон. Orbits.Seeded и результаты раздачи хранят уже выполненную генерацию; их не нужно записывать в мод.
Orbit - положение на кольце
Добавим к Земле спутник MyMoon на основе готового TinyRock. Сначала укажем, вокруг чего он должен появиться:
["MyMoon", "Orbit.Center", "Earth"]Earth - существующая Земля сценария «Солнечная система». В другом сценарии без Earth эта строка не создаст Землю. Orbit.Center нужно записывать у нового определения явно: обычное наследование Is его не переносит.
Теперь выберем кольцо. Следующая строка помещает спутник на первое кольцо вокруг Земли:
["MyMoon", "Orbit", 1]Orbit принимает целый номер; ноль обозначает сам центр. На первом кольце шесть ячеек. Если точную ячейку не указать, игра выберет свободную.
Выберем верхнюю ячейку с номером 0. За ячейку отвечает Orbit.Index:
["MyMoon", "Orbit.Index", 0]Отсчёт начинается сверху и идёт по часовой стрелке. На кольце с номером 2 будет 12 ячеек, на кольце 3 - 18: их число равно номеру кольца, умноженному на 6. Слишком большой индекс отсчитывается заново по кругу. Соберём роль спутника и три разобранные настройки:
["MyMoon", "Is", "TinyRock"],
["MyMoon", "Orbit.Center", "Earth"],
["MyMoon", "Orbit", 1],
["MyMoon", "Orbit.Index", 0]У Земли появится MyMoon на первом кольце, в верхней ячейке. Если в выбранном сценарии нет Earth, этот фрагмент не создаст её.
Движение по ходам настраивается отдельно от начальной ячейки. Например, дадим телам шаг в одну ячейку:
["Simulation", "Orbit.Step", 1]За ход тела смещаются на одну ячейку. Ноль или отсутствие Orbit.Step отключает такое движение. Начальный Orbit.Index от этого не становится номером скорости.
Чтобы отключить декоративный дрейф при размещении, используется другая настройка у карты:
["MyMap", "Orbit.Static", true]MyMap здесь - карта из статьи Center. Orbit.Static отключает её декоративный дрейф, но не отменяет заданный у Simulation шаг по ходам. Orbit.Zone хранит зону уже созданного тела. Формы Orbit.Distance.Max и Orbit.Star.Type.Not не являются поддержанными фильтрами текущей PreWarpAge: не используйте их для запрета мест. Для фиксированного размещения служат разобранные Orbit.Center, Orbit и Orbit.Index. Физическое поле Distance.Max из статьи Distance - другая величина, не ограничение генератора.
OrbitFill - заполнение пояса
Пояс занимает несколько ячеек одного кольца. OrbitFill задаёт, какую долю кольца заполнить, поэтому каждый камень не нужно размещать отдельно. В следующем фрагменте MyBelt - имя нового пояса, RockyAsteroid - готовый класс каменных астероидов. Проверять его следует в новой партии «Солнечной системы», где уже определено Sun.
Центр и кольцо задаются уже знакомыми Orbit.Center и Orbit. Новая запись - OrbitFill со значением 0.6: заполнить 60% ячеек кольца. Соберём эти настройки с определением камней пояса:
["MyBelt", "Is", "RockyAsteroid"],
["MyBelt", "Orbit.Center", "Sun"],
["MyBelt", "Orbit", 4],
["MyBelt", "OrbitFill", 0.6]В новой партии «Солнечной системы» пояс займёт доступные ячейки четвёртого кольца вокруг Солнца - примерно 60%, если места достаточно. При нехватке свободных ячеек он займёт только доступные. OrbitFill обычно задаётся от 0 до 1; значение 1 заполнило бы всё доступное кольцо.
Чтобы все камни представляли один пояс с общими ресурсами и действиями, добавьте к MyBelt ещё одну настройку:
["MyBelt", "OrbitFill.Lead", true]Теперь у пояса один основной объект, остальные камни - его изображённые фрагменты. Выбор любого фрагмента открывает общие ресурсы. Отдельных запасов у нарисованных камней нет; связи между ними игра создаёт сама.
Trojans и TrojansOf - троянские рои
Троянцы - две группы малых тел на орбите планеты: одна примерно на 60° впереди неё, другая позади. Сначала дадим гигантам возможность получить такие группы:
["Giant", "Trojans.Chance", 20]У каждого нового гиганта с вероятностью 20% появится признак Trojans. Это пока решение «есть ли троянцы», а не описание камней роя.
Теперь опишем сами камни. GiantTrojan - новый вид на основе каменных астероидов RockyAsteroid. TrojansOf Giant связывает этот вид с гигантами. Вместе вероятность и определение роя выглядят так:
["Giant", "Trojans.Chance", 20],
["GiantTrojan", "Is", "RockyAsteroid"],
["GiantTrojan", "TrojansOf", "Giant"]Часть созданных гигантов получит рои GiantTrojan впереди и позади себя на том же кольце. Отсутствующие гиганты от этого не появятся. Для авторской системы вместо общей категории Giant в TrojansOf можно назвать конкретную планету. Указывайте TrojansOf у нового вида роя, а не у общего RockyAsteroid: иначе правило затронет все такие астероиды. TrojansOf.Seeded отмечает уже выполненное размещение; в моде этот служебный факт не нужен.
Plane - прямоугольная карта
Plane описывает прямоугольное поле из шестиугольных ячеек. Это возможность общего движка, для которой в PreWarpAge пока нет законченного рецепта партии со звёздами и родным миром игрока. Поэтому эта статья объясняет только формат. Для собственного играемого сценария используйте кольцевую систему из статьи «Фиксированная система и граница Plane». Замена Orbit.Center полями Plane.Cols и Rows такого сценария не создаёт.
Размер поля - первая часть описания. Следующие две строки задают девять столбцов и пять строк:
["MySector", "Plane.Cols", 9],
["MySector", "Plane.Rows", 5]Получится поле из шестиугольных ячеек размером 9 × 5. Оба числа должны быть целыми положительными. Если убрать Plane.Rows, высота станет равна ширине - в этом случае поле будет 9 × 9.
Следующая часть - колода звёзд, которыми заполняют свободные ячейки. Добавим карту готовой звезды ClassG с весом 4 к уже заданному размеру:
["MySector", "Plane.Cols", 9],
["MySector", "Plane.Rows", 5],
["MySector", "Plane.Deck.ClassG", 4]Число 4 - вес карты ClassG в колоде, а не ширина поля и не гарантированное число звёзд. Сначала размещаются объявленные домашние системы, затем колода заполняет оставшиеся ячейки. Это описание геометрии и раздачи; оно не подключает новую партию PreWarpAge и не создаёт переходы между картами. Plane.Homed, Scattered и ColonyMinted отмечают уже созданные объекты; переносить эти служебные поля в мод не нужно.
Spawn - родной мир игрока
Spawn выбирает родной мир игрока. Можно заранее назвать определённое тело или поручить игре выбрать его среди подходящих миров. Важно, чтобы эти миры действительно появились на карте. Earthlike - категория землеподобных миров, Homeworld - ссылка на дом, уже выбранный для конкретного игрока. StandardOcean к Earthlike не относится и не может заменить землеподобный старт.
Если нужен заранее выбранный родной мир, укажите его через Spawn. В сценарии «Солнечная система» игрок может начать на существующей Земле:
["Player", "Spawn", "Earth"]Это выбор конкретного определения. Он подходит только карте, на которой Earth действительно создаётся. Одна строка Spawn не создаёт отсутствующую планету.
Для случайной карты вместо имени планеты укажите подходящую категорию в Spawn.Random:
["Player", "Spawn.Random", "Earthlike"]Игрок получает случайный мир категории Earthlike из уже созданных на карте. Ссылка Homeworld затем указывает на выбранный дом. StandardOcean не относится к Earthlike, поэтому один океанический мир для такого старта не подходит.
Случайный выбор можно отключить значением false. Например, в отдельном определении Player с явным Spawn Earth унаследованный случайный выбор отменяют так:
["Player", "Spawn.Random", false]Spawn.Random принимает имя категории или false, но не true и не число. Если одновременно заданы Spawn и Spawn.Random, явный Spawn имеет приоритет. Эти исходные настройки применяются к новой партии; смена файла не переносит дом уже играющего пользователя.
Для гарантированного старта в случайной системе нужно создать хотя бы один Earthlike. Большой вес его карты не гарантирует дом при единственном месте, если в колоде остаётся StandardOcean. Полный пример - «Своя звезда с гарантированным родным миром». Spawn.Lost и OriginKey хранят историю партии, их не копируют из сохранения.
Grid и AutoSelect - представление карты
Grid выбирает вид уже созданной карты. Сохраним обычное изображение небесных тел PreWarpAge:
["Simulation", "Grid", "Decorative"]Если заменить Decorative на Hex, карта будет показана сеткой шестиугольных ячеек. Меняется вид, а не число колец: оно по-прежнему задаётся через Orbits. Прямоугольная геометрия относится к Plane.
Выбор мышью - отдельная настройка. Предположим, на Земле уже стоит MyMarker из статьи PlacedAt. Чтобы клик по планете не выбирал этот маркер автоматически, укажите:
["MyMarker", "AutoSelect", false]У самого маркера останутся прежние место и владелец. Меняется только автоматический выбор при клике. Без AutoSelect действует обычное поведение.
У карты то же false имеет другой результат. В отдельном варианте задайте его у Simulation:
["Simulation", "AutoSelect", false]Клик выбирает саму ячейку, а не нарисованное тело. В предыдущем примере карта по-прежнему выбирала тело и только маркер не перехватывал его клик. Различие задаёт получатель записи: Simulation или MyMarker.
Например, на планете стоит MyMarker из статьи о PlacedAt. Следующий фрагмент сохраняет декоративный вид карты и запрещает маркеру перехватывать клик по планете. Сам маркер должен быть размещён отдельно. AutoSelect не меняет его владельца и не разрешает строительство.
["Simulation", "Grid", "Decorative"],
["MyMarker", "AutoSelect", false]Если в одном месте находится несколько объектов, можно предпочесть тот, которым управляет игрок:
["Simulation", "AutoSelect.Controllable", true]Этот приоритет применяется при автоматическом выборе. Он не передаёт игроку право управлять чужим объектом.
Cell и OrbitSlot - положение живого мира
Cell хранит ячейку, в которой находится созданное тело. Это служебная связь партии. В моде задайте желаемые центр, кольцо и позицию через Orbit; точный адрес Cell игра запишет сама. Так мод не зависит от номеров объектов, назначенных в чужой партии.
Cell - ссылка на ячейку конкретной сцены. Она появляется при размещении мира, а не определяет его класс. OrbitSlot.* хранит вычисленные сведения орбитального слота, из которого создаётся тело. Копировать такие адреса и результаты из случайной партии в мод не следует. Для авторского положения используйте Orbit/Orbit.Center/Orbit.Index, для генерации - Orbits или Plane.
["MyMoon", "Is", "TinyRock"],
["MyMoon", "Orbit.Center", "Earth"],
["MyMoon", "Orbit", 1]В сценарии Солнечной системы этот фрагмент объявляет новый каменистый спутник существующей Земли. Игра назначает ему Cell при размещении на первом кольце. Номера ячеек и экземпляров из чужого сохранения писать не требуется. В сценарии без Earth фрагмент не создаёт отсутствующую Землю.
Случайный выбор
Seed - зерно партии
Зерно - число, по которому игра получает случайные результаты. Оно позволяет повторить партию: нужны те же файлы игры и модов, то же зерно и та же последовательность действий. Это удобно при проверке мода: изменяя один параметр, вы можете сравнивать результаты на одинаковом старте. После изменения правил прежнее зерно не гарантирует прежнюю карту.
Seed задаётся у Simulation целым числом от 0 до 2147483647. Меню предлагает значения до 99999; в файле допускается весь диапазон. Если зерно не выбрано, игра назначает его случайно. Следующий фрагмент предлагает зерно 42.
["Simulation", "Seed", 42]При создании новой партии игрок может выбрать другое зерно и тем самым переопределить запись мода. Поля Seed.Rng.<ключ> позволяют разработчикам управлять отдельными случайными результатами при проверках. Для обычного изменения баланса они не нужны.
Random - случайное число
Пусть новые миры MyRock получают разные размеры - от 1 до 3. Для этого у нового определения зададим обе границы Size.Random:
["MyRock", "Is", "TinyRock"],
["MyRock", "Size.Random.Min", 1],
["MyRock", "Size.Random.Max", 3]Каждый созданный MyRock получит своё число в этих границах. Выбор сохраняется: открытие подсказки ещё раз его не меняет. Чтобы увидеть новый класс, его нужно отдельно разместить на карте или добавить в колоду миров.
Границы должны быть числами, причём Min не больше Max. Обе нужны, но одна или обе могут уже присутствовать у родителя. Замена Size на другое числовое поле создаёт случайный выбор этого поля, если его правила допускают Random.
Теперь зададим точные ступени: 1, 2 и 3. К этому примеру добавьте шаг 1:
["MyRock", "Size.Random.Step", 1]Без других настроек распределения три ступени равновероятны. Шаг должен быть положительным. Если Step не задан, целые границы приводят к округлению случайного числа; это другой способ выбора и он не обещает равенства вероятностей каждой ступени. Запись 1.0 вместо 1 этого не меняет.
Если чаще нужен размер около 2, задайте пик распределения:
["MyRock", "Size.Random.Peak", 2]Значение Peak 2 предпочитает область около двух. Peak true выбирает середину диапазона, а Peak false оставляет равномерный выбор. При сочетании пика и Step результат округляется к выбранным ступеням.
Для больших диапазонов есть отдельное степенное распределение. В этом самостоятельном варианте MyWeightedRock небольшие размеры встречаются чаще больших:
["MyWeightedRock", "Is", "TinyRock"],
["MyWeightedRock", "Size.Random.Min", 1],
["MyWeightedRock", "Size.Random.Max", 100],
["MyWeightedRock", "Size.Random.PowerLaw", 1]Для положительного диапазона положительный PowerLaw предпочитает малые числа, отрицательный - большие, ноль даёт равномерный выбор. Плотность пропорциональна числу в степени минус показатель; при показателе 1 равные отношения величин равновероятны. PowerLaw имеет приоритет перед Peak, поэтому для этого примера пик не добавляйте.
Наконец, можно перечислить допустимые значения вместо диапазона. Например, тело должно иметь только размер 1 или 3:
["MyListedRock", "Is", "TinyRock"],
["MyListedRock", "Size.Random", 1],
["MyListedRock", "Size.Random", 3]Оба перечисленных значения равновероятны. Такой список нельзя смешивать с собственными Min и Max того же поля.
Некоторые поля имеют собственную дискретность: например, срок в ходах остаётся целым. Дробный диапазон не отменяет это правило. Бесконечность и нечисловые значения в Min и Max недопустимы. Теперь соберём исходный MyRock со ступенями в одном блоке:
["MyRock", "Is", "TinyRock"],
["MyRock", "Size.Random.Min", 1],
["MyRock", "Size.Random.Max", 3],
["MyRock", "Size.Random.Step", 1]Каждый созданный MyRock получит размер 1, 2 или 3 с равными вероятностями. Чтобы увидеть его, включите MyRock в колоду миров или разместите через Orbit. Если у нового определения задать фиксированный Size без собственного диапазона, он заменит унаследованный случайный размер. Random.Prior, Drawn и Source хранят уже сделанный выбор; в файле мода их задавать не нужно.
Chance - вероятность признака и шанса исхода
Chance задаёт вероятность. Сначала рассмотрим признак мира: у среднего газового гиганта может быть троянский рой. Зададим вероятность 20 процентов:
В этом первом примере Trojans - признак «есть троянцы», а Chance - вероятность получить его. Число должно быть от 0 до 100.
В следующем фрагменте GasGiantMedium - существующий класс среднего газового гиганта. Меняется только вероятность его признака Trojans. Размещение самого роя описано в статье о Trojans и TrojansOf. Для изменения риска события используйте пример с EventChoice и Failure: там Chance.Target указывает на конкретный исход события.
["GasGiantMedium", "Trojans.Chance", 20]Каждый новый гигант независимо получает признак с вероятностью 20%. При неудаче сохраняется false. Ровно один успех из каждых пяти не гарантируется. Если признак уже задан, повторной проверки не будет.
У события вероятность может быть отдельным параметром. Например, в RobotUprising часть Capture выбирает один из трёх шансов захвата:
["RobotUprising.Capture", "Chance.Deck.20", 1],
["RobotUprising.Capture", "Chance.Deck.30", 1],
["RobotUprising.Capture", "Chance.Deck.40", 1]Для этой части будет выбрано 20%, 30% или 40%. После Chance.Deck записан сам возможный процент, а третье число 1 - количество соответствующей карты. Подпись параметра задаётся через Chance.Name, например CaptureChance у этой части восстания.
Игрок может улучшать другой параметр того же восстания - вероятность вернуть захваченный сектор. У готовой кнопки UprisingTroops это записано так:
["UprisingTroops", "Chance.Add", 15],
["UprisingTroops", "Chance.Target", "Parent.Retake"]Нажатие добавляет 15 процентных пунктов к Retake родительского события: например, 20% станут 35%. Chance.Target обязателен: он называет, какой шанс меняется. Результат ограничивается нулём и Chance.Max, по умолчанию 100%. Chance.Add должен быть ненулевым. Это действие с параметром события, а не повторный случайный выбор признака мира.
Changes - выбор одного типа
Changes выбирает для объекта один из заранее описанных вариантов. Так можно менять его изображение и свойства, сохраняя сам объект. Выбранный вариант становится Type. Для полной замены тела другим классом существует Transforms; при такой замене прежние постройки могут погибнуть.
Опишем новый крошечный мир MyBody и один вариант его облика SurveyVariant. Changes связывает вариант с классом мира, а Icon у варианта задаёт новое изображение:
["MyBody", "Is", "TinyRock"],
["SurveyVariant", "Changes", "MyBody"],
["SurveyVariant", "Changes.Chance", 100],
["SurveyVariant", "Icon", "earth"]У этого единственного варианта вес Changes.Chance равен 100. Поэтому при создании MyBody он будет выбран как Type и даст изображение earth. Чтобы увидеть мир на карте, отдельно разместите MyBody через Orbit или добавьте в колоду миров. Другие классы планет не меняются.
Теперь разрешим пропуск: в новой партии только часть миров должна получать этот вариант. Замените его вес на 25:
["SurveyVariant", "Changes.Chance", 25]Если других подходящих вариантов нет, при первом выборе SurveyVariant получит вероятность 25%, а 75% останутся без него. Вес без явной записи равен 100. Теперь вместо пропуска зададим выбор между двумя обликами того же MyBody:
["SurveyVariant", "Changes", "MyBody"],
["SurveyVariant", "Changes.Chance", 100],
["SurveyVariant", "Icon", "earth"],
["OtherVariant", "Changes", "MyBody"],
["OtherVariant", "Changes.Chance", 100],
["OtherVariant", "Icon", "ice"]Сумма весов равна 200: каждый из двух подходящих вариантов получает половину шансов, а не отдельные гарантированные 100%. Один новый MyBody получает один облик. Условия могут убрать вариант из выбора. Уже выбранный вариант сохраняется, пока его условия выполняются.
Чтобы выбирать эти облики без возвращения, вместо вероятностного выбора можно дать MyBody колоду Type.Deck:
["MyBody", "Type.Deck.SurveyVariant", 1],
["MyBody", "Type.Deck.OtherVariant", 1]Эта колода выбирается раньше обычных весов Changes.Chance. В ней по одной карте двух объявленных вариантов; выбранная карта расходуется по правилам Deck, разобранным в следующей статье. Type становится именем выбранного варианта, его свойства применяются к прежнему объекту. Для полной замены тела другим классом служит Transforms. Ни Changes, ни колода Type не заменяют наследование Is.
Deck - выбор без возвращения
Колода позволяет выбирать без возвращения. Вытянутая карта исчезает из набора; когда набор заканчивается, его состав восстанавливается. Например, из двух разных карт миров за два розыгрыша выпадут оба вида. При двух независимых проверках Chance один вид мог бы выпасть дважды. Deck описывает карты, а момент розыгрыша задаёт правило, которое использует колоду.
Запишем по одной карте землеподобного и океанического мира в колоду обитаемой зоны ClassK:
["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 1],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1]У ClassK в основной игре два места в этой зоне. Первый розыгрыш случайно выберет один вид, второй получит оставшийся. Одинаковый вид дважды подряд из этих двух карт не выпадет. После исчерпания карт колода восстанавливается, если механизм запросит новый розыгрыш.
Количество карты можно увеличить. Например, в новом составе колоды три землеподобные карты и одна океаническая:
["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 3],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1]При первом розыгрыше землеподобная карта в три раза вероятнее океанической. После её выбора останутся две землеподобные и одна океаническая. Два места зоны по-прежнему получат только два мира: количество карт не создаёт дополнительные места.
У отдельной колоды запись начинается сразу с Deck. Если колода относится к определённому свойству, перед Deck указывается это свойство. Например, Deck.Supplies относится к колоде случайных событий, Orbits.Habitable.Deck.StandardOcean - к раздаче миров обитаемой зоны. Момент выбора карты определяет правило, использующее колоду.
У обычных колод событий и тел допускаются дробные веса. Например, изменим знакомую колоду так:
["ClassK", "Orbits.Habitable.Deck.StandardEarthlike", 0.5],
["ClassK", "Orbits.Habitable.Deck.StandardOcean", 1.5]Первый выбор имеет соотношение весов 0,5 к 1,5. Если выбран StandardOcean, из его веса снимается 1: остаются 0,5 и 0,5. Если затем выбран StandardEarthlike, снимается весь его остаток 0,5: остаётся только океаническая карта с весом 0,5. Дробный вес не создаёт половину мира. После исчерпания колода восстанавливается.
Нулевые и отрицательные карты не участвуют. Отрицательное значение не удаляет унаследованную карту: для удаления нужен патч. Контраст колоды родителя и собственной колоды потомка показан в статье Orbits: собственный состав заменяет прежний целиком. Это правило не такое, как сложение весов зон.
Ресурсная карта описывает не тип мира, а добычу. Например, Deck.Energy.2.1 означает карту производства энергии 2,1 на рабочего; третье число сообщает, сколько таких карт в колоде. Для этих карт количество должно быть целым неотрицательным, а сама добыча положительной. Ссылка Deck.Energy выбирает общую колоду, Deck.Resource внутри неё - один из допустимых ресурсов тела. Полный последовательный пример - «Новый добываемый ресурс и отложенная разведка». Порядок Energy.Deck.* не поддерживается.
Если карта события временно не подходит по условиям, она остаётся в колоде. Остаток карт и число розыгрышей игра хранит в Deck.Pool и Deck.Drawn; эти служебные записи в мод не переносят.
Размер, физические и описательные свойства мира
В обычной PreWarpAge размер, рабочие места и добыча задаются игровыми величинами. Для этого не требуется полная физическая модель планеты. При желании мод может описывать массу, давление, состав и вращение без импорта другой симуляции. Необходимые данные показаны в статье «Физические поля без внешней библиотеки». Эти характеристики не создают автоматически новые правила заселения или добычи. Значения, которые игра рассчитывает сама, не нужно дублировать фиксированными числами.
Size - территория или диаметр
Размер определяет, насколько велико тело в игровой системе PreWarpAge, и участвует в его вместимости. Это игровая шкала, а не километры. При разрушении размер может уменьшаться до объявленного порога, после чего тело исчезает или заменяется остатками.
Зададим крошечному каменному миру игровой размер 3:
["TinyRock", "Size", 3]У новых TinyRock размер будет равен трём единицам игровой шкалы. Число не означает три километра.
Чтобы отделить нижнюю границу от гибели, возьмём отдельное тело MySizeBody на основе CelestialBody, без роли World. Обычные миры уже наследуют правило гибели от World, поэтому на TinyRock такое различие не увидеть. У тестового тела зададим размер и только нижнюю границу:
["MySizeBody", "Is", "CelestialBody"],
["MySizeBody", "Size", 3],
["MySizeBody", "Size.Min", 0]После создания тела его размер при уменьшении упирается в ноль. Сам предел Min не означает гибель: у этого варианта нет Size.Dead. Теперь добавим именно правило гибели при нуле:
["MySizeBody", "Size.Dead", 0]Сначала применяется нижняя граница Size.Min, затем проверяется Size.Dead. При размере ноль MySizeBody теперь погибнет. Изменился именно порог гибели, а не способ ограничения числа.
После гибели можно оставить обломки. Это задаётся через Size.Dead.Transforms. У обычного TinyRock предел, гибель и превращение уже приходят от World; ниже они повторены явно вместе с нашим размером, чтобы прочитать весь результат в одном месте:
["TinyRock", "Size", 3],
["TinyRock", "Size.Min", 0],
["TinyRock", "Size.Dead", 0],
["TinyRock", "Size.Dead.Transforms", "Debris"]В этом фрагменте TinyRock - существующий класс крошечных каменных миров, Debris - обломки. Новые TinyRock получают размер 3. Когда он упадёт до нуля, мир заменится обломками. Size.Max задаёт верхнюю границу показываемого диапазона, но не запрещает любое увеличение размера.
Для физического описания можно задать Size.Measure Kilometers у тела, класса или Simulation. Тогда Size означает диаметр в километрах, рассчитывается относительная площадь Size.Area и не применяется игровой порог гибели по размеру. Однако игровые способности всё ещё могут читать тот же Size для вместимости. Диаметр 12742 не переводится автоматически в обычный размер территории PreWarpAge. Поэтому включение километров требует отдельной проверки экономики и не подходит для косметической правки.
Weight, Density и Gravity - масса, плотность, тяготение
Начнём с массы Земли. В физическом описании она задаётся через Weight в килограммах:
["Earth", "Weight", 5.972e24]5.972e24 означает 5,972 × 10²⁴ килограмма. Имя поля - Weight; слово Mass его не заменяет. Границы Weight.Min и Weight.Max, если они нужны, относятся к показываемому диапазону массы.
Чтобы из массы получить плотность и тяготение, нужен ещё диаметр. В этом физическом примере Size измеряется в километрах. Добавим диаметр Земли 12742 км к массе:
["Earth", "Size.Measure", "Kilometers"],
["Earth", "Size", 12742],
["Earth", "Weight", 5.972e24]Теперь игра может рассчитать Density - плотность в г/см³ - и Gravity - тяготение в земных g. У земного тела Gravity будет около 1. Это физический пример: перевод игрового Size в километры меняет также величину, которую читают игровые правила вместимости. Для обычной правки картинки такой переход не нужен.
Есть другой способ задать ту же физическую модель: известны диаметр и плотность, а массу нужно получить расчётом. Вместо отдельного Weight оставьте Size с единицей Kilometers и задайте, например:
["Earth", "Density", 5.51]Это плотность 5,51 г/см³. По ней и диаметру игра рассчитает недостающую массу. Аналогично масса вместе с плотностью позволяет получить недостающий диаметр. Если масса и диаметр уже заданы, они определяют плотность: не задавайте все три независимыми противоречащими числами. Чрезвычайно массивное малое тело физическая модель может превратить в чёрную дыру.
Distance - расстояния и физическая орбита
Здесь есть два разных расстояния. Физическое Distance - удаление тела от звезды или планеты, нужное для нагрева и движения. Игровая удалённость Distance.Home - расстояние от дома игрока по кольцам, которое может менять цену действий. Не подменяйте одно другим.
Сначала зададим физическое расстояние Земли до Солнца. Число по умолчанию измеряется в километрах, а ссылка CentralBody называет, от чего его отсчитывать:
["Earth", "Distance", 149597870.7],
["Earth", "Distance.CentralBody", "Sun"]Получается примерно 149,6 миллиона километров от Sun. Это не номер кольца на игровом поле. Distance.Min и Distance.Max позволяют дополнительно показать диапазон расстояния.
Теперь опишем длительность одного обращения. Добавим Distance.OrbitalPeriod к уже заданным расстоянию и центру:
["Earth", "Distance", 149597870.7],
["Earth", "Distance.CentralBody", "Sun"],
["Earth", "Distance.OrbitalPeriod", 8766]8766 - период в часах. Положительный Distance.OrbitalPeriod позволяет показывать декоративное обращение; ноль или отсутствие периода оставляет изображение неподвижным. Эти настройки не создают само тело: здесь используются уже определённые Earth и Sun.
Вытянутость физической орбиты задаётся отдельно, в процентах. Для наглядного расчётного примера возьмём расстояние 100000 км и эксцентриситет 10%:
["MyOrbitBody", "Distance", 100000],
["MyOrbitBody", "Distance.Eccentricity", 10]Если Min и Max не заданы заранее, модель получает Distance.Min 90000 и Distance.Max 110000 км: среднее расстояние минус и плюс 10%. При эксцентриситете 0 орбита круговая; этот расчёт не добавляет отдельные Min/Max. Явные границы имеют приоритет и заново по эксцентриситету не вычисляются.
Для подписи геоцентрического расстояния можно выбрать радиусы Земли. Это отдельный пример описания, а не перевод физической модели из километров:
["MyGeocentricMoon", "Distance", 60],
["MyGeocentricMoon", "Distance.Measure", "Earths"]Описание показывает 60 радиусов Земли вместо 60 км. Чтобы описать прежнее физическое расстояние в новой единице, автор должен сам разделить километры на радиус Земли: например, около 382260 км соответствуют 60 радиусам по 6371 км. Однако Distance.Measure меняет подпись, а физические расчёты продолжают читать число Distance в километрах. Поэтому не используйте этот фрагмент вместе с расчётом нагрева или массы как автоматический перевод единиц.
Для описания геоцентрических моделей предусмотрены отдельные справочные поля. Distance.Epicycle - радиус дополнительного круга движения, Distance.Epicycle.Period - период движения по нему в часах. Distance.Eccentric задаёт смещение центра основного круга от точки наблюдения, Distance.Equant - расстояние до точки, относительно которой движение выглядит равномерным. Все три расстояния используют единицы Distance.Measure. В PreWarpAge эти поля показывают описание; законченного рецепта геоцентрической карты они не образуют. Для обычного мода их задавать не требуется.
Игровая удалённость - другой расчёт. В PreWarpAge её начало и единицы объявлены так:
["Simulation", "Distance.From", "Homeworld"],
["Simulation", "Distance.Home.Measure", "Orbits"]Начало - родной мир игрока, единицы - кольца. Игра сама получает Distance.Home, а спутник использует положение своей планеты. Поэтому не нужно записывать результат каждому классу. Правило рассчитано на один родной мир, а не несколько независимых домов.
Temperature - температура
В PreWarpAge Temperature связывает мир с игровыми признаками жары и холода. В физической модели это же слово означает температуру в кельвинах. Смысл определяется набором используемых правил. Поэтому нельзя читать игровое число из обычной PreWarpAge как физическую температуру.
Сначала пример обычной PreWarpAge. У StandardEarthlike исходное игровое значение равно нулю:
["StandardEarthlike", "Temperature", 0]Этот ноль не означает абсолютный ноль: черты основной игры связывают игровое свойство с зоной орбиты. Правила надбавок за жару и холод остаются игровыми.
Для физического описания, напротив, можно прямо задать температуру Земли в кельвинах:
["Earth", "Temperature", 288]288 K - примерно 15 °C. Игра хранит кельвины и показывает градусы Цельсия. Если нет входов для расчёта нагрева, явное значение сохраняется. Полный отдельный пример физического мира приведён в статье «Физические поля без внешней библиотеки».
Теперь получим температуру расчётом. У звезды зададим светимость 1 в солнечной шкале, у мира - расстояние 149600000 км и ссылку на эту звезду:
["MyWarmStar", "Luminosity", 1],
["MyWarmWorld", "Distance", 149600000],
["MyWarmWorld", "Distance.CentralBody", "MyWarmStar"]После создания такого физического мира модель записывает Temperature 278 K, примерно 4,85 °C. Это упрощённый расчёт нагрева от звезды без атмосферной поправки, а не прогноз климата Земли. Имена с My обозначают ваши определения; размещение мира разобрано в Orbit и полном физическом примере.
Увеличим именно этот рассчитанный результат на 10%. К тем же трём входам добавим одну строку:
["MyWarmWorld", "Temperature.Modifier", 1.1]Получится 278 × 1,1 = 305,8 K, примерно 32,65 °C. Множитель применяется к кельвинам, а не к градусам Цельсия. Он должен быть положительным; без него используется 1.
У луны центр - планета, но источник нагрева всё ещё звезда. Добавим к исходному варианту без Modifier луну:
["MyWarmMoon", "Distance", 100000],
["MyWarmMoon", "Distance.CentralBody", "MyWarmWorld"]Цепочка идёт от луны к MyWarmWorld, затем к MyWarmStar. Для нагрева луны используется расстояние планеты до звезды - 149600000 км, а не расстояние 100000 км до планеты. Без собственного Modifier луна получает те же 278 K. Temperature.Min и Temperature.Max описывают диапазон, а не заменяют расстояние или светимость.
Age - возраст
Age сообщает возраст тела в годах. Его можно использовать в описании и в условиях черт. Физические расчёты геологии и приливного воздействия также читают возраст звезды, если заданы остальные необходимые характеристики.
Возраст Солнца 4,6 миллиарда лет записывается так:
["Sun", "Age", 4.6e9]4.6e9 - сокращённая запись числа 4 600 000 000. Age - прошедшие годы, а не срок события в ходах. Возраст не увеличивается автоматически при завершении игрового хода.
Сроки эволюции звезды - отдельные сведения. Например, возраст конца главной последовательности можно записать через Age.LifeSpan:
["Sun", "Age.LifeSpan", 1e10]Это возраст десять миллиардов лет от рождения звезды, а не десять миллиардов лет от текущего хода. Age.WhiteDwarfBirth таким же способом хранит возраст образования белого карлика. Для настоящего перехода между стадиями нужны отдельные правила. Использование возраста в физических расчётах разобрано в Geology и Rotation.
Luminosity и Metallicity - светимость и металличность
Luminosity описывает мощность излучения звезды относительно Солнца. Солнечное значение равно 1:
["Sun", "Luminosity", 1]В физической модели эта величина участвует в нагреве планет и положении температурных зон. Светимость 2 означала бы мощность вдвое больше солнечной. Она не является добычей ресурса Energy.
Metallicity - другое свойство: относительное содержание тяжёлых элементов. Значение 1 тоже означает солнечный уровень, но относится к составу, а не к излучению. Вместе два независимых свойства записываются так:
["Sun", "Luminosity", 1],
["Sun", "Metallicity", 1]У Sun появятся светимость и металличность, равные солнечным. Для обычных звёзд PreWarpAge эти поля необязательны: при отсутствии положительной Luminosity генератор использует солнечное значение только для раскладки зон, не записывая его как свойство звезды.
Atmosphere - атмосфера и облака
Начнём с качества воздуха. Для пригодной для дыхания атмосферы Земли запишем:
["Earth", "Atmosphere", "Breathable"]Breathable - готовое обозначение пригодной для дыхания атмосферы. Если вместо него указать Suffocating, воздух будет описан как непригодный для дыхания без защиты. Это качество среды, а не запас ресурса.
Давление задаётся отдельно от пригодности воздуха. Одна земная атмосфера записывается так:
["Earth", "Atmosphere.Pressure", 1]Значение 2 означало бы давление две атмосферы. Одно давление 1 ещё не означает, что воздух пригоден для дыхания: состав и качества задаются своими фактами.
Теперь укажем состав. После Atmosphere.Gas идёт химическое обозначение газа, третье число - его процент:
["Earth", "Atmosphere.Gas.N2", 78],
["Earth", "Atmosphere.Gas.O2", 21]В описании будут 78% азота N2 и 21% кислорода O2. Игра не дополняет сумму автоматически до 100% и не пересчитывает проценты. Соберём качество, давление и состав в одном фрагменте для существующей Earth:
["Earth", "Atmosphere", "Breathable"],
["Earth", "Atmosphere.Pressure", 1],
["Earth", "Atmosphere.Gas.N2", 78],
["Earth", "Atmosphere.Gas.O2", 21]Четыре записи относятся к одной атмосфере, но отвечают на разные вопросы: можно ли дышать, какое давление и какие газы присутствуют. Для подписей качеств используются ключи вида AtmosphereBreathable.
Вместо явного давления физическая модель может получить его по массе атмосферы. Например, при диаметре Земли и земном тяготении задайте:
["Earth", "Atmosphere.Mass", 1]Это масса одной земной атмосферы, а не доля массы планеты. Если Atmosphere.Pressure не задано, а диаметр равен 12742 км и Gravity равна 1, получится давление 1 атмосфера. При той же планете Atmosphere.Mass 2 даст 2 атмосферы. Явное Pressure имеет приоритет, поэтому не оставляйте его, если хотите проверить расчёт по массе.
Облачный рисунок можно задать независимо от физического расчёта:
["Earth", "Atmosphere.Clouds", "clouds_up"]clouds_up - семейство изображений. Игра выберет конкретный вариант для созданного мира и сохранит его. Облака не создают доход и сами не означают пригодность воздуха.
Для непригодной токсичной атмосферы нужны два качества. Например, такой состав не содержит Breathable:
["Earth", "Atmosphere", "Suffocating"],
["Earth", "Atmosphere", "Toxic"]Посмотрим именно вклад атмосферы в обитаемость, без воды и климата. У отдельного тестового мира включим расчёт Habitability нулём, как в одноимённой статье, и зададим только пригодный воздух с давлением 1:
["MyAirWorld", "Habitability", 0],
["MyAirWorld", "Atmosphere", "Breathable"],
["MyAirWorld", "Atmosphere.Pressure", 1]Без Hydrography и Temperature остальные слагаемые равны нулю; Habitability.Human получает 4 за эту атмосферу. Теперь в отдельном варианте заменим Breathable двумя качествами, не оставляя его рядом с ними:
["MyAirWorld", "Habitability", 0],
["MyAirWorld", "Atmosphere", "Suffocating"],
["MyAirWorld", "Atmosphere", "Toxic"]Для этого изолированного набора Human равен −1: непригодная токсичная атмосфера даёт штраф. Вместо Toxic распознаются MildToxic, HighlyToxic и LethalToxic. Добавим к этому варианту ещё одно качество:
["MyAirWorld", "Atmosphere", "Corrosive"]Теперь сочетание Suffocating + Toxic + Corrosive даёт Human −2 вместо −1. Corrosive усилил штраф именно этого сочетания. Если в отдельном варианте оставить только Corrosive, без Breathable, Suffocating и Toxic, вклад атмосферы будет 0, а не −2. Atmosphere.Toxic с числом - отдельная авторская оценка, не замена строкового качества. Эти варианты заменяют друг друга: не складывайте все показанные атмосферы в один файл.
У пригодной для дыхания атмосферы распознаются ухудшающие качества ChlorineFluorine, SulfurCompounds, NitrogenCompounds, OrganicToxins, LowOxygen, Pollutants, HighCarbonDioxide, HighOxygen и InertGases. Новое придуманное имя само не получит штраф. Эти оценки среды разобраны в Habitability; они не зачисляют и не расходуют игровые ресурсы.
Hydrography - вещества на поверхности и под ней
Укажем, что основное вещество на поверхности Земли - вода. Для воды используется обозначение H2O:
["Earth", "Hydrography", "H2O"]Это выбор вещества. Количество воды на поверхности ещё не задано и добываемый ресурс Water не появился.
Теперь зададим покрытие: вода занимает 71% поверхности.
["Earth", "Hydrography.Surface", 71]Surface - общий процент покрытия выбранным веществом. Чтобы разделить эту воду на жидкую и твёрдую части, нужна температура. В полном фрагменте для Earth добавим 288 K:
["Earth", "Hydrography", "H2O"],
["Earth", "Hydrography.Surface", 71],
["Earth", "Temperature", 288]Фрагмент дополняет Earth из сценария «Солнечная система». Вода покрывает 71% поверхности, температура задана как 288 K. По этим данным игра вычислит жидкую и твёрдую доли в Hydrography.SurfaceLiquid и Hydrography.SurfaceSolid. Если задан общий Hydrography.Surface, рассчитанные фазы отдельно фиксировать не нужно. Подповерхностные доли задаются независимо. Вода в этом описании не становится добываемым ресурсом Water.
Второе вещество имеет свой набор полей. Например, к исходной модели можно добавить метан с покрытием 5%:
["Earth", "Hydrography.Type2", "CH4"],
["Earth", "Hydrography.Type2.Surface", 5]Теперь вода и метан описываются независимо. Для второго вещества результаты называются Hydrography.Type2.SurfaceLiquid и Hydrography.Type2.SurfaceSolid. Для третьего в этих путях используется Type3. Подповерхностные доли задаются отдельно через SubsurfaceLiquid и SubsurfaceSolid с тем же началом пути. Их изображение зависит от возможностей интерфейса.
Фазовая модель распознаёт воду H2O, серу S, диоксид серы SO2, аммиак NH3, метан CH4, азот N2, углекислоту CO2 и серную кислоту H2SO4. Для нового произвольного обозначения она не угадывает температуры плавления и кипения.
Life - признаки жизни и вероятность
Life описывает жизнь и признаки среды, в которой она возможна. Сведения «возможна сложная химия» или «вероятность 100 процентов» не создают живых существ, население и рабочих. Наличие жизни и оценка её вероятности - разные факты.
Сначала назовём тип жизни. В Life записывается ключ словаря:
["Earth", "Life", "MyLifeType"]По ключу MyLifeType игрок должен увидеть «Углеродная жизнь». Нужный словарь приведён в конце статьи. Это название, а не число существ.
Вероятность в описании задаётся другим полем:
["Earth", "Life.Probability", 100]Это информационная оценка 100%, а не бросок случайности и не создание населения. Для случайного выбора true или false существует Life.Chance. Не подменяйте им Probability, если нужна только оценка в описании.
Отдельный признак среды, например сложная химия, записывается как true или false. Соберём название, оценку и этот признак:
["Earth", "Life", "MyLifeType"],
["Earth", "Life.Probability", 100],
["Earth", "Life.ComplexChemistry", true]ComplexChemistry true означает наличие сложной химии. Таким же способом описываются Life.SubsurfaceOcean, Life.HydrothermalVents, Life.MethaneCycle и Life.Organics. У каждого свой признак, не выводимый из Probability. Ни название жизни, ни оценка вероятности не создают работников или доход.
MyLifeType - придуманный ключ названия. Добавьте следующую запись в Text/ruRU.json, чтобы игрок увидел «Углеродная жизнь». Если файла ещё нет, сохраните словарь целиком. Пример относится к существующей Земле сценария «Солнечная система».
{
"MyLifeType": "Углеродная жизнь"
}Geology - геологическая активность
Геология описывает процессы внутри тела и на поверхности: вулканы, движение коры, гейзеры и нагрев. Одно наблюдение можно записать как «есть/нет». Числовой балл - другая форма, которой автор задаёт свою шкалу, а не количество процентов вулканизма.
Сначала запишем только наличие двух процессов на Земле: движения коры и вулканизма. Для такого утверждения достаточно true:
["Earth", "Geology.Tectonics", true],
["Earth", "Geology.Volcanism", true]Земля получает оба признака. Geology.Cryovolcanism и Geology.Geysers также принимают true или false. Если нужна текстовая характеристика геологии в целом, в поле Geology указывается ключ перевода.
В собственной модели можно оценивать тектонику числом вместо ответа «есть/нет». Например:
["Earth", "Geology.Tectonics", 40]Здесь 40 - балл вашей шкалы, а не 40 процентов. True из предыдущего примера не равен баллу 1. Чтобы превратить баллы в категории «слабая» или «сильная», нужны отдельные черты с условиями.
Внутренний нагрев можно получить расчётом, а не назначить авторским баллом. Для него нужны гравитация мира и возраст звезды. Следующий фрагмент задаёт достаточные входы; размещение своего мира возьмите из статьи Orbit или полного физического примера:
["MyHeatStar", "Age", 5e9],
["MyHeatWorld", "Gravity", 1],
["MyHeatWorld", "Distance.CentralBody", "MyHeatStar"]У мира гравитация 1 в земной шкале, у его звезды возраст 5 миллиардов лет. При отсутствии собственного Geology.InternalHeat модель вычисляет 8 баллов: 1 / 5 × 40. Результат округляется до целого и ограничивается сверху 100. Это состояние Geology.InternalHeat, не температура в градусах. Сам числовой балл не получает отдельной строки «нагрев сильный» в описании: для такой подписи нужна черта с Requires.
Проверим необходимый вход. В альтернативном варианте оставим связь со звездой, но не зададим положительную гравитацию:
["MyHeatStar", "Age", 5e9],
["MyHeatWorld", "Gravity", 0],
["MyHeatWorld", "Distance.CentralBody", "MyHeatStar"]В этом изолированном варианте InternalHeat не вычисляется. Отсутствие результата не означает нулевой нагрев. Если другие физические данные вычислят положительную Gravity, вход снова станет достаточным. При уже заданном Geology.InternalHeat автоматический расчёт не заменяет его.
У луны возраст ищется через её планету. Здесь для MyHeatMoon путь идёт к MyHeatWorld, а от него к MyHeatStar из первого примера:
["MyHeatMoon", "Gravity", 1],
["MyHeatMoon", "Distance.CentralBody", "MyHeatWorld"]Если у промежуточной планеты нет собственного Age, расчёт найдёт возраст звезды 5e9 и при Gravity 1 тоже даст 8. Отдельного возраста луны для этого примера не требуется.
Приливный нагрев Geology.TidalHeating - другой расчёт. Он использует массу притягивающего центра и физические параметры самого тела. Разберём случай без вытянутости орбиты:
["MyTidalCenter", "Weight", 5.972e24],
["MyTidalMoon", "Distance.CentralBody", "MyTidalCenter"],
["MyTidalMoon", "Size.Measure", "Kilometers"],
["MyTidalMoon", "Size", 1000],
["MyTidalMoon", "Weight", 1e22],
["MyTidalMoon", "Distance", 100000],
["MyTidalMoon", "Distance.OrbitalPeriod", 24],
["MyTidalMoon", "Distance.Eccentricity", 0]Масса центрального тела указана в первой строке. Все остальные числа относятся к луне: диаметр 1000 км, масса 1e22 кг, расстояние 100000 км, период обращения 24 часа. Эксцентриситет 0 означает круговую орбиту. При этих положительных входах результат TidalHeating равен 0: в модели нагрев зависит от вытянутости орбиты. Это рассчитанный ноль, в отличие от отсутствующего результата при нехватке входов. Удаление положительной массы центра, например, не позволяет выполнить расчёт.
Положительный эксцентриситет задаётся в процентах. Он может дать ненулевой нагрев, но конкретный результат зависит от всех перечисленных величин; число ограничивается 500, а результат меньше единицы записывается нулём. Эти баллы не градусы и не вероятность вулканизма. Автоматическая подпись геологической активности всё ещё требует отдельных черт.
MagneticField - магнитное поле
Магнитное поле здесь - описательная характеристика мира. Число может выражать интенсивность в авторской шкале, а текстовая категория - например, «сильное поле». В PreWarpAge нет общей встроенной шкалы этих баллов или автоматической добычи и защиты населения от одного такого факта.
Сначала зададим только словесную категорию - «Сильное магнитное поле». Для этого нужен ключ перевода в MagneticField.Type:
["Earth", "MagneticField.Type", "MagneticFieldStrong"]У существующей Earth появится подпись по ключу MagneticFieldStrong; в словаре ему должна соответствовать фраза «Сильное магнитное поле». Числовая интенсивность этим не задана.
Если вашей модели нужна числовая оценка, она записывается без Type. Например:
["Earth", "MagneticField", 40]40 - конечный балл выбранной автором шкалы. Он не получает автоматически подпись «Сильное поле»: для связи баллов с категориями нужны отдельные правила. Название ключа MagneticFieldStrong нельзя поставить вместо числа в MagneticField. Ни одна из этих записей сама не создаёт защиту населения или добычу.
Rotation - вращение
Rotation описывает вращение тела вокруг собственной оси, а не обращение по игровой орбите. Период говорит, сколько часов длится один оборот. При приливном захвате тело всё время обращено одной стороной к своему центру; его оборот совпадает с периодом обращения.
Сначала зададим длительность одного оборота Земли вокруг оси:
["Earth", "Rotation", 23.93]Rotation измеряется в часах. Здесь оборот занимает 23,93 часа. Наклон оси - независимое свойство в градусах; добавим его к периоду:
["Earth", "Rotation", 23.93],
["Earth", "Rotation.AxialTilt", 23.44]В описании физической Земли показаны период 23,93 часа и наклон 23,44°. Ни одно из них не меняет автоматически скорость декоративного обращения вокруг звезды.
Для обратного вращения служит отдельный признак. Например, вместо обычного направления можно указать:
["Earth", "Rotation.Retrograde", true]Значение false означает, что признака обратного вращения нет. Приливный захват - отдельная настройка. Зададим телу период обращения 24 часа, исходное вращение 12 часов и включим захват:
["MyLockedWorld", "Rotation", 12],
["MyLockedWorld", "Distance.OrbitalPeriod", 24],
["MyLockedWorld", "Rotation.TidallyLocked", true]При создании тела Rotation становится равным 24, как период обращения. Именно это означает захват: одна сторона постоянно обращена к центру. Значение 12 не сохраняется как ещё один независимый период вращения. Без положительного Distance.OrbitalPeriod признак не даёт числа, к которому можно приравнять Rotation.
Солнечные сутки - время до повторного положения светила на небе. Это не всегда один оборот относительно неподвижного пространства. Возьмём те же два периода без приливного захвата:
["MyDayWorld", "Rotation", 12],
["MyDayWorld", "Distance.OrbitalPeriod", 24]Модель записывает Rotation.SolarDay 24 часа: |12 × 24 / (24 − 12)| = 24. Период самого вращения остаётся 12. Если оба периода равны 24, этот расчёт не записывает конечные солнечные сутки: в знаменателе был бы ноль. В примере с захватом выше периоды как раз становятся равными.
Накопленное приливное воздействие - ещё одна величина, Rotation.TidalEffect. Для неё уже нужны физические размеры и массы. Следующий фрагмент показывает, кому принадлежат входы:
["MySpinStar", "Age", 5e9],
["MySpinStar", "Weight", 1.989e30],
["MySpinWorld", "Rotation", 12],
["MySpinWorld", "Size.Measure", "Kilometers"],
["MySpinWorld", "Size", 12742],
["MySpinWorld", "Weight", 5.972e24],
["MySpinWorld", "Distance", 149597870.7],
["MySpinWorld", "Distance.CentralBody", "MySpinStar"]Возраст и первая масса относятся к звезде, вторая масса и диаметр - к миру. Для этих входов расчёт даёт Rotation.TidalEffect примерно 0,000262. Это меньше порога захвата 50: признак Rotation.TidallyLocked не появляется, Rotation остаётся равным 12 часам. Балл воздействия - не часы и не процент замедления; подсказка вращения не обязана показывать его отдельной строкой.
Если убрать массу центра и не получать её из других физических данных, расчёт воздействия не выполняется. Это отсутствие результата, а не рассчитанный ноль. Для луны ссылка сначала ведёт к планете, затем по её Distance.CentralBody к звезде, где ищется возраст, как в примере Geology. При балле 50 или выше модель назначает признак приливного захвата; для воздействия звезды это правило применяется к телам диаметром не меньше 2000 км. Вращение рисунка и движение по игровым кольцам настраиваются отдельно.
Rings - кольца тела
Rings добавляет видимые кольца вокруг тела, например ледяные кольца гиганта. Это рисунок и описание: кольца не становятся отдельным добываемым поясом и не увеличивают территорию планеты.
Сначала выберем готовый рисунок ярких колец для среднего газового гиганта:
["GasGiantMedium", "Rings", "RingsBright"]RingsBright использует пару изображений ringsbright_down.png и ringsbright_up.png: задний слой и передний. Другие готовые варианты - RingsFaint, RingsModerate и RingsProminent.
Размер рисунка настраивается отдельно. Добавим масштаб 1.05 к уже выбранным кольцам:
["GasGiantMedium", "Rings", "RingsBright"],
["GasGiantMedium", "Rings.Scale", 1.05]Рисунок будет увеличен в 1,05 раза; без Rings.Scale масштаб равен 1. Масштаб должен быть положительным. Size и вместимость тела от этого не меняются. Для собственного MyRings нужны перевод названия и два файла myrings_down.png/myrings_up.png. Их подготовка показана в статье «Точные файлы новых изображений, фонов и звуков».
Habitability и Affinity - пригодность мира
Habitability оценивает пригодность физической среды для человека: возможность дышать, наличие жидкой воды и подходящую температуру. Это информационный балл, а не количество поселенцев и не решение, на каком мире начнёт игрок. Affinity - отдельная оценка привлекательности, которую определяют авторские правила.
Сначала подготовьте физические данные мира: атмосферу, воду и температуру. Каждое из этих полей разобрано в своей статье. Если они уже заданы у Earth, расчёт человеческой пригодности включается отдельной записью:
["Earth", "Habitability", 0]Ноль здесь - исходное значение, разрешающее расчёт, а не оценка «мир непригоден». Итог будет записан отдельно как Habitability.Human. Соберём необходимые исходные сведения с этой записью:
["Earth", "Atmosphere", "Breathable"],
["Earth", "Atmosphere.Pressure", 1],
["Earth", "Hydrography", "H2O"],
["Earth", "Hydrography.Surface", 71],
["Earth", "Temperature", 288],
["Earth", "Habitability", 0]Фрагмент дополняет Earth из сценария «Солнечная система». Пригодная для дыхания атмосфера с давлением 1 атмосфера, вода на 71% поверхности и температура 288 K дают Habitability.Human 8. Если каких-либо данных нет, игра не приписывает отсутствующие составляющие. Балл не создаёт Workers или Income и не заменяет категорию Earthlike при выборе родного мира. Для Affinity также недостаточно одного исходного нуля: нужны правила расчёта и категорий.
Economy и Civilized - описание населённого мира
Economy описывает экономику населённого мира числами для показа: доход и общий объём. Эти информационные величины не зачисляют Credits и не запускают производство PreWarpAge. Для действующего поступления ресурса используется Income.<ресурс>.
Сначала запишем доход как справочную характеристику Земли:
["Earth", "Economy.Income", 100]100 - число в единицах вашей модели. Оно не означает 100 Credits за ход: валюта и период автоматически не назначаются. Для реального поступления кредитов нужна игровая способность с Income.Credits.
Второе справочное число - общий объём экономики. Добавим Economy.Volume к доходу:
["Earth", "Economy.Income", 100],
["Earth", "Economy.Volume", 1000]На населённой Земле с положительным Workers описание покажет доход 100 и объём 1000. На той же Земле без работников оба числа останутся данными, но этот текст не выводится. Назначение работников происходит обычным игровым способом - фрагмент Economy их не создаёт. Поэтому проверяйте показ после заселения и назначения рабочих. Economy.Wealth объединяет авторские качественные черты достатка. Civilized - описательный признак, который сам не создаёт население.
Health и Damage - прочность и урон
Health - запас прочности вещи: урон уменьшает его, а исчерпание уничтожает живой объект. Damage - величина наносимого урона. Одного числового поля недостаточно для новой атаки: урон должен применять существующий механизм, например вариант обстрела астероида.
Сначала рассмотрим запас прочности уже созданной вещи. Например, ей можно задать шесть единиц:
["MyMarker", "Health", 6]Если существующий механизм нанесёт две единицы урона, останется четыре. При Health не больше нуля вещь уничтожается вместе с зависимыми объектами. Health.Max сохраняет исходный максимум для показа. Эта запись не создаёт сам MyMarker: его предварительно нужно разместить, например способом из PlacedAt.
Теперь изменим существующий механизм урона - обстрел астероида Bombard. В его определении укажем две единицы урона и прежнюю цель Parent:
["Bombard", "Damage", 2],
["Bombard", "Damage.Target", "Parent"]Bombard - готовый обстрел в карточке события с астероидом. Parent указывает на эту карточку; изменение Damage усиливает существующий обстрел до двух единиц, сохраняя его цену и кнопку. Это не создание нового оружия. Сначала у цели проверяется Health; если его нет, используется Size, как у астероида PreWarpAge. Health.Max сопровождает исходную прочность, но не заменяет размер астероида автоматически.
Столкновение астероида - другой контекст. У готового события AsteroidEvent зададим урон на единицу размера:
["AsteroidEvent", "Damage", 2],
["AsteroidEvent", "Per", "Size"]Когда существующий механизм столкновения применит такой астероид размера 3, урон составит 2 × 3 = 6. Получателя определит место попадания. Damage.Target Parent здесь добавлять не нужно: этот путь нужен ответу Bombard, который наносит урон родительскому событию с астероидом. Запись не назначает момент столкновения и не создаёт новый астероид; сохраняются правила готового события.
Для собственной живой сущности Health можно объявить числом, например 6; но прежде сама сущность должна быть создана своим механизмом. У варианта EventChoice урон требует явного Damage.Target вида Parent или Parent.<поле>. Готового универсального боя кораблей или новой кнопки «Атаковать» один факт Health/Damage в PreWarpAge не создаёт.
Transforms - превращение тела
Transforms заменяет одно тело другим: например, планета после катастрофы превращается в обломки или заражённый мир. Это не переименование и не смена значка. Положение тела сохраняется, а его прежние постройки уничтожаются; новый класс задаёт дальнейшие свойства.
Разберём готовый эксперимент TestNanobots. Его неудачный исход NanobotsEscaped должен создать мир класса Modified. Класс результата называется через Transforms:
["NanobotsEscaped", "Transforms", "Modified"]Это ответ на вопрос «во что превратить». Он пока не говорит, какое тело заменять. Цель задаётся другой записью:
["NanobotsEscaped", "Transforms.Target", "Parent.Target"]Parent ведёт от исхода к событию эксперимента, его Target - к выбранному миру. Именно этот мир будет заменён. Свяжем исход с экспериментом и сохраним размер прежнего мира:
["TestNanobots", "Has", "NanobotsEscaped"],
["NanobotsEscaped", "Transforms", "Modified"],
["NanobotsEscaped", "Transforms.Target", "Parent.Target"],
["Modified", "Size.From", "Parent"]Фрагмент повторяет часть определения основной игры. У TestNanobots уже есть роль Event, цель Rocky и исход NanobotsEscaped. Если этот исход сработает, выбранный мир заменится на Modified. В строке Transforms.Target значение Parent.Target читается у исхода: Parent указывает на само событие, а его Target - на выбранный мир. В Size.From Parent у нового класса Modified слово Parent уже означает заменяемое старое тело. Так новый мир сохраняет его размер; без этой строки размер берётся у нового класса. Для собственного превращения нужны событие, его цель, подключённый исход и определение нового тела.
Положение и орбитальные связи сохраняются, удерживаемые прежним телом постройки уничтожаются. Поля <имя>.From Parent на новом классе явно сохраняют соответствующие характеристики старого тела. Transforms.Effect, например swarm, выбирает существующий визуальный эффект превращения; это не исполнение нового скрипта.
Spread и Spreads - распространение превращения
Сделаем способность заражённого мира превращать соседей в такие же миры. Сначала объявим отдельную способность MySpread. Ей нужны две роли: черта Trait для подключения к миру и Spread для самого распространения.
["MySpread", "Is", "Trait"],
["MySpread", "Is", "Spread"]Это определение способности. Мир ещё не получил её и пока ничего не заражает. Одна роль Spread на самом мире вместо отдельной черты такой способности не создаёт.
Зададим вероятность срабатывания способности - 10% за ход:
["MySpread", "Chance", 10]Каждый мир с этой способностью получает одну проверку за ход. Это не гарантирует заражение через десять ходов. Допустимый шанс больше нуля и не больше 100. Обычный Random позволяет вместо фиксированного числа задать Chance.Random.Min/Max либо перечислить значения повторными Chance.Random. Для следующего варианта замените прежнюю строку Chance 10 двумя строками, не оставляйте обе формы одновременно:
["MySpread", "Chance.Random", 5],
["MySpread", "Chance.Random", 15]У каждого нового мира независимо выбирается шанс 5% или 15% с равной вероятностью. Это сохранённый шанс самой способности мира; он не выбирается заново каждый ход или при загрузке. За ход выполняется отдельная проверка с этим шансом, без гарантии заражения. Все значения списка и границы диапазона должны оставаться в (0, 100]; дробные значения допустимы. Полный пример ниже по-прежнему использует фиксированные 10%.
Теперь выберем допустимые цели. Пусть заражение действует на миры категории World:
["MySpread", "Target", "World"]При успешной проверке выбирается ближайший подходящий мир, при равном расстоянии - один случайный. Сам источник и уже заражённые миры того же класса не участвуют. Если цели нет, ничего не произойдёт. Дополнительные условия Target могут сузить набор.
Подключим готовую способность к классу заражённого мира:
["MySpreadWorld", "Has", "MySpread"]Теперь каждый созданный MySpreadWorld получает MySpread. При заражении сосед становится MySpreadWorld, теряет прежние постройки и тоже получает способность. Он начнёт распространять её со следующего хода; источник остаётся на месте. Так появляется цепная реакция. После конца партии она останавливается. Поля Spreads и Spreads.Turn для шанса и обработанного хода игра заполняет сама.
Полный пример добавляет в сценарий Солнечной системы мир «Рой машин» на четвёртом кольце. Он имеет шанс 10 процентов за ход превратить ближайший World. Земля также подходит под этот Target: проверяйте пример в отдельной новой партии. Первый блок сохраните как Logic/Spread.json своего мода.
[
["MySpreadWorld", "Is", "World"],
["MySpreadWorld", "Name", "MySpreadWorldName"],
["MySpreadWorld", "Icon", "nanobot"],
["MySpreadWorld", "Size", 3],
["MySpreadWorld", "Orbit.Center", "Sun"],
["MySpreadWorld", "Orbit", 4],
["MySpreadWorld", "Has", "MySpread"],
["MySpread", "Is", "Trait"],
["MySpread", "Is", "Spread"],
["MySpread", "Name", "MySpreadName"],
["MySpread", "Icon", "nanobot"],
["MySpread", "Chance", 10],
["MySpread", "Target", "World"]
]{
"MySpreadWorldName": "Рой машин",
"MySpreadName": "Заражение соседей"
}Второй блок сохраните как Text/ruRU.json. MySpreadWorld и MySpread - придуманные имена класса мира и его способности. Они не зависят от существующих Modified или NanobotSpread. World задаёт категорию мира, nanobot выбирает готовый рисунок, Size 3 - размер. Orbit.Center Sun и Orbit 4 размещают первый мир в свободной ячейке четвёртого кольца Солнца. Has MySpread подключает способность. При превращении соседнее тело тоже становится MySpreadWorld, получает эту способность и продолжает заражение.
У одного мира может действовать только одна способность Spread. Если вы наследуете другой класс с такой способностью, сначала устраните дублирование. При снятии или отключении единственной черты Spread распространение прекращается и служебный Spreads удаляется. Для разового превращения без цепной реакции используйте исход события с Transforms.
Visibility - видимый блеск и угловой размер
Visibility описывает вид небесного тела с точки наблюдения: его яркость и угловой размер. Например, маленькое близкое тело может занимать на небе больше места, чем большое далёкое. В обычной карте PreWarpAge эти сведения не меняют размер изображения или производство.
Сначала зададим яркость в описании. Visibility.Brightness - видимая звёздная величина:
["Earth", "Visibility.Brightness", 1]Чем меньше это число, тем ярче объект. Оно не меняет корону или размер рисунка. Для диапазона вместо одного значения используются Visibility.Brightness.Min и Visibility.Brightness.Max.
Угловой диаметр - другая величина. Она говорит, какую часть неба занимает тело. Добавим значение 3,13 минуты дуги к уже заданной яркости:
["Earth", "Visibility.Brightness", 1],
["Earth", "Visibility.Angle", 3.13]Фрагмент задаёт Earth видимую звёздную величину 1 и угловой диаметр 3.13 минуты дуги. Для диапазона углового размера существуют Visibility.Angle.Min и Visibility.Angle.Max, по тому же правилу, что у яркости. Это указанные автором сведения; игра не пересчитывает их по положению камеры. Размер рисунка меняется через IconSize, физическая светимость звезды - через Luminosity.
StellarCorona - яркость короны
Корона - видимое свечение вокруг звезды. StellarCorona задаёт яркость этого эффекта в существующем клиенте, не светимость звезды для физических расчётов и не отдачу энергии.
StellarCorona - конечное неотрицательное число. Без него или при нуле свечения нет. Значение 1 даёт обычную яркость, дробное положительное число - более слабую, число больше 1 - более сильную.
["ClassG", "StellarCorona", 1]Жёлтые звёзды получают свечение короны. Цвет и техника рисования выбираются клиентом по существующим правилам.
Имена, описания и ресурсы представления
Следующие поля задают названия, пояснения, изображения и звуки. Они оформляют объекты, для которых в игре уже есть способ показа, но сами не создают окна или кнопки. Тексты хранятся в Text, изображения - в Art, звуки - в Sounds. Пишите игровые строки обычным текстом без HTML и цветовых тегов. Если игра сама показывает величину эффекта, не повторяйте её вручную в описании: иначе после изменения числа описание устареет.
Name - название и набор имён
Name задаёт название объекта. Обычно его значение - ключ из словаря Text, по которому игра находит текст на выбранном языке. Для новых миров можно также задать набор случайных имён. Пока есть свободные имена, они не повторяются.
Сначала зададим постоянное название через ключ словаря. Например, маркер MyMarker из статьи PlacedAt получает своё имя:
["MyMarker", "Name", "MyMarkerName"]Если в Text/ruRU.json ключ MyMarkerName имеет значение «Моя станция», так маркер и будет называться. Name не создаёт сам маркер и не меняет его тип.
Теперь другой случай: многим новым мирам нужны разные имена. Сначала перечислим два названия в наборе MyWorldNames:
["MyWorldNames", "Name.Option", "MyNameOne"],
["MyWorldNames", "Name.Option", "MyNameTwo"]Это ещё только набор ключей, не назначенный ни одному миру. Свяжем его с TinyRock через Name.Random. Полная связь и оба варианта:
["TinyRock", "Name.Random", "MyWorldNames"],
["MyWorldNames", "Name.Option", "MyNameOne"],
["MyWorldNames", "Name.Option", "MyNameTwo"]Этот фрагмент меняет имена новых миров TinyRock. MyWorldNames - придуманное имя набора; MyNameOne и MyNameTwo - ключи двух названий. Сохраните следующий полный словарь как Text/ruRU.json. Если такой файл у мода уже есть, добавьте в него только две записи.
{
"MyNameOne": "Первый камень",
"MyNameTwo": "Второй камень"
}В новой партии миры TinyRock будут получать «Первый камень» и «Второй камень». Пока есть свободные имена, они не повторяются; после исчерпания набора повторы допустимы. Порядок Name.Option влияет на повторение партии по зерну, поэтому не переставляйте его без необходимости. Фиксированное Name у самого определения важнее случайного набора.
Подпись свойства задаётся уточнением Name у этого свойства и не меняет его числового смысла. Имя, введённое самим игроком, сохраняется как готовый текст: даже совпав с ключом словаря, после смены языка оно не переводится заново.
InputName - предложение имени для ввода
InputName задаёт имя, которое предлагается в поле ввода. Например, перед началом партии игра может предложить название корпорации, а игрок - заменить его своим. Поле ввода должно уже существовать в интерфейсе.
Значение InputName - ключ текста в словаре. <поле>.InputName задаёт предложение для имени соответствующего свойства. Если игрок уже ввёл имя, оно важнее предложения. Собственное InputName у определения заменяет унаследованное. При подтверждении партии игра переводит предложенное имя на выбранный язык и сохраняет получившийся текст.
CorpMiner - существующая корпорация добытчиков, CorpMinerName - её готовый переводимый вариант имени. Пример меняет предложение в уже существующем редакторе корпорации.
["CorpMiner", "InputName", "CorpMinerName"]При выборе добытчиков поле имени корпорации предлагает существующий перевод CorpMinerName. Смена языка позднее не переименовывает уже сохранённого игрока. Name.Input и Corporation.DefaultName не являются действующими синонимами InputName.
Description - пояснение сущности и свойства
Description задаёт пояснение к объекту или свойству. В триплете хранится ключ, а сам текст - в словаре выбранного языка. Так можно объяснить назначение аванпоста, не меняя его цену или работу.
Сначала дадим пояснение аванпосту. Здесь OutpostDesc - уже существующий ключ описания:
["Outpost", "Description", "OutpostDesc"]В подсказке аванпоста появится перевод OutpostDesc. Цена, срок и доход не изменятся. Для пояснения конкретного свойства используют уточнение Description у этого свойства, а для одной строки свойства - ещё и имя части. Текст не заменяет само значение.
У разведки нужно показать не обычный текст, а доступные варианты выбора ресурса. Description.Choices ссылается на готовое событие WorkFocus. Вместе обычное описание и это особое применение выглядят так:
["Outpost", "Description", "OutpostDesc"],
["Explore", "Description.Choices", "WorkFocus"]Аванпост получает пояснение из существующего ключа, а описание разведки показывает варианты WorkFocus. Условия и величины вариантов читаются из самих определений.
У технологии Description содержит пояснение для тултипа. Сообщение о завершении получает собственный Description на реакции, включённой в Has технологии, например MyStudyResearched с Is TechResearched. Полный пример находится в статье Tech. Оба описания используют обычное поле с ключом текста, но принадлежат разным субъектам.
Повторные Description на самом объекте показываются в порядке записи с рангом 0. Для отдельных абзацев используйте дочерние части с собственными Description и Order. Имя части произвольное, а Order задаёт ранг абзаца, не всей сущности. К существующему описанию Outpost добавим два абзаца:
["Outpost.Note", "Description", "MyOutpostNote"],
["Outpost.Note", "Order", 1],
["Outpost.Warning", "Description", "MyOutpostWarning"],
["Outpost.Warning", "Order", 2]Добавьте MyOutpostNote и MyOutpostWarning в Text. Обычное описание Outpost с рангом 0 останется первым, затем появятся части с рангами 1 и 2. Условия Requires части проверяются для читаемой сущности; закрытая часть исключает и вложенные описания. Собственный прямой Description задаёт описание целиком и прекращает дальнейшее наследование. До этого владельца включительно собираются описания частей; ближайший Description части заменяет коллекцию родительской части с тем же относительным путём. Один Text на части не делает её абзацем.
В абзац можно подставить локализованное значение. Text и необязательный Color задаются на ключе описания, а не на самой части:
["MyOutpostNote", "Text", "MyOutpostNoteValue"],
["MyOutpostNote", "Color", "superGreen"]Например, MyOutpostNote хранит «Особенность: {0}», а MyOutpostNoteValue - «Включено». В описании получится «Особенность: Включено»; superGreen окрасит только подставленное значение. Оба перевода остаются обычным текстом без разметки. Это оформление статической подписи, а не новый игровой эффект. Без Text описание выводится как обычный абзац.
Text - текстовая подпись
Text задаёт короткую подпись там, где игра уже умеет её показывать, например у действующей черты. Name называет сам объект, Description подробно его объясняет, а Text подписывает конкретное представление. Добавление Text к произвольному объекту не создаёт нового места для подписи.
Уже подключённая в игре черта SizeScale масштабирует вместимость по размеру тела. Следующая строка меняет её читаемую подпись, не выдавая новую черту всем мирам и не меняя числа.
["SizeScale", "Text", "MySizeScaleText"]Сохраните следующий словарь как Text/ruRU.json или добавьте запись в уже существующий файл. Черта SizeScale получит подпись «Вместимость по размеру». Здесь меняется действующая черта основной игры. Чтобы создать собственную, сначала объявите Is Trait и подключите её через Has к нужным объектам либо задайте условия выдачи через Grants.
{
"MySizeScaleText": "Вместимость по размеру"
}Hint - дополнительная подсказка
Hint подсказывает игроку, какое действие можно выполнить через свойство. В PreWarpAge такой текст появляется в подсказке действующей черты, пока доступен связанный с ней вариант события. Для обычного пояснения к объекту используйте Description.
RobotHeldTrait - готовая черта «Под контролем роботов». Через неё уже подключён вариант RetakeStart, начинающий операцию возврата мира. Hint задаёт подпись-призыв этой черты, пока операция доступна. <поле>.Hint относится к подсказке соответствующего свойства. Ни Hint, ни строка перевода не объявляют горячую клавишу.
["RobotHeldTrait", "Hint", "RobotControlHint"]Этот фрагмент повторяет существующую запись. RobotControlHint уже переводится как «Нажмите для операции по возврату». Чтобы изменить фразу, замените значение этого ключа в Text/ruRU.json. Hint у произвольного аванпоста Outpost не создаст новое действие или окно.
Tag - подпись категории
Tag даёт понятную подпись общей категории. Например, мир может одновременно быть каменным и холодным; игроку показываются обе подписи категорий, а не одно новое длинное имя планеты.
Tag задаётся у категории и ссылается на ключ её названия. Объекты показывают подписи своих Is-категорий без повторений. Поэтому Tag не нужно копировать в каждое определение планеты: связь Is уже сообщает, какие подписи ей подходят.
["Rocky", "Tag", "CatRocky"]Все сущности Is Rocky получают строку категории «Каменный» через связь, а не через ручной Tag на каждой планете. Категория с Tag не считается самостоятельным конкретным Type при его выводе.
Default - вариант по умолчанию
Default выбирает первоначальный вариант в одном списке главного меню: например, корпорацию или сценарий. Это исходное предложение, пока игрок сам не выбрал другое. У каждого такого списка может быть только один вариант по умолчанию.
Значение Default - true или false. true задаётся одному варианту в каждой группе выбора: например, одной корпорации и одному сценарию. Настройка принадлежит самому определению и не наследуется. Новая корпорация на основе CorpMiner не станет ещё одним вариантом по умолчанию. После собственного выбора игрока Default его не меняет.
Ниже полный файл патча Logic/Default.json. Он снимает исходный выбор CorpMiner - добытчиков - и предлагает CorpTechnocrat, технократов. Операция set заменяет значения существующих полей; подробности патчей приведены в разделе о файлах.
{
"set": [
["CorpMiner", "Default", false],
["CorpTechnocrat", "Default", true]
]
}Новое меню предлагает технократов по умолчанию вместо добытчиков. Две оставленные строки Default true дали бы ошибку неоднозначности.
Order, Tier и Level - порядок, ярус и уровень
Order задаёт порядок карточек, Tier - ярус дерева технологий, Level - достигнутый уровень повторяемого исследования. Для перестановки технологии нужны Order и Tier. Level для этого менять не следует: он относится к выполненным исследованиям и силе их эффекта.
Сначала выберем ярус технологии глубокой добычи. В первом ярусе она объявлена так:
["DeepExtraction", "Tier", 1]Замена 1 на 2 перенесёт карточку во второй ярус. Требование предшественника от этого не появится: оно задаётся Requires. Tier принимает конечное число, для дерева обычно используется целое.
Теперь выберем место внутри яруса. Order 2.5 ставит карточку между соседями с Order 2 и 3:
["DeepExtraction", "Order", 2.5]Order может быть дробным, но должен быть конечным и неотрицательным. Ни порядок, ни ярус не означают, что технология уже изучена.
DeepExtraction - существующая технология глубокой добычи. Пример только переставляет её карточку: Tier 1 означает первый ярус, Order 2.5 - место между соседними значениями 2 и 3. Никакой Level этим не присваивается.
["DeepExtraction", "Tier", 1],
["DeepExtraction", "Order", 2.5]Карточка останется на первом ярусе и займёт место между Order 2 и 3. Цена и способ оплаты не изменятся. Level отвечает на другой вопрос: сколько уровней повторяемой технологии уже изучено в партии. Например, Level 2 означает два завершённых изучения и участвует в силе бонуса. Это не параметр перестановки карточки. Одно поле Level не создаёт систему уровней у произвольного объекта.
Enabled - состояние переключателя
Enabled хранит состояние уже существующего переключателя. Например, у микрофона true означает включённое распознавание речи, false - выключенное. Для доступности технологий и строительства используются их собственные требования, а не Enabled.
Microphone - готовый переключатель микрофона. При нажатии его действующий обработчик меняет Enabled, а клиент начинает или прекращает распознавание речи. Данные ниже задают исходное выключенное состояние существующего элемента.
["Microphone", "Enabled", false]Фрагмент задаёт выключенное состояние микрофона. Замена false на true означает включённое состояние существующего переключателя. У некоторых элементов меню оно также отмечается зелёным. Для доступности технологии или постройки нужны Requires либо Blocks; Enabled у ресурса производство не отключает. Формат переключаемых экономических политик Toggle в текущей PreWarpAge не поддержан - его граница разобрана отдельно в статье Toggle.
Difficulty - подпись сложности
Difficulty - подпись уровня сложности на карточке сценария. Она помогает сравнить варианты в меню, но не пересчитывает баланс: изменение слова «Нормально» на «Сложно» само не меняет цены, запасы и сроки.
Difficulty - строковый ключ уровня сложности карточки. Основной набор: DifficultyVeryEasy, DifficultyEasy, DifficultyNormal, DifficultyChallenging, DifficultyHard, DifficultyVeryHard, DifficultyMasochist. Это подпись и принятый цвет показа, а не автоматический множитель цен или силы противника. Точные правила выбранного режима задаются отдельно.
["ScenarioG", "Difficulty", "DifficultyNormal"]У карточки сценария показана нормальная сложность. Изменение этой строки не изменит ресурсы, сроки или устройство карты.
Preview - состав описания главного меню
Preview выбирает, какие способности нужно кратко показать на карточке главного меню. Оно влияет на описание до начала партии; скрытая из такого краткого описания способность продолжает работать в самой игре.
Покажем способности всей корпорации добытчиков на её карточке. Для этого у CorpMiner зададим Preview со значением MainMenu:
["CorpMiner", "Preview", "MainMenu"]Карточка CorpMiner получает краткое описание её способностей. Удаление Preview сокращает описание карточки, но не отключает саму способность и не убирает её эффект в партии.
В статье «ColdWorld и Icy» мы добавим добытчикам часть ColdMining с бонусом на холодных мирах. Чтобы показать на карточке только эту добавленную часть, задайте Preview у неё вместо всей корпорации:
["CorpMiner.ColdMining", "Preview", "MainMenu"]В описание включается часть ColdMining и её вложенные части. Сначала нужно добавить сам бонус из указанного примера: Preview его не создаёт. Preview относится к самому определению: оно не наследуется и не переносится на объекты партии.
Icon - изображение сущности и свойства
Icon задаёт рисунок вещи или значок свойства. Сначала нужен существующий PNG-файл, затем факт с его именем. Смена значка меняет изображение, а не класс, действие или числовой эффект.
Сначала выберем рисунок самого аванпоста. Имя файла пишется без .png:
["Outpost", "Icon", "outpost"]Игра найдёт существующий outpost.png в Art. Смена Icon меняет изображение; новое название класса или действие из этой строки не возникает.
Значок работников корпорации - отдельный выбор. Его задают через Icon.Workers, а не через Icon самого CorpMiner:
["CorpMiner", "Icon.Workers", "cosmo_helmet_orange"]Работники добытчиков будут использовать существующий cosmo_helmet_orange.png. Сам значок корпорации от этого не изменится. Соберём оба независимых изменения:
["Outpost", "Icon", "outpost"],
["CorpMiner", "Icon.Workers", "cosmo_helmet_orange"]В этом фрагменте Outpost использует рисунок outpost. У корпорации CorpMiner значок работников заменяется на cosmo_helmet_orange. Оба файла уже есть в игре. Для отдельного изображения объекта на карте используется IconMap; запись Icon.Map недопустима.
Для собственного рисунка сначала создайте Art/Icons/my_icon.png, затем укажите Icon my_icon. Имена ищутся без пути: два my_icon.png в разных подпапках конфликтуют. Для значков удобно начать с прозрачного квадрата 256 × 256, но это не обязательный размер.
Если вместо одного рисунка есть семейство my_icon00.png/my_icon01.png и нет точного my_icon.png, значение Icon my_icon выбирает вариант для созданного объекта и сохраняет его. Если добавить точный файл my_icon.png, он получит приоритет. У обычного компонента свойства используется форма с Icon после имени поля; не переставляйте её со специальной Icon.Workers.
IconMap - отдельный образ на карте
У постройки может быть один значок на кнопке и другой образ на карте. IconMap меняет только образ карты, сохраняя обычный Icon в остальных местах. Если нужны одинаковые изображения, достаточно одного Icon.
Сначала выберем рисунок только для карты:
["Outpost", "IconMap", "outpost"]Здесь рисунок совпадает с обычным значком. При другом имени IconMap поменяется только образ карты; если IconMap убрать, карта снова использует Icon. В IconMap допустим готовый PNG или образ из заднего и переднего файлов.
Теперь увеличим только картинку на карте. К выбранному IconMap добавим положительный масштаб IconMap.Scale. Полный фрагмент для существующего Outpost:
["Outpost", "Icon", "outpost"],
["Outpost", "IconMap", "outpost"],
["Outpost", "IconMap.Scale", 1.1]Готовый аванпост на карте увеличивается до масштаба 1.1, а его значок кнопки остаётся обычным. Для своего двухслойного образа создают PNG-пару <имя>_down и <имя>_up: задняя часть рисуется за телом, передняя перед ним. Эти файлы также должны иметь уникальные базовые имена.
IconGain и IconReady - значок прироста и готовности
Некоторые ситуации используют отдельные рисунки: находка увеличенного источника и действие, готовое к применению. IconGain и IconReady выбирают именно эти значки, а не величину находки и не право выполнить действие.
Сначала зададим значок увеличения минерального источника:
["Minerals", "IconGain", "ore_iron_plus"]Для находки будет использован существующий рисунок ore_iron_plus. Размер награды этой строкой не задаётся.
У готового к выполнению действия другой значок - IconReady. Для разведки Explore выберем лупу magnifier. Соберём оба примера:
["Minerals", "IconGain", "ore_iron_plus"],
["Explore", "IconReady", "magnifier"]Находка минералов и готовая разведка используют свои рисунки. IconReady относится к действию Is Action и не отменяет его требования. Для обоих полей нужно точное имя файла: база случайного семейства здесь не подходит. Показ определяется настоящим результатом или доступностью действия.
IconSize - масштаб изображения
IconSize меняет размер изображения тела на экране. Игровой размер и число рабочих мест остаются прежними. Если положительное значение IconSize не задано, игра выбирает масштаб изображения по Size.
IconSize - конечное число масштаба тела. Положительное авторское значение имеет приоритет. Без положительного значения интерфейс выводит масштаб из Size. У Simulation это общий масштаб тел. <поле>.IconSize относится к поддерживаемому представлению свойства. Масштаб не меняет игровую территорию, цену или вместимость.
["Debris", "IconSize", 1.5]Debris получает масштаб изображения 1.5. Если вы хотите изменить территорию планеты и связанную с ней вместимость, меняйте Size. Если нужно только увеличить рисунок, достаточно IconSize; изменять оба поля ради одного и того же визуального результата не требуется.
IconText - короткая подпись значка
IconText - короткая подпись на уже существующем значке. Это может быть вопросительный знак или число. Подпись не становится запасом ресурса, ценой или сроком только потому, что выглядит как число.
IconText и <поле>.IconText принимают готовый текст или конечное число; true и false недопустимы. Число показывается в принятом в игре формате. Например, подпись «3» не означает три единицы ресурса: настоящее количество нужно задавать через Count.
MyMarker - размещённый объект с рисунком outpost из примера PlacedAt; строка ниже добавляется к его определению после Is Building, Icon outpost и PlacedAt Earth. Сама IconText маркер не создаёт.
["MyMarker", "IconText", "?"]Маркер показывает вопросительный знак. Это готовая подпись, а не ключ словаря. Если вместо знака нужно число, замените только значение:
["MyMarker", "IconText", 3]Теперь подпись выглядит как число 3, но запас ресурса не стал равен трём. Для настоящего количества нужен Count. IconText принимает текст или конечное число, но не true/false; действие или окно из подписи не возникает.
Color - цветовая идентичность
Color выбирает готовый цвет для объекта: например, оранжевый для корпорации или красный для опасного события. Меняется оформление. Цвет не определяет силу эффекта, тип опасности или условия появления события.
Color и <поле>.Color принимают имя из готовой палитры; перечень приведён после примера. RGB-коды, CSS и HTML в игровые данные не записываются. Цвет дефицита или недоступного действия выбирает сам интерфейс по состоянию игры.
["CorpMiner", "Color", "orange"]Корпорация добытчиков получает оранжевое оформление. Её способности и ресурсы остаются прежними.
Палитры игрока и корпорации: red, orange, yellow, green, teal, blue, purple, pink. Цвета события: green, superGreen, lightGreen, darkGreen, red, superRed, darkRed, gray, lightGray, darkGray, veryDarkGray, lightBlue, blue, darkBlue, darkDarkBlue, grayYellow, yellow, pink, cyan, darkCyan, orange, darkOrange, lightViolet, purple, chartreuse, navyBlue. Регистр важен. Также существуют семантические имена positive, danger, info и цвета difficultyVeryEasy, difficultyEasy, difficultyNormal, difficultyChallenging, difficultyHard, difficultyVeryHard, difficultyMasochist. Произвольный код цвета не создаёт новую палитру.
Hide - скрытие представления
Hide скрывает уже существующее представление. Скрытая характеристика может продолжать вычисляться и влиять на игру. Поэтому прятать число и отменять его эффект - разные операции.
Сначала скроем только показ размера звезды. Значение true относится к Size.Hide, а не к самому Size:
["Star", "Size.Hide", true]Игровой размер звезды больше не показывается отдельной кнопкой, но его значение сохраняется. Наличие Hide не переключает физические единицы и не является условием генерации. Если нужно отменить унаследованное скрытие, укажите false у собственного определения:
["ClassG", "Size.Hide", false]Теперь ClassG может показывать свой размер, хотя родитель Star скрывал его. И true, и false управляют показом, не значением размера.
Уведомление можно скрыть целиком. Например, следующий фрагмент скрывает сообщение события SuppliesWater, которое добавляет воду игроку:
["SuppliesWater", "Hide", true]Событие продолжает добавлять воду, но его сообщение не появляется. У числового эффекта Hide аналогично скрывает строку описания, сохраняя сам расчёт. Поэтому скрытие не подходит для отмены способности.
Чтобы отключить способность, нужно изменить её правило или снять саму способность. Hide для этого не подходит: скрытый бонус продолжит действовать, а скрытое уведомление не отменит событие.
Background - фон сцены
Background выбирает задний фон карты. Параллакс - небольшое смещение слоёв, создающее ощущение глубины при движении камеры; его можно отключить отдельно от звёздного слоя.
Сначала выберем готовый фон nebula для карты PreWarpAge:
["Simulation", "Background", "nebula"]Background называет набор изображений фона. Дополнительный слой звёзд включается отдельно:
["Simulation", "Background.Stars", true]Значение false убрало бы этот слой, сохранив сам фон nebula. Смещение слоёв при движении камеры - ещё одна отдельная настройка. Отключим его и соберём все три выбора:
["Simulation", "Background", "nebula"],
["Simulation", "Background.Stars", true],
["Simulation", "Background.Parallax", false]Карта использует готовый фон nebula и звёздный слой. Фон при движении камеры не смещается, поскольку параллакс выключен.
В PreWarpAge эти настройки карты задаются у Simulation. Для собственного фона создайте Art/Backgrounds/my_space00.jpg и укажите Background my_space. Если вариантов несколько, продолжайте номера: my_space01.jpg, my_space02.jpg. Даже один файл должен оканчиваться на 00.jpg. Не пропускайте номера: поиск заканчивается на первом отсутствующем файле. PNG вместо JPG здесь не подходит.
Sound и Music - голос, окружение и музыка
Начнём с короткого звука разведки. У действия Explore он задаётся через Sound:
["Explore", "Sound", "scan"]scan - имя существующего OGG-файла без пути и расширения. Звук проигрывается, когда выполняется разведка; он не становится постоянным фоном.
Музыка относится ко всей сцене, поэтому записывается у Simulation через Music. Добавим существующую композицию interstellar_waltz к примеру со звуком разведки:
["Explore", "Sound", "scan"],
["Simulation", "Music", "interstellar_waltz"]Sound scan остаётся звуком действия, а Music interstellar_waltz - музыкой сцены. Music в обычном массиве заменяет прежний плейлист Simulation; для добавления дорожки к прежнему списку нужна операция add из раздела патчей. Несколько Music в одном файле составляют новый плейлист в порядке записи. Формы Sound.Music нет.
У коротких звуков можно разрешить небольшое изменение высоты и тембра. Это не выбор другой музыкальной дорожки:
["Explore", "Sound.Variants", true]При false изменения тембра выключены. Выбор одного из нескольких файлов - другая настройка: имя Sound может обозначать семейство. Создайте два файла без отдельного my_scan.ogg:
Sounds/FX/my_scan00.ogg
Sounds/FX/my_scan01.oggТеперь укажите общую часть имени, без числового окончания:
["Explore", "Sound", "my_scan"]Вместо одного точного файла разведка сможет выбрать вариант семейства my_scan00 или my_scan01. Цифры допустимы сразу после имени или после подчёркивания. Sound.Variants при этом остаётся отдельным разрешением менять высоту и тембр уже выбранного звука.
Sound.Ambience зарегистрировано как поле звукового окружения карты, однако отдельного поддержанного рецепта его воспроизведения в текущем интерфейсе PreWarpAge здесь нет. Не используйте его как обещанный способ включить постоянный фон: показанные рабочие контексты - звук действия Sound и музыка сцены Music. Громкостью и порядком воспроизведения управляет интерфейс; произвольные суффиксы Sound новых настроек не создают.
Для своих записей создайте Sounds/FX/my_scan.ogg и Sounds/Music/my_theme.ogg, затем укажите имена my_scan и my_theme. Используйте OGG Vorbis: короткий эффект может быть моно, музыка - стерео. Имена должны быть уникальными, даже если файлы лежат в разных подпапках. Звук действия проигрывается при его выполнении, а не постоянно. Частота дискретизации задаётся в самом аудиофайле.
FunFact, Myth и Machinery - дополнительный рассказ
К миру можно добавить занимательный факт, мифологический рассказ или пояснение его движения. Игрок читает эти тексты в описании; они не запускают описанные в них события и физические процессы.
Добавим к Земле один занимательный факт. FunFact ссылается на ключ перевода:
["Earth", "FunFact", "MyEarthFact"]В Text/ruRU.json задайте для MyEarthFact фразу «На Земле существует жидкая вода на поверхности». В описании появится этот текст. Воду он не создаёт: это пояснение для игрока.
Теперь добавим отдельное пояснение движения. Для Machinery.Description не требуется поле Machinery без уточнения:
["Earth", "Machinery.Description", "MyMotionText"]Перевод MyMotionText расскажет о движении, но не изменит орбиту. Обе изученные подписи вместе:
["Earth", "FunFact", "MyEarthFact"],
["Earth", "Machinery.Description", "MyMotionText"]После добавления переводов MyEarthFact и MyMotionText у авторской Земли появляются соответствующие пояснения. Никакой новой физики они не запускают.
Словарь для показанного фрагмента Text/ruRU.json:
{
"MyEarthFact": "На Земле существует жидкая вода на поверхности.",
"MyMotionText": "Земля обращается вокруг Солнца."
}Пример относится к Earth из сценария «Солнечная система». Для мифологического рассказа используется другая пара подписей:
["Earth", "Myth", "MyEarthMyth"],
["Earth", "Myth.Name", "MyEarthMythName"]Например, переведите MyEarthMyth как «Земля считалась матерью живого», а MyEarthMythName как «Мать-Земля». Myth содержит рассказ, Myth.Name - имя его персонажа. Профиль Deity описывается отдельно: один текст мифа его не создаёт.
Deity, Nature, Metal и Weekday - профиль божества
Deity связывает небесное тело с мифологическим персонажем. У персонажа можно указать имя, пояснение, символический металл и день недели. Это дополнительный рассказ о мире. Правила экономики от него не меняются.
Сначала создадим профиль MyDeity и свяжем с ним существующую Землю. Здесь Deity после Is - роль профиля, а Deity у Earth - ссылка на него:
["MyDeity", "Is", "Deity"],
["Earth", "Deity", "MyDeity"]Теперь у Земли есть связанный профиль. Ему можно дать обычные Name, Description и Icon, как любому описываемому определению. Без объявления Is Deity ссылка на MyDeity была бы ошибкой.
Добавим характеристику персонажа. Nature содержит ключ фразы, а не новое правило поведения:
["MyDeity", "Nature", "MyDeityNature"]Перевод MyDeityNature, например «Спокойный и плодородный», появится в описании профиля. Он не повышает плодородие мира.
Символический металл задаётся отдельно. В этом примере Iron - ключ подписи «Железо», а не ресурс игрока:
["MyDeity", "Metal", "Iron"]Профиль получает подпись металла. Запас минералов и добыча не меняются. Так же отдельно задаётся связанный день недели:
["MyDeity", "Weekday", "Tuesday"]Перевод Tuesday - «Вторник» - станет подписью дня. Это не календарь и не расписание событий. Соберём профиль с обычными именем, описанием и готовым рисунком ares:
["MyDeity", "Is", "Deity"],
["MyDeity", "Name", "MyDeityName"],
["MyDeity", "Description", "MyDeityDesc"],
["MyDeity", "Icon", "ares"],
["MyDeity", "Nature", "MyDeityNature"],
["MyDeity", "Metal", "Iron"],
["MyDeity", "Weekday", "Tuesday"],
["Earth", "Deity", "MyDeity"]Первый блок связывает Землю с готовым профилем. Второй блок - его словарь Text/ruRU.json. Один профиль можно связать с несколькими телами и наследовать обычным Is. Путь Deity.Nature читает Nature связанного профиля; так можно обратиться к уже заданной характеристике через тело.
{
"MyDeityName": "Покровитель Земли",
"MyDeityDesc": "Мифологический образ, связанный с этим миром.",
"MyDeityNature": "Спокойный и плодородный",
"Iron": "Железо",
"Tuesday": "Вторник"
}Url - внешний адрес
Url хранит внешний интернет-адрес. В существующей демоверсии PreWarpAge кнопка StorePage использует такую ссылку для перехода в магазин. Ниже показано устройство этой связи. Это справочный пример: пользовательские моды в демоверсии отключены, а полной игре запись Url не добавляет произвольную кнопку.
Адрес задаётся у отдельного определения с категорией Store или Site. Используйте полный http:// или https:// адрес с именем сайта; параметры после знака вопроса сохраняются. Demo.Store у Simulation указывает, какое определение магазина читает кнопка StorePage.
["MyStore", "Is", "Store"],
["MyStore", "Url", "https://example.com/game?utm_source=demo"],
["Simulation", "Demo.Store", "MyStore"]MyStore - придуманное имя определения магазина. Пример использует условный адрес example.com с параметром utm_source. В игровых строках HTML-ссылки не поддерживаются; текст Description или события с тем же адресом не становится ссылкой автоматически.
Совместимость событий
Conflicts - взаимное исключение событий
Два события могут описывать несовместимые состояния: например, дефицит воды и её избыток. Conflicts запрещает им одновременно действовать у одного игрока. «Действует» здесь означает живое событие партии, которое ещё не завершилось или не снято.
WaterShortage - готовое событие дефицита воды, WaterAbundance - готовый избыток воды. Оба уже объявлены с ролью Event и имеют свои условия запуска. Следующая строка показывает их действующее ограничение:
["WaterShortage", "Conflicts", "WaterAbundance"]Пока у игрока жив WaterShortage, WaterAbundance не запускается, и наоборот. Записывать обратную сторону не требуется: отношение симметрично. Строка сама не разыгрывает ни одно из событий, не создаёт дефицит и не включает события в расписание.
Чтобы использовать это правило для своих событий, сначала объявите их через Is Event и подключите к запуску, например в группе Events с колодой Deck. Затем добавьте Conflicts у одного события со ссылкой на другое. Обе стороны должны быть событиями. Для несовместимости пакетов модов служит поле conflicts в modinfo.json; Conflicts у технологии или корпорации это поле не заменяет.
Полные примеры карты и ресурсной раздачи
ColdWorld и Icy - холод и состав мира
«Холодный» и «ледяной» означают разные свойства. ColdWorld описывает климат: сгенерированное тело получает эту категорию в зоне Snow или Outer. В UltraHot и Hot оно получает HotWorld, а в Habitable - ни одну из двух. Спутник использует зону своей планеты. Эти категории зависят от положения, а не от общего порога температуры в кельвинах. В авторской фиксированной системе нужную климатическую категорию задайте явно через Is.
Icy - категория состава. Готовые миры Is Icy: TinyIce, SmallIce, StandardIce, LargeIce, TinyCryogenic, SmallCryogenic, StandardCryogenic, StandardAmmonia, LargeAmmonia. Аммиачные и криогенные миры тоже Icy. Газовый IceGiantSmall или IceGiantMedium от слова Ice в имени не становится World.Icy: гиганты принадлежат Giant. Название класса само не определяет его категории.
["CorpMiner.ColdMining", "Target", "World.ColdWorld"],
["CorpMiner.ColdMining", "Adds.Production.Minerals", 0.3]Этот фрагмент добавляет CorpMiner новую часть способности ColdMining. Точка в CorpMiner.ColdMining обозначает часть определения корпорации, поэтому отдельный Has не нужен. На холодных мирах игрока-добытчика каждый рабочий будет добывать на 0.3 минерала за ход больше. Бонус действует там, где уже есть минеральный источник.
Поменяем только получателя бонуса: пусть он действует на ледяных мирах независимо от орбиты. Остальную строку способности оставляем прежней:
["CorpMiner.ColdMining", "Target", "World.Icy"],
["CorpMiner.ColdMining", "Adds.Production.Minerals", 0.3]Теперь важен ледяной состав, а не зона. Холодный каменный мир теряет этот бонус, ледяной мир вне холодной зоны получает его. Добыча всё ещё требует уже существующего источника минералов.
Ещё один вариант - убрать ограничение World и охватить холодные тела других категорий:
["CorpMiner.ColdMining", "Target", "ColdWorld"],
["CorpMiner.ColdMining", "Adds.Production.Minerals", 0.3]Условие холодной зоны сохраняется, проверка роли World исчезает. Это три альтернативных варианта одного Target: не добавляйте их вместе, если хотите проверить только один набор получателей.
Своя звезда с гарантированным родным миром
В основной игре родной мир выбирается через Spawn.Random Earthlike. Чтобы партия началась, на карте должен появиться хотя бы один землеподобный мир. Океанический StandardOcean относится к World, но не к Earthlike, поэтому вместо такого дома не подойдёт. Если в обитаемой зоне одно место, большой вес землеподобной карты лишь повышает шанс подходящего старта. Он не даёт гарантии, пока в колоде есть другой возможный исход.
Следующий пример использует ClassK с двумя местами в обитаемой зоне. Колода содержит ровно две карты: StandardEarthlike и StandardOcean. За два розыгрыша появятся оба мира, и дом будет гарантирован. Сохраните первый блок как Logic/ColdSystem.json, второй - как Text/ruRU.json. При повторении примера не меняйте число колец и веса зон: от них зависит число мест. Для своего распределения заново проверьте, что доступных мест достаточно для обязательной землеподобной карты.
[
["MyColdStar", "Is", "ClassK"],
["MyColdStar", "Name", "MyColdStarName"],
["MyColdStar", "Orbits.Habitable.Deck.StandardEarthlike", 1],
["MyColdStar", "Orbits.Habitable.Deck.StandardOcean", 1],
["MyColdStar", "Orbits.Snow.Deck.TinyIce", 1],
["MyColdSystem", "Is", "ScenarioK"],
["MyColdSystem", "Name", "MyColdSystemName"],
["MyColdSystem", "Description", "MyColdSystemDesc"],
["MyColdSystem", "Orbit.Center", "MyColdStar"],
["MyColdSystem", "Order", 12]
]{
"MyColdStarName": "Ледяная колыбель",
"MyColdSystemName": "Ледяные соседи",
"MyColdSystemDesc": "Землеподобный дом, океанический сосед и ледяные миры снежной зоны."
}Включите мод и выберите «Ледяные соседи» при создании новой партии. MyColdStar наследует изображение и генерацию ClassK. Его собственные колоды заменяют соответствующие колоды предка целиком: Habitable выдаёт землеподобный и океанический миры, Snow - только TinyIce. Остальные зоны и начальные запасы ScenarioK сохраняются. Проверьте, что родной мир землеподобный, рядом есть океанический, а в снежной зоне - ледяные тела. Их добываемый ресурс и производство одним рабочим разыгрываются отдельно; ледяной состав не гарантирует источник воды.
Фиксированная система и граница Plane
Теперь зададим расположение тел вручную, без случайных колод зон. Выполняйте этот пример в отдельном моде: пока он включён, Player Spawn меняет выбор дома для всех сценариев. Используйте с ним только «Мою систему». Сценарий получит свою звезду, землеподобный дом и ледяной источник воды. Сохраните первый блок как Logic/FixedSystem.json, второй - как Text/ruRU.json. Orbit.Center у сценария связывает его с авторской звездой, а Player Spawn выбирает конкретный дом вместо случайного.
[
["MyFixedSystem", "Is", "ScenarioG"],
["MyFixedSystem", "Name", "MyFixedSystemName"],
["MyFixedSystem", "Description", "MyFixedSystemDesc"],
["MyFixedSystem", "Orbit.Center", "MyFixedSun"],
["MyFixedSystem", "Order", 13],
["MyFixedSun", "Is", "Star"],
["MyFixedSun", "Type", "MyFixedSun"],
["MyFixedSun", "Name", "MyFixedSunName"],
["MyFixedSun", "Icon", "star_yellow00"],
["MyFixedSun", "Orbits", 3],
["MyFixedSun", "Production.Energy", 1],
["MyFixedHome", "Is", "StandardEarthlike"],
["MyFixedHome", "Name", "MyFixedHomeName"],
["MyFixedHome", "Orbit.Center", "MyFixedSun"],
["MyFixedHome", "Orbit", 1],
["MyFixedHome", "Explored", true],
["MyFixedIce", "Is", "TinyIce"],
["MyFixedIce", "Is", "ColdWorld"],
["MyFixedIce", "Name", "MyFixedIceName"],
["MyFixedIce", "Orbit.Center", "MyFixedSun"],
["MyFixedIce", "Orbit", 2],
["MyFixedIce", "Production.Water", 2],
["Player", "Spawn", "MyFixedHome"]
]{
"MyFixedSystemName": "Моя система",
"MyFixedSystemDesc": "Авторский дом и ледяной источник воды.",
"MyFixedSunName": "Моя звезда",
"MyFixedSun": "Авторская звезда",
"MyFixedHomeName": "Наш дом",
"MyFixedIceName": "Ледяной сосед"
}Включите мод и выберите сценарий «Моя система» для новой партии. На первом кольце будет «Наш дом», на втором - «Ледяной сосед». Их Orbit.Center задан явно: эта связь не наследуется. Начальные запасы берутся у ScenarioG. Production.Water 2 означает добычу двух единиц воды одним рабочим за ход, а не две единицы на складе игрока. Карта показывает принцип размещения и не рассчитана на полное прохождение: для этого нужны остальные источники и проверка баланса.
Если выбрать другой сценарий, у которого MyFixedHome не создаётся, партия не получит указанный дом. Перед возвращением к обычным сценариям отключите этот мод.
Замена Orbit.Center этого сценария на Plane.Cols и Plane.Rows не создаёт прямоугольную версию той же партии. Звезда и дом могут оказаться в отдельных сетках вне текущей карты. Для такого сочетания в PreWarpAge пока нет законченного рецепта. Показанная система с явным центром работает как самостоятельный авторский сценарий; Plane здесь остаётся справкой о другой геометрии.
Новый добываемый ресурс и отложенная разведка
Добавим криоруду и два вида ледяных миров, где её можно добывать. CryoOre и все имена с My придуманы для этого примера. Сначала разберём три настройки раздачи, затем соберём готовый сценарий. Объявление самого ресурса и запас игрока используют уже разобранные Is Resource, Is Stat и Player Has.
Первая задача - разрешить в общей раздаче выбор ресурса. Для этого заведём колоду MyOreDeck с одной картой Resource:
["MyOreDeck", "Deck.Resource", 1]Resource здесь означает «выбрать один допустимый для тела ресурс». Карта ещё не назначает криоруду и не устанавливает добычу. Единица - количество таких карт в колоде.
Вторая задача - включить ледяной мир MyOreIceA в эту раздачу и разрешить ему криоруду:
["MyOreIceA", "Deck.CryoOre", "MyOreDeck"]MyOreIceA связан с общей колодой через криоруду. Пока это только допустимый вид ресурса: сколько добывает один рабочий, мы ещё не задали. Is Predicate для CryoOre не нужен - имя используется внутри конструкции Deck, а не как новое самостоятельное поле.
Третья задача - дать этому ресурсу одну возможную отдачу 2,1 единицы за ход на рабочего:
["MyOreIceA", "Deck.CryoOre.2.1", 1]Внутри Deck.CryoOre.2.1 число 2.1 - одна десятичная отдача, а не путь «2, затем 1». Последняя единица - количество карт с этой отдачей. Отдача должна быть положительной; количество карт - целым неотрицательным числом. Эта карта не начисляет 2,1 единицы в запас: она задаёт возможное производство после разведки и назначения рабочего.
Добавим второй возможный результат той же добычи:
["MyOreIceA", "Deck.CryoOre.2.1", 1],
["MyOreIceA", "Deck.CryoOre.3.1", 1]Теперь для криоруды есть две карты с одинаковым весом: рабочий будет добывать либо 2,1, либо 3,1 единицы. Значения не складываются. Для другого ресурса нужна отдельная связь и его собственная числовая колода:
["MyOreIceB", "Deck.Minerals", "MyOreDeck"],
["MyOreIceB", "Deck.Minerals.0.9", 1],
["MyOreIceB", "Deck.Minerals.1.5", 1]MyOreIceB допускает минералы с отдачей 0,9 или 1,5. В полном примере он допускает также криоруду: обе возможности будут показаны при разведке. Чтобы игрок мог выбрать новый ресурс, добавим ответ в уже существующее окно «Фокус работы». Сначала объявим вариант ответа и укажем его ресурс:
["FocusCryoOre", "Is", "EventChoice"],
["FocusCryoOre", "Resource", "CryoOre"]Resource у ответа означает «выбрать криоруду для добычи». Это не разовая выдача криоруды в запас игрока. Пока не указан мир, ответу некуда записать результат.
Зададим адресата ответа. Parent - окно, которое содержит выбранный ответ; Target этого окна - разведанный мир:
["FocusCryoOre", "Resource.Target", "Parent.Target"]Путь читается так: ответ FocusCryoOre → его родительское окно WorkFocus → разведанный мир в Target окна. Именно на мире закрепится добыча CryoOre с предварительно разыгранной отдачей. Сам ответ и окно не превращаются в месторождение. Parent без .Target привёл бы к окну, поэтому его здесь не используйте.
Остаётся включить ответ в состав окна:
["WorkFocus", "Has", "FocusCryoOre"]Теперь при разведке мира, допускающего криоруду, WorkFocus может предложить этот ответ. На MyOreIceB выбор «Криоруда» закрепит Production.CryoOre; выбор минералов закрепит Production.Minerals. Выбирается один ресурс, а не сумма обоих. Замена Resource CryoOre на Minerals сделала бы этот ответ выбором минералов при том же пути к миру. Для собственного окна нельзя механически переносить Parent.Target: оно должно действительно хранить разведанный мир в Target.
Все части теперь разобраны. Сохраните следующий полный блок как Logic/CryoOre.json, а его словарь - как Text/ruRU.json. Он соединяет ресурс, его запас, ледяные миры с колодами, ответ окна и новый сценарий.
[
["CryoOre", "Is", "Resource"],
["CryoOre", "Is", "Stat"],
["CryoOre", "Name", "CryoOreName"],
["CryoOre", "Icon", "ore_iron"],
["CryoOre", "Count", 0],
["CryoOre", "Price", 2],
["Player", "Has", "CryoOre"],
["MyOreDeck", "Deck.Resource", 1],
["MyOreIceA", "Is", "World"],
["MyOreIceA", "Is", "Icy"],
["MyOreIceA", "Name", "MyOreIceAName"],
["MyOreIceA", "Size", 3],
["MyOreIceA", "Icon", "ice"],
["MyOreIceA", "Deck.CryoOre", "MyOreDeck"],
["MyOreIceA", "Deck.CryoOre.2.1", 1],
["MyOreIceA", "Deck.CryoOre.3.1", 1],
["MyOreIceB", "Is", "World"],
["MyOreIceB", "Is", "Icy"],
["MyOreIceB", "Name", "MyOreIceBName"],
["MyOreIceB", "Size", 4],
["MyOreIceB", "Icon", "ice"],
["MyOreIceB", "Deck.CryoOre", "MyOreDeck"],
["MyOreIceB", "Deck.CryoOre.1.2", 1],
["MyOreIceB", "Deck.CryoOre.2.4", 1],
["MyOreIceB", "Deck.Minerals", "MyOreDeck"],
["MyOreIceB", "Deck.Minerals.0.9", 1],
["MyOreIceB", "Deck.Minerals.1.5", 1],
["FocusCryoOre", "Is", "EventChoice"],
["FocusCryoOre", "Name", "CryoOreName"],
["FocusCryoOre", "Icon", "ore_iron"],
["FocusCryoOre", "Resource", "CryoOre"],
["FocusCryoOre", "Resource.Target", "Parent.Target"],
["WorkFocus", "Has", "FocusCryoOre"],
["MyOreStar", "Is", "ClassK"],
["MyOreStar", "Orbits.Snow.Deck.MyOreIceA", 1],
["MyOreStar", "Orbits.Snow.Deck.MyOreIceB", 1],
["MyOreSystem", "Is", "ScenarioK"],
["MyOreSystem", "Name", "MyOreSystemName"],
["MyOreSystem", "Description", "MyOreSystemDesc"],
["MyOreSystem", "Orbit.Center", "MyOreStar"],
["MyOreSystem", "Order", 14]
]{
"CryoOreName": "Криоруда",
"MyOreIceAName": "Криорудный мир",
"MyOreIceBName": "Мир с выбором добычи",
"MyOreSystemName": "Криорудная система",
"MyOreSystemDesc": "Два типа ледяных миров с месторождениями криоруды."
}Включите мод и начните новую партию со сценарием «Криорудная система». В снежной зоне появятся «Криорудный мир» (MyOreIceA) и «Мир с выбором добычи» (MyOreIceB). Первый допускает только криоруду, второй - криоруду или минералы. Их определения наследуют World и Icy напрямую, чтобы не получить ресурсные колоды TinyIce. Связи Deck.CryoOre и Deck.Minerals с MyOreDeck включают тела в общую раздачу. Звезда наследует ClassK, поэтому подходящий родной мир сохраняется.
Сначала игра составляет предварительный план раздачи между ещё не раскрытыми телами. В этом примере план назначает карту Resource - возможность выбрать допустимый ресурс. Он ещё не записывает окончательное Production.CryoOre или Production.Minerals. Explored.Plan и Explored.Remainder хранят план и остаток раздачи; эти поля заполняет игра.
Разведайте «Мир с выбором добычи». Откроется окно «Фокус работы» (WorkFocus) с минералами и новым вариантом «Криоруда». К моменту показа для каждого допустимого ресурса уже разыграна и сохранена своя числовая отдача. Пока вы не ответили, окончательного добываемого ресурса у тела нет. Выбор записывает только один Production - выбранного ресурса, с показанной в окне отдачей. Повторное открытие тела этот результат не меняет. У «Криорудного мира» вариант один, поэтому результат записывается сразу без окна.
При автоматическом раскрытии на старте игра сама выбирает наибольшую разыгранную отдачу и не ждёт ответа. После разведки назначьте рабочих ползунком. Is Resource, Is Stat и Player Has создают у игрока запас криоруды и её показатель; Price разрешает торговлю этим ресурсом.
Разведка сохраняет обычную стоимость Explore и дальность снежной зоны. Стартовых минералов может хватить только на одно из этих тел; второе исследуйте после накопления нужной суммы. Пример не делает дальнюю разведку бесплатной и не выдаёт скрытого тестового запаса. Для проверки производства после раскрытия назначьте работников: при отдачах 2.1 и 2.4 один работник на каждом теле даёт вместе 4.5 единицы криоруды за ход. Конкретная пара чисел зависит от раздачи.
Превращение миров, урон и вспомогательные возможности
Новый распространяющийся мир
Для цепного заражения используйте полный пример в статье «Spread и Spreads - распространение превращения». Для однократной замены мира - статью «Transforms - превращение тела».
Где Damage действительно наносит урон
Чтобы изменить обстрел астероида, откройте статью «Health и Damage - прочность и урон». В ней разобраны Bombard, Damage.Target и отличие обстрела от столкновения.
Когда работают Enabled и Url
Для состояния микрофона используйте статью «Enabled - состояние переключателя». Для устройства ссылки на магазин - статью «Url - внешний адрес»; там указано ограничение демоверсии.
Состояние игрока и границы доступного контента
В партии есть сам игрок, его подключение и текущее выделение. Эти вещи не нужно создавать вручную в моде. Ниже справочно перечислены роли и служебные поля, которые можно встретить при чтении состояния; они не являются рецептом нового сетевого режима.
Player обозначает игрока, Human - человека, AI - искусственного игрока. Players у Simulation задаёт число создаваемых игроков целым неотрицательным числом. Общая палитра рассчитана не более чем на восемь сгенерированных вариантов. Однако сама PreWarpAge предназначена для одного человека. Is AI не добавляет ей соперника со стратегией или сетевую игру; обычному моду не требуется менять число игроков.
Seat.<идентификатор> связывает подключение с игроком. Selected.<идентификатор> хранит текущее выделение этого подключения. Started сообщает, что партия уже начата. Эти поля записывает игра. Не переносите их из сохранения в мод: Started не создаёт мир, Selected не определяет доступность кнопки, а Seat не заменяет проверку права выполнить действие.
World - мир, Rocky - каменный состав, Icy - ледяной, Giant - гигант, Star - звезда, Satellite - спутник. SurfaceBuilding означает постройку на поверхности, Orbital - орбитальную. Unique - предметный признак уникальности, Store и Site - описательные категории ссылок. Не каждому слову после Is соответствует отдельный одноимённый предикат. Новая категория помогает классифицировать данные; произвольная роль не получает готового поведения только от своего названия.
11. Замечания и пожелания
Нашли неточность, непонятное объяснение или хотите предложить улучшение? Напишите в поддержку: support@clarusvictoria.com. Укажите версию игры и раздел руководства, о котором идёт речь. Если пример работает иначе, приложите файл мода и опишите, что получилось.
