PerfectTranslate

Server-side game translation for Hytale. Override all vanilla item names, UI text, and messages in French, Spanish, German, or Italian. No client-side changes needed.

Version	1.0
Platform	Hytale Server Plugin
Java	21
Dependencies	None
Entries	8,000+ translation keys

Installation

Download PerfectTranslate-1.0.jar
Place it in your server's UserData/Mods/ folder
Start the server — default language is English
Edit config.json to set your server language
Restart — all players see the translated text

Supported Languages

Code	Language	Status
`en-US`	English	Default (vanilla)
`fr-FR`	French	Available
`es-ES`	Spanish	Available
`de-DE`	German	Available
`it-IT`	Italian	Available
`pt-BR`	Portuguese	Vanilla (built-in)
`ru-RU`	Russian	Vanilla (built-in)

Configuration

File: UserData/Saves/MODDING/mods/KatsuyaTV_PerfectTranslate/config.json

{
  "serverLanguage": "fr-FR"
}

Set serverLanguage to any supported language code. All players on the server will see that language.

Commands

Command	Description
`/translate fr-FR`	Switch to French (takes effect on reconnect)
`/translate es-ES`	Switch to Spanish
`/translate de-DE`	Switch to German
`/translate it-IT`	Switch to Italian
`/translate en-US`	Switch back to English

Translation Coverage

What gets translated:

Item names — All 3,000+ vanilla items (weapons, armor, blocks, food, plants, etc.)
Item descriptions — 290+ item descriptions
NPC names — 585 NPC and role names
UI text — Bench categories, interaction hints, commands
System messages — Chat, builder tools, objectives

Total: ~8,000 translated entries per language.

How It Works

PerfectTranslate uses the Hytale I18nModule and UpdateTranslations packet to send translations directly to the client. The flow:

Server loads translation files for all 4 languages at boot
When a player connects, the plugin sends the configured language pack via sendTranslations
The client receives the translations and displays them in-game
No client-side modification or settings change needed

Note: Hytale does not support diacritics in some contexts. Translations use ASCII equivalents (e.g. "Epee" instead of "Epee").

FAQ

All players see the same language?

Yes. The server language is global. Per-player language selection is not supported by the Hytale client yet.

Can I add my own translations?

Yes. Edit the .lang files in Server/Languages/[lang-code]/server.lang inside the JAR or provide your own language pack.

Some items are still in English

Fantasy/proper names (Cindercloth, Prismaloom, Kweebec, etc.) are kept in English as they have no real-world translation.