Jump to content

x [Mod]XCL Translator

Heyvanushi

By Heyvanushi,
in X-Change Life

Recommended Posts

Heyvanushi

Heyvanushi

Posted
Posted
XCL Translator

View File

XCL Translator

XCL Translator Launcher v1.0
The all‑new desktop launcher for X‑Change Life translation

❓ What is it?
This is a complete rewrite of the old translation mod. Instead of just a userscript, it’s now a standalone Windows application that:

- Runs a translation server (Google Translate) in the background.
- Provides a modern GUI to control everything.
- Automatically translates game text via a lightweight userscript.

✨ What’s new in v1.0 (compared to old v6.0 mod)

  • Brand‑new desktop launcher – no need to run the server manually.
  • Google Translate backend – fast, reliable, always online.
  • Custom dictionaries – add your own translations for specific terms (character names, locations, etc.).
  • Built‑in game launcher – open your local game file (HTML or EXE) directly from the app.
  • Live logs – monitor server activity in real time.
  • Integrated wiki – access documentation without leaving the app.
  • Changelog viewer – see what’s new in each version.
  • Discord button – quick invite to the community.
  • Custom window controls – minimize, maximize, close, drag to move.

⬇️ Download

  • Launcher installer:GitHub Releases (XCL_Translator_Launcher_Setup.exe)
  • Client script (for browser): attached to this post (xcl-client.user.js)

📦 Installation

1. Install the launcher

  1. Download the installer from GitHub and run it.
  2. Follow the installation wizard (choose destination folder, create shortcuts).
  3. Launch the app from your desktop shortcut.

2. Install the client script

  1. Install a userscript manager like Tampermonkey or Violentmonkey in your browser.
  2. Download the attached xcl-client.user.js file – Tampermonkey will offer to install it.
  3. Click “Install”.

3. Start translating

  1. Keep the launcher running (you can minimise it to tray).
  2. Open X‑Change Life in your browser – the script will connect to the launcher and translate automatically.

🎮 How to use

  • Change language: In the “Translate” tab select your target language and click “Apply”. The game will update within seconds.
  • Add custom terms: In the “Dictionaries” tab enter an English term and its translations for any supported language, then click “Add”.
  • Launch the game: In the “Game” tab browse for your local game file (HTML or EXE) and click “Launch”.
  • Explore: Use the “Mods”, “Wiki”, “Changelog” and “Logs” tabs for more features.

❗ Important notes

  • The old OCR image translation and local LibreTranslate engine are temporarily removed in this version. They may return in future updates.
  • An internet connection is required for Google Translate.
  • The launcher must be running while you play.

💖 Support the project
If you enjoy this tool and want to support its development, you can donate via Boosty:https://boosty.to/heyvanushi

📋 System requirements

  • Windows 7/8/10/11 (64‑bit)
  • Browser with userscript support (Chrome, Firefox, Edge, Opera)
  • Internet connection (for Google Translate)

X‑Change Life is developed by NoStage. This launcher is a community project by Heyvanushi.



 

XCL Translator Launcher v1.0
Совершенно новый десктопный лаунчер для перевода X‑Change Life

❓ Что это?
Это полная переработка старого мода перевода. Теперь это не просто юзерскрипт, а отдельное приложение для Windows, которое:

- Запускает сервер перевода (Google Translate) в фоне.
- Предоставляет современный графический интерфейс для управления.
- Автоматически переводит текст в игре через лёгкий юзерскрипт.

✨ Что нового в v1.0 (по сравнению со старым модом v6.0)

  • Полностью новый десктопный лаунчер – не нужно запускать сервер вручную.
  • Бэкенд Google Translate – быстро, надёжно, всегда онлайн.
  • Пользовательские словари – добавляйте свои переводы для отдельных терминов (имена персонажей, локации и т.д.).
  • Встроенный запуск игры – открывайте локальный файл игры (HTML или EXE) прямо из лаунчера.
  • Логи в реальном времени – отслеживайте работу сервера.
  • Интегрированная вики – доступ к документации без выхода из приложения.
  • Просмотр чейнджлога – история изменений каждой версии.
  • Кнопка Discord – быстрое приглашение в сообщество.
  • Кастомные элементы окна – сворачивание, разворачивание, закрытие, перетаскивание.

⬇️ Скачать

  • Установщик лаунчера:GitHub Releases (XCL_Translator_Launcher_Setup.exe)
  • Клиентский скрипт (для браузера): прикреплён к этому посту (xcl-client.user.js)

📦 Установка

1. Установите лаунчер

  1. Скачайте установщик с GitHub и запустите его.
  2. Следуйте инструкциям мастера установки (выберите папку, создайте ярлыки).
  3. Запустите приложение через ярлык на рабочем столе.

2. Установите клиентский скрипт

  1. Установите менеджер пользовательских скриптов, например Tampermonkey или Violentmonkey, в ваш браузер.
  2. Скачайте прикреплённый файл xcl-client.user.js – Tampermonkey предложит его установить.
  3. Нажмите «Установить».

3. Начните переводить

  1. Держите лаунчер запущенным (можно свернуть в трей).
  2. Откройте X‑Change Life в браузере – скрипт подключится к лаунчеру и автоматически переведёт текст.

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

  • Сменить язык: Во вкладке «Перевод» выберите нужный язык и нажмите «Применить». Игра обновится через несколько секунд.
  • Добавить свой термин: Во вкладке «Словари» введите английский термин и его переводы для любых поддерживаемых языков, затем нажмите «Добавить».
  • Запустить игру: Во вкладке «Игра» нажмите «Обзор…», выберите локальный файл игры (HTML или EXE) и нажмите «Запустить».
  • Изучайте: Используйте вкладки «Моды», «Вики», «Чейнджлог» и «Логи» для дополнительных возможностей.

❗ Важные замечания

  • OCR‑перевод изображений и локальный движок LibreTranslate в этой версии временно отключены. Они могут вернуться в будущих обновлениях.
  • Для работы Google Translate требуется подключение к интернету.
  • Лаунчер должен быть запущен во время игры.

💖 Поддержать проект
Если вам нравится этот инструмент и вы хотите поддержать его развитие, вы можете сделать пожертвование через Boosty:
https://boosty.to/heyvanushi

📋 Системные требования

  • Windows 7/8/10/11 (64‑разрядная)
  • Браузер с поддержкой userscript (Chrome, Firefox, Edge, Opera)
  • Подключение к интернету (для Google Translate)

X‑Change Life разработана NoStage. Этот лаунчер – проект сообщества от Heyvanushi.

 

syslink

syslink

Posted
Posted

При подключении мода Smart_Russian_Translator.zip в самой игре возникает ошибка: 

There is a problem with this story's 1st script:
TypeError: positions(...) is not a function
TypeError: positions is not a function

При запуске "start-server.bat" в консоли:
KsWuZ2SzeWOfO3r33oUlBA-350.jpeg

Парсер пишет про порт 9153, хотя в инструкции об этом ничего не сказано. В mod-loader-2.3.1.jar у меня по умолчанию стоял порт 8080, затем он сменился на 9154 (вероятно, из-за того, что 80-й порт был занят). В настройках самого модлоадера сейчас прописан 9154(я туда не лазил. стандартное поведение).

По сути .bat никак не прослушивает данные в игре, возможно потому что игра не смогла инициализировать мод

Heyvanushi

Heyvanushi

Posted
  • Author
Posted

Обновил версию
✅ Улучшения системы перевода

  • Игнорирование регистра: Переводчик теперь корректно работает с текстами в разном регистре

  • Улучшенное распознавание: Исправлены алгоритмы поиска и замены текста

  • Поддержка форматирования: Корректная обработка текста с *курсивом* и **жирным** начертанием

🔧 Исправления фильтрации

  • Исправлен сбор непереведенного: Файл untranslated.json теперь корректно обновляется

  • Улучшена очистка текста: Лучшая обработка игровых макросов и служебных конструкций

  • Оптимизирована работа: Уменьшено количество ложных срабатываний

🌍 Обновленный интерфейс

  • Мультиязычная поддержка: Полностью переведенный интерфейс на 11 языков

  • Новая панель управления: Улучшенный UI с статистикой и горячими клавишами

  • Расширенные возможности:

    • Просмотр непереведенных текстов

    • Ручное добавление переводов

    • Перезагрузка словарей без перезапуска

📚 Структура словарей

  • Локализованные словари: Переводы хранятся в соответствующих языковых папках

  • Автоматическое обновление: Словари загружаются с сервера при подключении

  • Резервное копирование: Автоматическое создание бэкапов при изменении файлов

  • 2 weeks later...
cardiQ

cardiQ

Posted
Posted

Не могу понять что делаю не так, мод установился, сервер запускается, но пишет что в словаре 0 слов и соответственно перевода нет

MegQ

MegQ

Posted
Posted
14 minutes ago, cardiQ said:

Не могу понять что делаю не так, мод установился, сервер запускается, но пишет что в словаре 0 слов и соответственно перевода нет

Та же история, максимум что выводи в логи консоли 
(node:18940) [DEP0169] DeprecationWarning: `url.parse()` behavior is not standardized and prone to errors that have security implications. Use the WHATWG URL API instead. CVEs are not issued for `url.parse()` vulnerabilities.
(Use `node --trace-deprecation ...` to show where the warning was created)

Heyvanushi

Heyvanushi

Posted
  • Author
Posted
On 1/8/2026 at 2:23 PM, 妖心病狂 said:

Thank you so much for your translation tool! I've been wanting to create a Chinese translation for this game for a long time!

cool go ahead, although now I'm redoing the entire structure of the mod, and the dictionary system will change, but if you provide your translation to me in the discord theme in the official channel of the game, then I will definitely add it to the community database.

Heyvanushi

Heyvanushi

Posted
  • Author
Posted
5 hours ago, MegQ said:

Та же история, максимум что выводи в логи консоли 
(node:18940) [DEP0169] DeprecationWarning: `url.parse()` behavior is not standardized and prone to errors that have security implications. Use the WHATWG URL API instead. CVEs are not issued for `url.parse()` vulnerabilities.
(Use `node --trace-deprecation ...` to show where the warning was created)

 

5 hours ago, cardiQ said:

Не могу понять что делаю не так, мод установился, сервер запускается, но пишет что в словаре 0 слов и соответственно перевода нет

Напишете и предоставьте скриншоте в обсуждении в дискорд 
https://discord.gg/rRUMtNQ2v7
XCL Translator в разделе mods

 

Heyvanushi

Heyvanushi

Posted
  • Author
Posted
5 hours ago, cardiQ said:

Не могу понять что делаю не так, мод установился, сервер запускается, но пишет что в словаре 0 слов и соответственно перевода нет

из банального проверь словарь по пути XCL Translator/lang/ru 
не пуст ли он 
если не пустой то проверь правильно ли он укомплектован и стоят ли запятые после каждой строки последняя строчка без запятой 

Heyvanushi

Heyvanushi

Posted
  • Author
Posted
39 minutes ago, cardiQ said:

в релизе нет XCL_Translator.zip мб в этом дело? 

вот только что скачал , установил для проверки и все работает 
modded\XCL_Translator\lang\ru пройди по этому пути и открой словарь dictionary.json
{
  "1": "1",
  "new game": "Новая Игра",  - после каждой новой строчки запятая 
  "continue": "Продолжить",
  "saved games": "Загрузить игру",
  "view installed mods": "Установленные моды" -тут ее не должно быть 
)
там должно быть так 
так же в оригинале не должно быть кавычек 
""her stereo"": ""ее стереосистема"" - так не верно 
тут нужно заменить на 
"her stereo":"ее стереосистема" - так верно 
не или добавить / - перед другими ковычками

cardiQ

cardiQ

Posted
Posted

ну вроде все так, но словарь не подтягивает(

в файле все есть, но в консоли пишет что загружено 0 слов

Heyvanushi

Heyvanushi

Posted
  • Author
Posted
19 minutes ago, cardiQ said:

ну вроде все так, но словарь не подтягивает(

в файле все есть, но в консоли пишет что загружено 0 слов

можешь отправить мне в дискорд свой словарь ? 

 

BigOrangeSir

BigOrangeSir

Posted
Posted
48 minutes ago, Heyvanushi said:

what mod do you have in the list in the mod loader?
it should be so that other mods can overwrite the mod and add their own functions.
image.png.16bf9af23023b88b38c1c6adecccb6b1.png

I've solved it, sir. The answer to the problem is indeed a conflict between modules. 

Thank you for creating such a fantastic translation module.😄👍

Heyvanushi

Heyvanushi

Posted
  • Author
Posted
20 hours ago, BigOrangeSir said:

I've solved it, sir. The answer to the problem is indeed a conflict between modules. 

Thank you for creating such a fantastic translation module.😄👍

oh yes, I've solved the problem, I'll update the metadata to force the download of mod 1. I've encountered such errors and solved them with patches. As a result, I came to the conclusion that all other mods should load after mine and just tried it)

 

妖心病狂

妖心病狂

Posted
Posted

0 verbose cli E:\nodejs\node.exe E:\nodejs\node_modules\npm\bin\npm-cli.js
1 info using npm@11.6.2
2 info using node@v24.13.0
3 silly config load:file:E:\nodejs\node_modules\npm\npmrc
4 silly config load:file:D:\XCL 0.23 Full Download\server\.npmrc
5 silly config load:file:C:\Users\Adin\.npmrc
6 silly config load:file:C:\Users\Adin\AppData\Roaming\npm\etc\npmrc
7 verbose title npm install
8 verbose argv "install" "--loglevel" "warn"
9 verbose logfile logs-max:10 dir:C:\Users\Adin\AppData\Local\npm-cache\_logs\2026-01-19T09_06_10_652Z-
10 verbose logfile C:\Users\Adin\AppData\Local\npm-cache\_logs\2026-01-19T09_06_10_652Z-debug-0.log
11 silly logfile start cleaning logs, removing 1 files
12 verbose stack TypeError: Class extends value undefined is not a constructor or null
12 verbose stack     at Object.<anonymous> (E:\nodejs\node_modules\npm\node_modules\minipass-collect\index.js:4:23)
12 verbose stack     at Module._compile (node:internal/modules/cjs/loader:1761:14)
12 verbose stack     at Object..js (node:internal/modules/cjs/loader:1893:10)
12 verbose stack     at Module.load (node:internal/modules/cjs/loader:1481:32)
12 verbose stack     at Module._load (node:internal/modules/cjs/loader:1300:12)
12 verbose stack     at TracingChannel.traceSync (node:diagnostics_channel:328:14)
12 verbose stack     at wrapModuleLoad (node:internal/modules/cjs/loader:245:24)
12 verbose stack     at Module.require (node:internal/modules/cjs/loader:1504:12)
12 verbose stack     at require (node:internal/modules/helpers:152:16)
12 verbose stack     at Object.<anonymous> (E:\nodejs\node_modules\npm\node_modules\cacache\lib\get.js:3:17)
13 error Class extends value undefined is not a constructor or null
14 verbose cwd D:\XCL 0.23 Full Download\server
15 verbose os Windows_NT 10.0.22621
16 verbose node v24.13.0
17 verbose npm  v11.6.2
18 verbose exit 1
19 verbose code 1
20 error A complete log of this run can be found in: C:\Users\Adin\AppData\Local\npm-cache\_logs\2026-01-19T09_06_10_652Z-debug-0.log

 

I cannot use the server normally; this is the error file.

Heyvanushi

Heyvanushi

Posted
  • Author
Posted
13 hours ago, 妖心病狂 said:

0 verbose cli E:\nodejs\node.exe E:\nodejs\node_modules\npm\bin\npm-cli.js
1 info using npm@11.6.2
2 info using node@v24.13.0
3 silly config load:file:E:\nodejs\node_modules\npm\npmrc
4 silly config load:file:D:\XCL 0.23 Full Download\server\.npmrc
5 silly config load:file:C:\Users\Adin\.npmrc
6 silly config load:file:C:\Users\Adin\AppData\Roaming\npm\etc\npmrc
7 verbose title npm install
8 verbose argv "install" "--loglevel" "warn"
9 verbose logfile logs-max:10 dir:C:\Users\Adin\AppData\Local\npm-cache\_logs\2026-01-19T09_06_10_652Z-
10 verbose logfile C:\Users\Adin\AppData\Local\npm-cache\_logs\2026-01-19T09_06_10_652Z-debug-0.log
11 silly logfile start cleaning logs, removing 1 files
12 verbose stack TypeError: Class extends value undefined is not a constructor or null
12 verbose stack     at Object.<anonymous> (E:\nodejs\node_modules\npm\node_modules\minipass-collect\index.js:4:23)
12 verbose stack     at Module._compile (node:internal/modules/cjs/loader:1761:14)
12 verbose stack     at Object..js (node:internal/modules/cjs/loader:1893:10)
12 verbose stack     at Module.load (node:internal/modules/cjs/loader:1481:32)
12 verbose stack     at Module._load (node:internal/modules/cjs/loader:1300:12)
12 verbose stack     at TracingChannel.traceSync (node:diagnostics_channel:328:14)
12 verbose stack     at wrapModuleLoad (node:internal/modules/cjs/loader:245:24)
12 verbose stack     at Module.require (node:internal/modules/cjs/loader:1504:12)
12 verbose stack     at require (node:internal/modules/helpers:152:16)
12 verbose stack     at Object.<anonymous> (E:\nodejs\node_modules\npm\node_modules\cacache\lib\get.js:3:17)
13 error Class extends value undefined is not a constructor or null
14 verbose cwd D:\XCL 0.23 Full Download\server
15 verbose os Windows_NT 10.0.22621
16 verbose node v24.13.0
17 verbose npm  v11.6.2
18 verbose exit 1
19 verbose code 1
20 error A complete log of this run can be found in: C:\Users\Adin\AppData\Local\npm-cache\_logs\2026-01-19T09_06_10_652Z-debug-0.log

 

I cannot use the server normally; this is the error file.

send me in discord 2026-01-19T09_06_10_652Z-debug-0.log

Heyvanushi

Heyvanushi

Posted
  • Author
Posted
On 1/19/2026 at 12:12 PM, 妖心病狂 said:

0 verbose cli E:\nodejs\node.exe E:\nodejs\node_modules\npm\bin\npm-cli.js
1 info using npm@11.6.2
2 info using node@v24.13.0
3 silly config load:file:E:\nodejs\node_modules\npm\npmrc
4 silly config load:file:D:\XCL 0.23 Full Download\server\.npmrc
5 silly config load:file:C:\Users\Adin\.npmrc
6 silly config load:file:C:\Users\Adin\AppData\Roaming\npm\etc\npmrc
7 verbose title npm install
8 verbose argv "install" "--loglevel" "warn"
9 verbose logfile logs-max:10 dir:C:\Users\Adin\AppData\Local\npm-cache\_logs\2026-01-19T09_06_10_652Z-
10 verbose logfile C:\Users\Adin\AppData\Local\npm-cache\_logs\2026-01-19T09_06_10_652Z-debug-0.log
11 silly logfile start cleaning logs, removing 1 files
12 verbose stack TypeError: Class extends value undefined is not a constructor or null
12 verbose stack     at Object.<anonymous> (E:\nodejs\node_modules\npm\node_modules\minipass-collect\index.js:4:23)
12 verbose stack     at Module._compile (node:internal/modules/cjs/loader:1761:14)
12 verbose stack     at Object..js (node:internal/modules/cjs/loader:1893:10)
12 verbose stack     at Module.load (node:internal/modules/cjs/loader:1481:32)
12 verbose stack     at Module._load (node:internal/modules/cjs/loader:1300:12)
12 verbose stack     at TracingChannel.traceSync (node:diagnostics_channel:328:14)
12 verbose stack     at wrapModuleLoad (node:internal/modules/cjs/loader:245:24)
12 verbose stack     at Module.require (node:internal/modules/cjs/loader:1504:12)
12 verbose stack     at require (node:internal/modules/helpers:152:16)
12 verbose stack     at Object.<anonymous> (E:\nodejs\node_modules\npm\node_modules\cacache\lib\get.js:3:17)
13 error Class extends value undefined is not a constructor or null
14 verbose cwd D:\XCL 0.23 Full Download\server
15 verbose os Windows_NT 10.0.22621
16 verbose node v24.13.0
17 verbose npm  v11.6.2
18 verbose exit 1
19 verbose code 1
20 error A complete log of this run can be found in: C:\Users\Adin\AppData\Local\npm-cache\_logs\2026-01-19T09_06_10_652Z-debug-0.log

 

I cannot use the server normally; this is the error file.

1. Set the npm password completely:

clear the bash npm cache forcibly 

npm cache clean --force



2. Add node_modules and package-lock.json:
hit
# In the server folder, run:
  

rm -rf node_modules
rm package-lock.json

# or for Windows:
  

rd /s /q node_modules
del package-lock.json



3. Update npm: 

npm install -g npm@latest


4. Check the compatibility of the Node.js versions:
Node Js

5. Install the dependencies again:
  

npm install express cors node-fetch

 

妖心病狂

妖心病狂

Posted
Posted
On 1/21/2026 at 12:34 AM, Heyvanushi said:

1. Set the npm password completely:

clear the bash npm cache forcibly 

npm cache clean --force



2. Add node_modules and package-lock.json:
hit
# In the server folder, run:
  

rm -rf node_modules
rm package-lock.json

# or for Windows:
  

rd /s /q node_modules
del package-lock.json



3. Update npm: 

npm install -g npm@latest


4. Check the compatibility of the Node.js versions:
Node Js

5. Install the dependencies again:
  

npm install express cors node-fetch

 

Thank you so much! Reinstalling Node solved the problem!

Heyvanushi

Heyvanushi

Posted
  • Author
Posted
4 hours ago, Koluchiy83 said:

Новый мод менеджер не загружает.

в плане ? 

 

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
Go to topic listing

  • Recently Browsing   0 members

    • No registered users viewing this page.
×
×
  • Create New...