PumpkinQuest

Гайд по редактору

Как устроен редактор датасетов и как собрать в нём свой хоумбрю-контент — от одной черты до целой книги правил.

Что такое датасет

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

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

Из чего он состоит

Датасет
Файл, который объединяет всё, что вы создали — как книга правил. Именно его вы скачиваете и подключаете в LSS.
Сущность
Одна конкретная штука внутри датасета: раса («Двемер»), черта («Меткий стрелок»), класс, предыстория. У каждой сущности есть имя, описание и набор эффектов.
Грант
Один эффект, который даёт сущность: +2 к силе, владение мечами, счётчик ярости, текст способности. Один грант — одно действие. Чтобы собрать сущность, вы просто добавляете ей нужные гранты один за другим.

Как создать датасет — шаг за шагом

  1. Создайте датасет и дайте ему название — это просто новый пустой файл, в который вы будете добавлять контент.
  2. Добавьте сущности, которые вам нужны: расу, класс, черту или предысторию. Можно добавить одну — если вам нужна только одна черта для одного персонажа, этого достаточно.
  3. Откройте сущность и наполните её грантами через кнопку «Добавить грант»: бонус к характеристике, владение, счётчик использований, текст способности — по одному эффекту за раз. Если грант нужно выдать на определённом уровне, нажмите «Добавить уровень» и добавляйте гранты внутри этого уровня.
  4. Следите за подсказками редактора. Если что-то настроено так, что не попадёт на лист, редактор подсветит это красным или жёлтым прямо рядом с полем.
  5. Экспортируйте датасет JSON-файлом и подключите его в LSS на странице персонажа — эффекты появятся на листе автоматически.
Данные редактора датасетов хранятся у вас в браузере, а не на сервере. Пока вы не выгрузили файл, всё живёт только на вашем компьютере — сохраняйте JSON почаще, это единственная страховка от потери при случайной очистке кэша.

Нюансы и особые случаи

Это не обязательно к прочтению заранее — загляните сюда, если что-то на листе персонажа выглядит не так, как вы ожидали.

Описание способности и числа в одном trait не дружат

У гранта типа trait есть поле params — числа, которые едут по числовому каналу (дистанция тёмного зрения, урон ауры), и поле description — текст, который едет по текстовому.

Если у trait есть и params, и description — текстовый канал его отфильтрует. Описание на лист не попадёт.

Способность «Аура защиты: +2 к спасброскам» с описанием «Союзники в радиусе 10 футов получают бонус...» потеряет описание. Нужно разделить на два гранта: trait с params (числовой) и trait без params (текстовый).
Единственное исключение — чувства (darkvision, blindsight). У них params и описание живут вместе в особом блоке «Чувства» на листе. Редактор сам создаёт правильный trait через пресет «Чувство: тёмное зрение».
Число или формула — это одно и то же поле

У бонусов и счётчиков есть поле-формула (expr у гранта bonus, maxExpr у resource). Отдельного поля для «просто числа» нет — если нужен фиксированный бонус +2 или потолок счётчика 3, впишите туда просто 2 или 3: число — это тоже валидная формула.

Настоящая формула нужна только когда значение зависит от уровня или характеристики, например [PROF] или 2*[PROF].

Счётчик способности нужно привязать к ней

Грант resource создаёт счётчик использований. Он должен стоять рядом с описанием способности — иначе на листе счётчик повиснет в общей куче, оторванный от текста.

Связка работает через id: у trait и у resource один и тот же id, тогда лист ставит их рядом. Если описания нет (счётчик самодостаточен) — поставьте pairId: null, чтобы линт не ругался.

Когда добавляете ресурс через пикер «Добавить грант», редактор подхватывает id от единственной trait-способности сущности автоматически. Если способностей несколько — выберите нужную в форме.
Класс не механизируется на 100% — и это нормально

Класс механизируется частично. Кость хитов, спасброски, заклинания, счётчики способностей — да. Но кости урона атак, нечисловые правила («раз в ход», «если цель на 20 футов ниже») и таблицы типа «количество ячеек на уровне» уезжают прозой в описание trait.

Это не недоработка редактора, а сознательное ограничение формата LSS: автолист умеет собирать числа, но не умеет собирать правила. Текст, который нельзя выразить грантом, пишите в описании способности (trait с description) — игрок прочитает его в спойлере на листе.

Помогите улучшить этот гайд

Здесь не хватает раздела с частыми вопросами. Вы можете помочь, задавая эти вопросы. Хороший вопрос звучит конкретно: «Как добавить способность так, чтобы она выдавалась на определённом уровне?». Задать вопросы можно в соцсетях LSS: Discord, Telegram, ВК.