Translate
Official compatibility
| Element | Reference |
|---|---|
TypeWriter | Required. Use the official TypeWriter release supported by the extension release. |
| Related extensions | Install the related extensions listed on this page before using entries that depend on them. |
The Translate Extension empowers your server to be truly global, automatically translating chat, signs, and console output based on player preference.
Features
- Dynamic Translation — Real-time text replacement.
- Sign Localization — Per-player sign text.
- Auto-Detection — Detect client language.
- Pattern Matching — Regex replacement support.
Settings Menu
Players manage their whole translation experience from a dedicated settings menu (open_translation_settings_action): language selection, per-player sign translation opt-in/out and AI translation preference. Each preference persists in its own artifact, so choices survive relogs.
Entries
| Group | Entries |
|---|---|
| Configuration | translation_config, language_menu_config, translation_settings_menu_config |
| Actions | set_language_action, open_language_selector_action, open_translation_settings_action, reload_translations_action |
| Artifacts | player_language_artifact, player_sign_preference_artifact, player_ai_preference_artifact |
| Facts & Events | player_language_fact, player_language_change_event |
Placeholders
| Placeholder | Description |
|---|---|
%typewriter_translate_<key>% | Translated text for key. |
%typewriter_translate_lang% | Language ID (en_US). |
%typewriter_translate_lang_display% | Language Name (English). |
User guide
- 1. Configure Settings — Start with the configuration entry: translation_config. This defines global settings for the extension. → translation_config
- 2. Trigger Actions — Use action entries to interact with the extension: set_language. Trigger them from commands, NPCs, events, or other entries. → set_language
Commands
This extension does not provide standalone commands. All functionality is accessed through Typewriter entries.
Permissions
No custom permissions. All access is controlled through Typewriter's entry-level system.
Dependencies
| Extension | Required | Usage |
|---|---|---|
| GUI Extension | Required | Translation menu GUI. |
| PlaceholderAPI | Optional | For @Placeholder fields. |
Troubleshooting
The extension is not visible
Check that the installed release matches the supported TypeWriter release and that the related extensions listed in the compatibility section are present.
An entry is missing
In the Typewriter Web panel, use the Search bar or the + button to find or create the entry with its exact identifier. Entry IDs and field names are case-sensitive; do not translate them.
The entry saves but nothing happens
Check that the entry is connected to the trigger, command, objective, event, or menu interaction required by its type. Test with optional permissions and criteria removed, then add them back one at a time.
An integration does not work
Verify the dependency and version shown in the extension card, then check the server log for the first error. Do not replace a missing dependency with a similarly named plugin unless the extension source explicitly supports it.