OurStoryTranslater

One server. Two languages. One chat.

Project Translate is an automatic server-side Russian ↔ English chat translator for Vintage Story multiplayer servers.

Players install nothing, configure nothing, and need no API key. The server reads each recipient's game language and delivers general-chat messages in the language that recipient understands.

An English message reaching a Russian reader appears as one line:

Nick: (EN) Привет, у кого есть железо?

Readers who already understand the original language receive the untouched original immediately. There is no duplicate [T] line and the author's own message is not replaced.

Features

• Server-only: no client mod and no player setup.
• Automatic RU/EN direction based on Cyrillic and Latin text.
• Per-recipient language from the player's client locale.
• One translated line tagged with the original language: (RU) or (EN).
• Translation only runs when an online reader actually needs the other language.
• Shared cache, provider failover, timeouts, cooldowns and preserved message order.
• A provider failure never swallows chat: the untouched original is delivered.
• Per-player opt-out and a private translation preview command.
• English and Russian command feedback included.

Installation

1. Stop the Vintage Story server.
2. Put the release ZIP, without unpacking it, into the server's VintagestoryData/Mods directory. On managed hosting, use its server Mods directory.
3. Remove older Project Translate ZIPs so only one version of projecttranslate remains.
4. Start the server. Players do not install this mod.
5. The first start creates VintagestoryData/ModConfig/ProjectTranslate.json.
6. After changing the config, run /tradmin reload or restart the server.

Commands

• /translate or /tl — show translation status.
• /translate on / off — receive translations or always receive originals.
• /tr <text> — translate text privately for yourself.
• /tradmin status — show providers, cache and opt-out count (controlserver privilege).
• /tradmin reload — reload configuration (controlserver privilege).

Providers and privacy

The default chain is google-free, google-free-alt, then mymemory. The Google endpoints are unofficial and can be rate-limited; MyMemory has a free quota. No API key is bundled or required.

General-chat text that requires translation is sent by the server to the selected external provider and is subject to that provider's terms and privacy practices. Commands, links, messages that do not need translation, and group/private channels are not sent for translation. Translation logging is disabled by default.

Known limitations in 0.1.0

• Only Russian and English are supported.
• Only general chat is translated; group/private channels remain vanilla.
• Mixed-language messages use whichever script dominates.
• Free providers may be quota-limited or temporarily unavailable.

---

Один сервер. Два языка. Один чат.

Project Translate — автоматический серверный переводчик русского ↔ английского чата для мультиплеерных серверов Vintage Story.

Игрок ничего не устанавливает, не настраивает и не вводит никаких ключей. Сервер читает язык клиента каждого получателя и доставляет сообщения общего чата на понятном этому получателю языке.

Английское сообщение для русского читателя выглядит одной строкой:

Nick: (EN) Привет, у кого есть железо?

Читатели исходного языка мгновенно получают неизменённый оригинал. Вторая строка [T] не создаётся, а собственное сообщение автора не заменяется переводом.

Возможности

• Только сервер: клиентский мод и настройка игроку не нужны.
• Автоматическое направление RU/EN по кириллице и латинице.
• Отдельный язык для каждого читателя по локали его клиента.
• Одна строка с меткой исходного языка: (RU) или (EN).
• Запрос выполняется только тогда, когда онлайн действительно есть читатель другого языка.
• Общий кэш, резервные провайдеры, таймауты, cooldown и сохранение порядка сообщений.
• Ошибка провайдера не съедает чат: игрок получает исходный текст.
• Персональное отключение перевода и приватная команда предпросмотра.
• Ответы команд на русском и английском.

Установка

1. Остановите сервер Vintage Story.
2. Положите ZIP релиза, не распаковывая его, в серверную папку VintagestoryData/Mods. На игровом хостинге используйте его серверную папку Mods.
3. Удалите старые ZIP Project Translate: в папке должна остаться одна версия projecttranslate.
4. Запустите сервер. Игрокам устанавливать мод не нужно.
5. При первом запуске появится VintagestoryData/ModConfig/ProjectTranslate.json.
6. После изменения настроек выполните /tradmin reload или перезапустите сервер.

Команды

• /translate или /tl — показать статус.
• /translate on / off — получать переводы или всегда видеть оригиналы.
• /tr <текст> — приватно перевести текст для себя.
• /tradmin status — провайдеры, кэш и число отказавшихся (привилегия controlserver).
• /tradmin reload — перечитать конфигурацию (привилегия controlserver).

Провайдеры и приватность

Цепочка по умолчанию: google-free, google-free-alt, затем mymemory. Эндпоинты Google неофициальные и могут ограничиваться; у MyMemory есть бесплатная квота. Ключ API в мод не встроен и для работы не требуется.

Текст общего чата, которому нужен перевод, отправляется сервером выбранному внешнему провайдеру и обрабатывается по его правилам и политике приватности. Команды, ссылки, сообщения без необходимости перевода и групповые/приватные каналы на перевод не отправляются. Логирование переводов по умолчанию выключено.

Ограничения версии 0.1.0

• Поддерживаются только русский и английский.
• Переводится только общий чат; групповые и приватные каналы остаются ванильными.
• В смешанном тексте выбирается преобладающий алфавит.
• Бесплатные провайдеры могут исчерпать квоту или временно не отвечать.

```