Создатель модуля
Примеры: лоток для кубиков и док-станция действий
Сравните действующую среду выполнения хоста, интерактивный предварительный просмотр контракта и типичные экспонаты хоста в лаборатории модулей.
Dice Tray: бетонный каркас и среда выполнения хоста
Структура CLI — это конкретный пакет Dice & Chat. Собственный Dice Tray в Fabled использует ту же модель: цель учетной записи предоставляет панель композитора чата и глобальную команду, запрашивает dice.roll.self, опционально запрашиваетchat.post.self и указывает на проверенные активы действия/фрейма/локали.
- Пакет предоставляет выражение кубика, выбор видимости, кнопки кубика, предустановки и локализованные метки.
- Средство рендеринга fabled.dice-tray.v1 из белого списка принадлежит Fabled; модуль не предоставляет произвольный пользовательский интерфейс React.
- Организатор проверяет точный дескриптор действия, выполняет собственный ролл, владеет результатом и 3D-презентацией и применяет правила аудитории.
- Module Lab знакомит с находящимся в разработке каноническим приспособлением Dice Tray, включенным в репозиторий Fabled. Он не может загрузить произвольный путь проекта или установить, активировать, утвердить или опубликовать пакет.
Action Dock: интерактивный предварительный просмотр контракта
Пакет fabled-labs.token-action-hud нацелен на vtt и просматривает компактное наложение выбора для управляемого токена. Он вносит настройку компактного режима userCampaign и использует проверенные дескрипторы Action Dock, которые остаются инертными, как и другие ресурсы, до тех пор, пока не будет принят производственный контракт средства визуализации VTT.
| Возможность | Почему предварительный просмотр запрашивает это | Согласие |
|---|---|---|
| токены.чтение.контролируется | Прочтите безопасное представление токена, контролируемого пользователем. | кампания и пользователь |
| framework.invoke.controller | Вызов проверенного действия с контролируемым токеном | кампания и пользователь |
| event.observe.declared | Наблюдайте за объявленным выбором и изменениями состояния хода. | кампания |
| dice.roll.self (необязательно) | Сделайте проверку для проверенного действия, когда пользователь его вызывает | пользователь |
Предварительный просмотр демонстрирует контекст с фильтрацией разрешений, отклонение устаревшего состояния, идемпотентную отправку команд, локализацию и настройки области действия, в то время как Fabled сохраняет полномочия действий. Действительный по схеме манифест — это только граница пакета; недоступный контракт с продукционным рендерером по-прежнему запрещает доступ за пределы лаборатории.
Приветственная команда и список персонажей: экспонаты-хозяева
Модуль «Лаборатория» также включает в себя две репрезентативные выставки, а не полные демонстрационные версии. Команда приветствия отражает модуль кампании, управляемый владельцем, чья команда Spotlight выдает обычный результат чата и исчезает после отключения. Таблица символов отражает вклад, проверяемый только маркерами, в канонический FramePreview Fabled, с отказом VIEW и демонтажем в безопасном режиме, сохраняя данные персонажей внутри хоста.
Эффекты заклинаний: кандидат CLI из исходного кода
npm run modules:cli -- module init arcane-arsenal --template spell-effects --publisher-id my-studio --publisher-name "My Studio"Шаблон включает шесть примеров: arcane_bolt, dragon_fire, frost_breath, toxic_breath, sword_swing и melee_hit. Хост соответствующей версии исходного кода принимает всего 12 пресетов, включая lightning_arc, meteor_strike, frost_nova, void_vortex, radiant_sigil и thorn_burst. Рецепты задают фиксированные цвета, интенсивность и длительность 300–2200 ms через тот же контракт fabled.vtt-effect.v1 с семью ключами. Они предоставляют только визуальные эффекты: без произвольных шейдеров, слоёв, урона, лечения, затрат ресурсов и импортированных правил заклинаний.
После проверки и установки точного выпуска владелец кампании активирует модуль в разделе «Кампания → Модули». В VTT ведущий с соответствующими правами выбирает инструментом целей 1–8 существующих токенов, открывает контекстное меню другого исходного токена, раскрывает Arcane Arsenal и выбирает рецепт. Fabled проверяет запуск и рассылает подтверждённый эффект. Отключение удаляет меню и блокирует новые запуски; уже разрешённые эффекты заканчиваются в течение 2200 ms.
Шаблон многократного использования
- Объявите намерение в манифесте и точных ресурсах JSON.
- Запросите минимальные возможности и области согласия.
- Позвольте Fabled владеть средствами рендеринга, контекстной фильтрацией, авторитетными мутациями и результатами.
- Проверьте и проверьте локально, затем отправьте неизменяемые доказательства на проверку.
- Ожидайте отключения, замены, отзыва и безопасного режима, чтобы аккуратно удалить вклады.