Произвольные форматы дат

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

Когда это нужно

Стандартные поля дат привязаны к реальному календарю. Если ваша игра происходит в Тедасе, Забытых Королевствах или Вестеросе, реальные даты ничего не значат. Поле произвольной даты позволяет один раз задать структуру игрового календаря; после этого игроки вводят нужные значения, и платформа форматирует и сохраняет дату правильно, включая сортировку.

Поле произвольной даты можно добавить к заголовкам эпизодов, анкетам персонажей, профилям персонажей или объявлениям о разыскиваемых персонажах через Админ → Шаблоны.

Создание календаря

Перейдите в Админ → Календари и нажмите Новый календарь. Дайте ему понятное название — игроки увидят это имя, когда будут выбирать нужный формат.

Календарь состоит из двух частей: единицы времени (плейсхолдеры) и строки формата (шаблоны, по которым они собираются в читаемую дату).

Единицы времени

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

Число — игрок вводит целое число. Задайте минимум и максимум, чтобы ограничить допустимый диапазон. Допускаются отрицательные значения; установите минимум ниже нуля для эр, которые идут «в обратном» направлении. Включите Скрыть знак минуса, если игрок должен вводить положительное число, которое внутренне хранится как отрицательное — это удобно для дат «до завоевания», когда пользователь пишет 100, а система записывает -100.

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

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

Строки формата

Строка формата — это шаблон, который собирает единицы времени в читаемую дату. Вписывайте произвольный текст и вставляйте теги плейсхолдеров нажатием кнопок единиц под полем ввода (или вручную в формате {название_единицы}).

Например, при единицах с именами year, month и day строка формата может выглядеть так:

{month} {day}, {year}

Результат: March 15, 870.

Каждый обязательный плейсхолдер должен присутствовать в каждой строке формата. Необязательные плейсхолдеры могут отсутствовать в некоторых вариантах.

Несколько строк формата: пример Dragon Age

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

Календарь Dragon Age на живой игре на платформе содержит шесть единиц времени и четыре строки формата, потому что в Тедасе используются две разные системы летосчисления:

Древние годы — даты до начала Эпох записываются как убывающий порядковый номер, например -200 Древних. Для них используется плейсхолдер ancient_year (число от -9999 до -1).

Даты в формате Эпоха:Год — современный календарь считает годы внутри именованных Эпох. Девятая Эпоха — Эпоха Дракона; её 41-й год записывается как 9:41 Дракона. Для этого нужны три отдельные единицы: age_number (1–9), year (0–99) и age_name (список: Божественная, Слава, Башен, Чёрная, Возвышенная, Стальная, Буря, Благословенная, Дракона).

Поскольку эти две эры структурно несовместимы, календарь определяет четыре строки формата — по две на каждую эру: с днём и без него (не каждая дата в рассказе требует точности до дня):

Строка формата Пример результата
{ancient_year} Древних, {day} из {month_and_holidays} -200 Древних, 15 из Зимнего Марша (Verimensis)
{ancient_year} Древних, {month_and_holidays} -200 Древних, Зимний Марш (Verimensis)
{age_number}:{year} {age_name}, {day} из {month_and_holidays} 9:41 Дракона, 15 из Дракониса (Nubulis)
{age_number}:{year} {age_name}, {month_and_holidays} 9:41 Дракона, Дракониc (Nubulis)

Обратите внимание: month_and_holidays — единый список, содержащий как названия обычных месяцев, так и особых праздников (Конец Зимы, День Лета, Сатиналия и др.) — потому что в календаре Dragon Age праздники занимают ту же позицию в году, что и месяцы, и структурно не отличаются от них.

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

Привязка календаря к фракции

Каждой фракции можно назначить один формат календаря. Перейдите в Админ → Фракции, откройте фракцию и задайте поле Календарь. Несколько фракций могут использовать один и тот же календарь.

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

Глобальный календарь по умолчанию

Если в игре есть «общий» календарь для персонажей, чьи фракции не имеют назначенного формата, или если вы хотите, чтобы один календарь был доступен всегда независимо от выбора персонажей — перейдите в Админ → Настройки и задайте Глобальный календарь.

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

Сортировка

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

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

Сортировка основана на значениях плейсхолдеров в порядке их позиций: плейсхолдер с позицией 0 является старшим (например, год), а более поздние позиции — младшими. Настройте единицы времени соответствующим образом, если хронологическая сортировка важна для вашей игры.