![LOGO](https://cdn.modrinth.com/data/cached_images/6f917105f85b0319476b01a534407d2eb583109b.png) # 🌍 LangBridge **Translate every plugin message on your server into your language with a single click, without editing files by hand.** Installed a plugin and all its messages are in English? LangBridge finds each plugin's message files, translates them automatically, and keeps colors, placeholders and the original format intact. Your players can also chat across languages with automatic translation. --- ## ✨ Main Features ### 📦 Plugin Translation - **In-game menu** (`/lb`) listing all your plugins and their status. - Translates **`.yml`** files, plus **`.properties`** and **`.json`** language files. - **Protects what matters:** colors (`&a`, `&#ff0000`, MiniMessage), placeholders (`%player%`, `{0}`), URLs, comments and file structure. - **Separates messages from settings:** never touches materials, sounds, permissions, commands or worlds. - Checks that the file is still valid **before** saving it. ### 🛠️ Full Control - **Preview:** review and fix translations before they are saved. - **In-game editor** to fix any line. - **Glossary:** fixed terms (e.g. *Shop → Tienda*) and words that are never translated (*spawn, kit, PvP...*). - **Quality check:** flags suspicious lines (untranslated, much longer, different placeholders...). - **Undo and restore original**, with automatic backups. - **Language packs** to share reviewed translations with other servers. - Real-time **progress bar**, visible to admins only. ### 💬 For Players - **Chat translator:** each player reads chat in their own language. Hovering shows the original message and **which language it was written in** (Italian, Chinese, Japanese...). - **Multi-language announcements** (`/lb broadcast`): every player gets the announcement in their language. - **Automatic welcome message** in the new player's language. - Players can pick their language or turn chat translation off for themselves. ### 📊 For Admins - **Language statistics** (`/lb stats`): which languages your players speak, with recommendations. - **Discord notifications** via webhook (finished translations, errors, announcements...). - **Commands in English, Spanish or Portuguese** (configurable and editable). - **Developer API** with events. --- ## ⚙️ Translation Engines - **Google Translate** (default): free, no key needed. - **DeepL:** higher quality. Requires an API key (DeepL offers a free plan). --- ## 📋 Main Commands | Command | Description | |:--|:--| | `/lb` | Opens the menu | | `/lb translate ` | Translates one plugin or all of them | | `/lb undo ` | Undoes the last change | | `/lb restore ` | Restores the original files | | `/lb review ` | Shows suspicious translations | | `/lb glossary` | Manages the glossary | | `/lb broadcast ` | Multi-language announcement | | `/lb stats` | Language statistics | | `/lb language

` | Choose your language |
| `/lb chat` | Toggle chat translation for yourself |

### 🔑 Permissions

- `langbridge.admin`: translate and manage (OP by default).
- `langbridge.idioma`: choose language and use the chat translator (everyone).

---

## 📥 Installation

1. Download the `.jar` and place it in your `plugins/` folder.
2. *(Optional)* Install **ProtocolLib** so each player sees plugin messages in their own language.
3. Restart the server and use `/lb` as OP.

**Compatibility:** Paper, Purpur and Spigot, **1.16.5 to 26.3**.

---

## ⚠️ Important

- Machine translation **is not perfect**. That's why there is a preview, an editor, a glossary and a quality check.
- **Privacy:** to translate, texts (plugin messages, chat messages and announcements) are sent to the service you choose (**Google** or **DeepL**). No other server or player data is sent. If you don't want chat translated, you can turn it off in the config.
- Only messages stored in **config files** can be translated. Text hardcoded inside a plugin's `.jar` cannot be translated.
- After translating, reload the translated plugin or restart the server to see the changes.
- A copy of the original is always kept, so you can go back at any time.
  
---


Español (clic para ver)
# 🌍 LangBridge

**Traduce los mensajes de todos los plugins de tu servidor a tu idioma con un solo clic, sin editar archivos a mano.**

¿Instalaste un plugin y todos sus mensajes están en inglés? LangBridge busca los archivos de mensajes de cada plugin, los traduce automáticamente y respeta colores, placeholders y el formato original. Además, tus jugadores pueden chatear entre idiomas con traducción automática.

---

## ✨ Funciones principales

### 📦 Traducción de plugins

- **Menú en el juego** (`/lb`) con la lista de todos tus plugins y su estado.
- Traduce archivos **`.yml`**, y también **`.properties`** y **`.json`** cuando son archivos de idioma.
- **Protege lo importante:** colores (`&a`, `&#ff0000`, MiniMessage), placeholders (`%player%`, `{0}`), URLs, comentarios y la estructura del archivo.
- **Distingue mensajes de configuración:** no toca materiales, sonidos, permisos, comandos ni mundos.
- Comprueba que el archivo siga siendo válido **antes** de guardarlo.

### 🛠️ Control total

- **Vista previa:** revisa y corrige las traducciones antes de guardarlas.
- **Editor en el juego:** para corregir frase por frase.
- **Glosario:** términos fijos (ej. *Shop → Tienda*) y palabras que nunca se traducen (*spawn, kit, PvP...*).
- **Revisión de calidad:** marca las frases sospechosas (sin traducir, muy largas, placeholders distintos...).
- **Deshacer y restaurar original**, con copias de seguridad automáticas.
- **Paquetes de idioma** para compartir traducciones revisadas con otros servidores.
- **Barra de progreso** en tiempo real, visible solo para administradores.

### 💬 Para los jugadores

- **Traductor de chat:** cada jugador lee el chat en su idioma. Al pasar el ratón ve el mensaje original y **en qué idioma se escribió** (italiano, chino, japonés...).
- **Anuncios multilenguaje** (`/lb broadcast`): cada jugador recibe el anuncio en su idioma.
- **Bienvenida automática** en el idioma del jugador nuevo.
- Cada jugador puede elegir su idioma o desactivar la traducción para sí mismo.

### 📊 Para administradores

- **Estadísticas de idiomas** (`/lb stats`): qué idiomas hablan tus jugadores, con recomendaciones.
- **Avisos en Discord** mediante webhook (traducciones terminadas, errores, anuncios...).
- **Comandos en inglés, español o portugués** (configurable y editable).
- **API para desarrolladores**, con eventos.

---

## ⚙️ Motores de traducción

- **Google Translate** (por defecto): gratis, sin clave.
- **DeepL:** mayor calidad. Requiere una clave de API (DeepL ofrece un plan gratuito).

---

## 📋 Comandos principales

| Comando | Función |
|:--|:--|
| `/lb` | Abre el menú |
| `/lb translate ` | Traduce un plugin o todos |
| `/lb undo ` | Deshace el último cambio |
| `/lb restore ` | Restaura los archivos originales |
| `/lb review ` | Muestra las traducciones sospechosas |
| `/lb glossary` | Gestiona el glosario |
| `/lb broadcast ` | Anuncio multilenguaje |
| `/lb stats` | Estadísticas de idiomas |
| `/lb language ` | Elige tu idioma |
| `/lb chat` | Activa o desactiva el traductor de chat para ti |

### 🔑 Permisos

- `langbridge.admin`: traducir y administrar (OP por defecto).
- `langbridge.idioma`: elegir idioma y usar el traductor de chat (todos).

---

## 📥 Instalación

1. Descarga el `.jar` y colócalo en la carpeta `plugins/`.
2. *(Opcional)* Instala **ProtocolLib** para que cada jugador vea los mensajes de los plugins en su idioma.
3. Reinicia el servidor y usa `/lb` como OP.

**Compatibilidad:** Paper, Purpur y Spigot, de la **1.16.5 a la 26.3**.

---

## ⚠️ Importante

- La traducción automática **no es perfecta**. Por eso existen la vista previa, el editor, el glosario y la revisión de calidad.
- **Privacidad:** para traducir, los textos (mensajes de plugins, mensajes del chat y anuncios) se envían al servicio que elijas (**Google** o **DeepL**). No se envía ningún otro dato del servidor ni de los jugadores. Si no quieres traducir el chat, puedes desactivarlo en la configuración.
- Solo se traducen mensajes guardados en **archivos de configuración**. Los textos escritos dentro del código del plugin (`.jar`) no se pueden traducir.
- Después de traducir, recarga el plugin traducido o reinicia el servidor para ver los cambios.
- Siempre se guarda una copia del original, así que puedes volver atrás cuando quieras.

LangBridge

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

GUI

LANGUAGE CHAT

BOSSBAR PROGRESS