Roll20 Fallout Translator — это пользовательский скрипт (UserScript), который автоматически переводит интерфейс листа персонажа Fallout в платформе Roll20 на русский язык.
Скрипт переведёт как статичные, так и динамически создаваемые тексты, а также исправит стили, съехавшие после перевода.
- Функции
- Установка
- Локальная сборка
- Структура проекта
- Локализация
- Шрифт и фикс вёрстки
- Участие в разработке
- Лицензия
- ✨ Полный перевод листа персонажа на русский.
- 🔄 Перехват динамических изменений (новые поля, вкладки и т. д.) через
MutationObserver
. - 🖋 Замена оригинального шрифта Sriracha (в нём не было кириллицы) на Sriracha Cyrillic.
- 🩹 Исправление визуальных багов в листе персонажа после перевода.
- ⚡ Установка в один клик с автoобновлением
- 📁 Сборка в один минифицированный файл для быстрой загрузки
-
Установите расширение Tampermonkey (или его аналог) в браузер.
-
Нажмите на кнопку Установить.
-
Расширение предложит установить userscript.
-
Перейдите в вашу игру Fallout на Roll20 ⇒ обновите страницу.
-
Готово! Все лист персонажа отображаются на русском.
# Клонируем репозиторий
git clone https://github.com/USERNAME/roll20-fallout-translator.git
cd roll20-fallout-translator
# Устанавливаем зависимости
npm ci
# Собираем userscript в папку dist/
npm run build
После сборки финальный файл находится по пути:
dist/roll20-fallout-translator.user.js
roll20-fallout-translator/
├── assets/
│ ├── translation.json # Файл с переводами
│ ├── translation.css # Файл с переводами стилей
│ ├── layout-fix.css # Исправит стили после перевода
│ ├── font.css # @font-face для Sriracha Cyrillic
│ └── icon.svg # Иконка проекта
├── src/
│ ├── index.js # Точка входа
│ ├── translator.js # Логика перевода + наблюдение за DOM
│ └── css-utils.js # Инжекция CSS, замена шрифта
├── dist/
│ └── roll20-fallout-translator.user.js
├── build.js # Скрипт сборки
└── userscript.meta.js # Метаданные для userscript
Словарь переводов хранится в файле assets/translation.json. Чтобы добавить или исправить перевод:
- Откройте assets/translation.json.
- Добавьте новую пару ключ–значение: оригинальный текст → перевод.
- Пересоберите скрипт: npm run build.
Оригинальный лист использует шрифт Sriracha, в котором отсутствует кириллица.
Заменил его на Sriracha Cyrillic.
Из‑за длины текста и другой метрики шрифта некоторые поля «уехали» — это исправляет assets/layout-fix.css
.
Если заметите ошибки, опечатки и не переведенный текст, прошу писать в issues.
Для всех, кто заинтересован в внесении вклада в проекта, пожалуйста, создайте форк проекта и отправьте пул-реквест.
Этот проект лицензирован по лицензии MIT. Подробности см. в файле LICENSE.
Этот проект разработан как неофициальный инструмент, созданный сообществом, и предоставляется "как есть", без каких-либо гарантий. Автор не несёт ответственности за возможные последствия использования скрипта.
- Fallout является зарегистрированной торговой маркой Bethesda Softworks LLC.
- Лист персонажа и связанные материалы разработаны и принадлежат Modiphius Entertainment.
- Roll20 является торговой маркой компании Roll20, LLC.
Все упомянутые товарные знаки и авторские права принадлежат их соответствующим владельцам. Данный скрипт не одобрен, не аффилирован и не поддерживается Bethesda, Modiphius или Roll20. Используется исключительно в некоммерческих, образовательных или фанатских целях.
© 2025 Yuliy Mitryashkin