Elfrey Scene Browser

Коротко

Elfrey Scene Browser — модуль для Foundry VTT, который показывает все сцены сразу: из включённых и выключенных модулей, из паков-приключений, из паков системы, из компендиумов мира и из самого мира. Дерево источников, поиск, фильтры, превью и импорт в один клик.

Поддерживаются Foundry VTT v13 и v14 (не без проблем).

Что умеет

Все сцены сразу. Сцены мира и паки включённых модулей читаются вживую. Сцены выключенных модулей модуль читает сам, прямо из файлов библиотек, и складывает в кэш.
Сцены из приключений. Многие модули упаковывают карты не отдельным Scene-паком, а внутрь документа Adventure. Такие сцены тоже видны: узел «модуль → приключение → папки → сцены».
Дерево источников и поиск. Структура «источник → пакет → папки → сцены». Поиск по названию, паку и пакету с автоматическим раскрытием нужных веток. Множественный выбор узлов: обычный клик — только выбранный источник, Ctrl/Cmd-клик — добавить к выбору.
Фильтры и сортировка. По статусу источника, типу сетки, размеру в клетках, содержимому (стены / токены / освещение / заметки) и системе. Сортировка по имени, пакету, размеру, дате и числу стен.
Карточки с превью. Миниатюра сцены, а если её нет — фон сцены. Размеры в пикселях и клетках, счётчики объектов.
Импорт в один клик. «Импортировать» и «импортировать и открыть», показать сцену в компендиуме, открыть изображение, скопировать UUID/путь, перетаскивание в сайдбар.
Аккуратные папки при импорте. Импорт создаёт вложенные папки «модуль → приключение → внутренняя папка», чтобы всё раскладывалось по местам.
Импорт без включения модуля. Сцену выключенного модуля можно импортировать, не активируя его — у браузера есть её полный JSON.

Установка

В Foundry: Add-on Modules → Install Module и вставьте ссылку на манифест:

https://github.com/Elfrey/elfrey-scene-browser/releases/latest/download/module.json

Затем включите модуль в мире — и жмите «Браузер сцен».

Как пользоваться

Откройте вкладку «Сцены» или «Компендиумы» и нажмите кнопку «Браузер сцен».
При первом запуске нажмите «Индексировать» — модуль прочитает библиотеки выключенных модулей и соберёт каталог (на v13; про v14 — отдельно ниже).
Пользуйтесь деревом, поиском и фильтрами, чтобы найти нужную карту.
Наведитесь на карточку, чтобы увидеть превью и параметры; нажмите «Импортировать» (или «импортировать и открыть»).

Особенности Foundry v14

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

Способ 1. Кнопка «Из модулей» (прямо в браузере). Самый простой путь, скрипт не нужен. В окне браузера нажмите «Из модулей» (кнопка только на v14) — она покажет установленные модули со сценами (есть «Выделить все» / «Снять все»). Включённые модули индексируются сразу, выключенные модуль временно включает, индексирует и выключает обратно (с двумя перезагрузками мира и окном ожидания с прогрессом). Лучше делайте это на пустом/служебном мире — это достаточно долгий и тяжелый процесс.

Способ 2. Скрипт (без запуска Foundry). Если включать модули в мире не хочется, соберите каталог отдельным скриптом — он читает паки прямо из файлов:

node tools/build-cache.mjs --data /путь/к/папке-данных-foundry --full-scenes

После сборки нажмите в браузере «Обновить».

Комментарии, ошибки и пожелания как обычно пишите либо в issues на github, в комментарии к посту или в личку на boosty или в дискорде