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
После сборки нажмите в браузере «Обновить».
