# Chat v každém jazyce, i nahlas

> Jeden chat, každý ho čte ve svém jazyce: řetěz překladačů (Groq, Azure, DeepL, LibreTranslate) s limity, cache a originálem po najetí myší - a předčítání chatu přímo na počítači hráče s modem STYGION Keystone Voice. Novinka 0.4, výchozí vypnuto; hlas má 31 jazyků od Keystone Voice 1.1.

Source: https://stygion.eu/cs/docs/keystone/translate
Updated: 2026-11-16

Novinka Keystone 0.4. Překladač je modul `translate`: je vypnutý, dokud v `config/keystone/translate.toml` (nebo v **Settings**) nenastavíš `enabled = true` a nerestartuješ server - `enabled` modulu se čte jednou, při startu serveru. Předčítání je na straně hráče, s malým modem STYGION Keystone Voice, a každý hráč si ho zapíná sám.

## Co vidí hráči

Jeden chat pro všechny. Zpráva napsaná v jiném jazyce přijde o chvilku později v jazyce čtenáře, se značkou na začátku - `[EN] <Eva> kdo jde těžit?`. Kdo čte jazyk pisatele, a pisatel sám, dostane zprávu hned; ničí zpráva nečeká na cizí překlad. Zpráva, kterou se nepovede přeložit včas (`patience`, 6 sekund), přijde, jak byla napsaná - překlad nikdy zprávu neztratí.

Jestli čtenář uvidí, co v zprávě opravdu stálo, **rozhoduje server**, `original`:

| `original` | Co dělá značka |
|---|---|
| `hover` (výchozí) | po najetí myší ukáže jazyk, překladač a původní zprávu |
| `click` | totéž a kliknutím se originál zkopíruje |
| `off` | značka řekne, že jde o překlad, originál se neukáže |

Každý hráč si rozhodne sám (oprávnění `keystone.translate`, které má výchozí skupina):

- `/translate` - jak to je teď; `/translate on`, `/translate off`;
- `/translate to <jazyk>` - číst chat v jiném jazyce, než má hra (`cs`, `de`, ... nebo `auto` pro jazyk hry);
- s Keystone na klientovi: **Keystone Settings (K) → Jazyk a hlas**, přepínač a jazyk.

Jazyk čtení je volba hráče, jinak jazyk jeho hry. `players.default` určuje, jestli hráč, který si nevybral, čte překlady (zapnuto); `languages` zúží, do kterých jazyků se překládá (prázdné = cokoliv, co kdo čte); `pairs` (třeba `cs>en, sk>en, en>cs`) překládá jen vyjmenované dvojice jazyků, takže čtenář, do jehož jazyka žádná dvojice nevede, nestojí žádný požadavek (prázdné = jakýkoli jazyk do jazyka čtenáře).

## Překladače

`chain` je vyjmenuje v pořadí, v jakém se ptají; vyhraje první, který umí odpovědět, a když žádný, zpráva se ukáže, jak byla napsaná.

| Id | Co | Zdarma | Co nastavíš |
|---|---|---|---|
| `groq` | jazykový model - přečte překlepy, slang i míchané jazyky, jak to hráč myslel | free tier Groqu (požadavky za minutu a den) | `groq.key`; `groq.address` a `groq.model` ho nasměrují na jakoukoli službu kompatibilní s OpenAI (OpenAI, OpenRouter, vlastní Ollama) |
| `azure` | Azure AI Translator | F0: 2 miliony znaků měsíčně | `azure.key`, `azure.region` pro regionální resource |
| `deepl` | DeepL API | Free: 500 000 znaků měsíčně | `deepl.key`; `deepl.address` je adresa Pro pro klíč Pro; `deepl.english` EN-GB nebo EN-US |
| `libre` | LibreTranslate | vlastní server bez limitu | `libre.address`, `libre.key` jen když ho chce |

Překladač bez klíče (nebo adresy) se přeskočí. Každý má `<id>.enabled`, `<id>.monthly-characters` (náš rozpočet; Azure a DeepL mají výchozí podle free tieru, 0 = žádný) a `<id>.per-minute` (strop požadavků za minutu). Překladač, který odpoví „moc požadavků“, si odpočine minutu a pokaždé déle, s vyčerpaným měsícem šest hodin, s odmítnutým klíčem půl hodiny; konzole to řekne jednou. Měsíce se počítají v UTC od 1. dne - fakturační měsíc poskytovatele může začínat jindy.

Co šetří požadavky:

- **cache** překladů (`cache.entries`, `cache.keep`): opakovaná zpráva nestojí nic;
- zpráva pro dva jazyky se nejdřív zeptá jednou - odpověď řekne, v jakém jazyce je, takže česká zpráva se nikdy neposílá překládat do češtiny;
- `writers-language = own` bere zprávu v jazyce, který pisatel čte (polovina požadavků, víc chyb; výchozí `detect` kontroluje každou zprávu);
- `most-characters` (300) a `per-player.per-minute` (12): delší zprávy a pisatel nad svůj podíl se ukážou, jak byly napsané - spammer ti měsíc nevyčerpá.

Překladač na tomhle stroji nebo ve tvé síti potřebuje `allow-local`. Adresy, klíče, `chain` a `allow-local` smí měnit jen vlastník.

## Přehled

Obrazovka **Chat translation** v editoru ukáže každý překladač v pořadí řetězu se stavem (ready, off, not set up, resting, month spent, at its ceiling), znaky za tento měsíc proti rozpočtu, požadavky a chyby, a pole, kterým zkusíš zprávu přes celý řetěz. Totéž je `GET /v1/translate/usage` (scope `translate.read`); `POST /v1/translate/try` (`text`, `to`; scope `translate.write`) přeloží, aniž by to kdo četl, a počítá se do měsíce, `POST /v1/translate/forget` vyprázdní cache. V konzoli nebo pro tým: `/keystone translate` (oprávnění `keystone.translate.admin`).

## Co odchází ze serveru

> [!IMPORTANT]
> Se zapnutým modulem a nastaveným překladačem **jde text zpráv z chatu k té překladové službě** - bez jmen, bez ID, nic jiného. Napiš to do pravidel serveru.

- Nic se neposílá, dokud nenastavíš klíč nebo adresu; modul je ve výchozím stavu vypnutý, každý překladač jde vypnout a každý hráč si překlad vypne sám.
- Filtr sprostých slov nahradí slova dřív, než zpráva odejde, a překlad jím projde znovu cestou zpátky - překladač nikomu nevloží sprosté slovo do úst. Překlad je jeden řádek bez barevných kódů a nikdy o moc delší než originál.
- Klíče zůstávají v `translate.toml` a posílají se jen jejich službě; API a editor řeknou, jestli je klíč nastavený, nikdy jaký.
- Volba hráče (zapnuto, vypnuto, kód jazyka) se ukládá na serveru v `keystone.db`.

Aby šel řádek měnit pro každého čtenáře, píše ho se zapnutým překladačem Keystone sám, jako u filtru sprostých slov; když chat formátuje jiný mod a `chat.step-aside` je zapnuté, Keystone ustoupí a nic se nepřeloží (konzole to jednou řekne).

## Chat nahlas: STYGION Keystone Voice 1.1

Čtení chatu nahlas je samostatný mod **STYGION Keystone Voice** (`keystone_voice`, jeden jar pro 1.21.1 i 26.2).
Keystone rozhoduje, které řádky se čtou, v jakém jazyce a pod jakým jménem, a kreslí nastavení (K → Settings → Jazyk
a hlas); bez modu Voice ta záložka říká, kde ho získat.

Voice 1.1 mluví **31 jazyky jedním přirozeným hlasem** (Supertonic 3, ženský nebo mužský, 44,1 kHz) na běhovém
prostředí sherpa-onnx 2.0.1, v malém vlastním procesu Javy vedle hry - Windows, Linux a macOS, x64 i ARM64. Nic se
nestahuje, dokud hráč nestiskne Stáhnout: jednou asi 155 MB (model z Hugging Face připnutý k jednomu commitu, běhové
prostředí z jeho vydání na GitHubu), každý soubor ověřený podle SHA-256 zapsaného v modu, do `config/keystone/tts/`;
potom je vše offline. Smazáním složky se vše odstraní. Řádek se čte v jazyce, který pro něj server určí, jinak
v jazyce čtenáře; soubory Piperu z verze 1.0 se smažou, jakmile je nový hlas na místě.

V K → Settings → Jazyk a hlas: zapnout nebo vypnout, ženský nebo mužský hlas, jestli říct, kdo řádek napsal, jestli číst i vlastní řádky, rychlost (50 až 200 %), hlasitost, Stáhnout, Vyzkoušet hlas a seznam jazyků, které hlas čte. Pro doplňky: `ChatVoice` a `ChatVoices` v balíčku `client` API dovolí, aby hlasem byl jiný mod. Model hlasu Supertonic 3 (Supertone Inc.) má licenci OpenRAIL-M, sherpa-onnx Apache-2.0.
