Tutorial / Settings
Translations
The toolbox's player screens in six languages (English, Español, Deutsch, Français, Русский, Português (Brasil)); the server's default language, each player's own pick, and the owner's edits.
What it does
Translations (v3.6.19) shows the toolbox's player screens in each player's language:
- the Toolbox HUD and the F3 hub (tabs, columns, keys, stats);
- the loadout screen (F4) and Create a Class;
- votes (the HUD, questions, options and results);
- the match HUD: rounds, the scoreboard, end screens, objectives, the kill feed, Waves, buy stations, Traitors / Murder, Hide and Seek, Gun Game, Infection, Juggernaut, Duels and Race;
- the XP popup and the match and vote messages in chat and on screen.
Built-in languages: English, Español, Deutsch, Français, Русский and Português (Brasil). Text with no translation stays English. Admin panels stay English for now; they follow in later patches.
v3.6.21.6.1: with KGX Core 1.3.3 or newer the phrases are edited on KGX Translations (Q menu > Utilities > KGX > KGX Translations, Addon: KGX's Admin Toolbox) with every KGX addon's, and this page points there with an Open KGX Translations button. On the first map start the toolbox's own edits and languages move there once (edits already made there win); a copy stays in data/kgx_admin_toolbox/lang_<code>_moved_to_core.json. Who may edit stays the same: the server owner, or superadmins while no owner is set. A language KGX Core had no room for (it already has 16 of the server's own) stays with the toolbox and is edited on this page under Languages that stay with the toolbox. Without KGX Core 1.3.3 the page below works as before.
The server sends each message as English text with its values (a name, a number), and each player's game shows it in that player's language. Two players in the same match can read the same message in two languages. Server logs, the Action Log, stats and saved files stay English.
Where to find it
Q menu > KGX's Admin Toolbox > Settings > Translations. Everyone can open it and read the phrases. Only the server owner (kgxat_owner in the server console; superadmins while no owner is set) changes phrases and languages. Superadmins set the server's default language.
Each player picks their own language in Settings > Display (themes) > Language.
The panel
| Option | What it does | Default |
|---|---|---|
| Server default language (kgxat_language) | The language players get unless they pick their own. auto - each player's Garry's Mod language follows each player's game language (Options > Language); a language not in the list falls back to English. Superadmins only. | English (en) |
| Language to edit | The language the list shows. | Your language, or Español while you play in English |
| Find a phrase | Filters the list by English or translated text. | empty |
| Phrase list | English, Translation and From: built in, edited (the owner's text) or - (no translation: shown in English). A line under the list counts the translated phrases. | |
| Double-click a phrase | Owner: type the new text. Leave it empty to go back to the built-in text. Keep {1}, {2}... (the values: names, numbers) and keys and commands like [F3] or !vote. |
|
| Right-click a phrase | Copy the English text; Back to the built-in text (edited phrases). | |
| Copy this language as JSON (to share or back up) | Copies every phrase of the language (built in and edited) as {"English text": "translation"}. |
|
| Add a language of your own... | Owner: a short code (1-6 letters, like it or pl) and its name (like Italiano). It shows in every player's Language list, English until you fill it in. Up to 16. |
|
| Remove this language (only your own) | Owner: removes a language you added, with all its phrases. Built-in languages cannot be removed. |
How to use it
Set the server's language
- Open Settings > Translations.
- In Server default language, pick the language, or auto so every player gets their own game language.
- Players who picked a language in Settings > Display keep theirs.
Fix a translation
- Pick the Language to edit and type a word of the phrase in Find a phrase.
- Double-click the line, type your text and press OK. Every player using that language sees it right away; players who join later get it too.
- To undo, right-click it > Back to the built-in text.
You can also edit English to change the wording on your server (for example "Scoreboard" to "Leaderboard").
Add a language
- Press Add a language of your own..., type the code and the name.
- Pick it in Language to edit and fill in the phrases (the most seen first: the HUD, F3 and the match messages).
- To share it with another server, press Copy this language as JSON and save it there as
data/kgx_admin_toolbox/lang_<code>.json.
Settings and commands
| Command / file | What it does |
|---|---|
kgxat_language |
Server: the default language: en, es, de, fr, ru, pt_br, a code you added, or auto. With KGX Core (v3.6.21.6) it is the same as kgx_language, the default of every KGX addon. |
kgxat_lang |
Player: empty = the server's default, auto = your Garry's Mod language, or a code. Set in Settings > Display. With KGX Core it is the same as kgx_lang. |
data/kgx_admin_toolbox/lang_<code>.json |
The owner's edits for a language: {"English text": "translation"}. A file put there loads when the map starts. |
data/kgx_admin_toolbox/lang_custom.json |
The languages you added: {"code": "Name"}. |
data/kgx_admin_toolbox/lang_<code>_moved_to_core.json |
v3.6.21.6.1, with KGX Core 1.3.3: a copy of the edits that moved to KGX Translations (lang_custom_moved_to_core.json: the languages). |
Tips and limits
- The built-in translations come with the addon and update with it. Your edits stay and win over them.
- Player names, weapon names from other addons, map names and text you typed yourself (mode names, loadout names, vote questions) are shown as they are.
- Some short pieces built by the game itself (like "5 minutes" in a cooldown message) stay English.
- Titles shown in capitals (class names, role names) are made upper case for Cyrillic and accented letters too.