Minecraft Bedrock Language Editor

Extensión de VS Code para editar los archivos de idioma (.lang) de Minecraft Bedrock con una tabla Clave | Original | Nuevo.

Funciones

Esta es la versión 0.4.0. Incluye:

• Abrir una carpeta texts (o la raíz del pack; entra solo en texts).
• Selector de idioma origen (solo códigos con archivo .lang).
• Selector de idioma destino (catálogo completo, marca (nuevo) y permite escribir un código ll_CC personalizado).
• Tabla editable con búsqueda, filtro Solo sin traducir y contador.
• = Copiar (botón o Alt+D): copia el original y propaga a las claves vacías con el mismo texto original.
• Alt+N: salta a la siguiente clave sin traducir.
• Ctrl+S: guarda y exporta.
• Ctrl+Z / Ctrl+Y (Ctrl+Shift+Z): deshacer y rehacer.
• Alt+H: heredar desde una versión anterior.
• Alt+O: elegir carpeta texts.
• Conserva comentarios, líneas vacías y orden del origen.
• Escribe UTF-8 sin BOM y CRLF.
• Copias de seguridad .bak_yyyyMMdd_HHmmss_fff_xxxxxxxx y rotación.
• Actualiza texts/languages.json (solo códigos, ordenados y sin duplicados).
• Sincroniza el idioma hermano español (es_ES ↔ es_MX) solo si ya existe.
• Heredar versión anterior: compara el en_US actual con el de una carpeta anterior y trae las traducciones del destino anterior. Marca las claves heredadas, las que hay que revisar porque cambió el inglés, las nuevas y las obsoletas. Filtro Solo nuevas/por revisar.
• Comparar carpetas texts: carpeta A (actual) frente a B (anterior), con altas, bajas, claves cambiadas y detalle por clave.
• Detectar textos traducibles en .lang, catálogos .json y cadenas de scripts (.js, .ts, .jsx, .tsx, .mjs, .cjs), con importación de los textos seleccionados al editor.
• Glosario de terminología (original = equivalencia1 | equivalencia2) y nombres propios detectados para conservarlos sin traducir.
• Traducción y revisión con IA usando los modelos de VS Code (vscode.lm, p. ej. GitHub Copilot Chat), con glosario y nombres propios como contexto y validación de marcadores (%s, %1$d, §a, {0}…).
• Borrador persistente: si cierras VS Code con cambios sin guardar, al volver a abrir la misma sesión puedes restaurarlos.
• Opciones de interfaz: tamaño de fuente, alto de fila e idioma de la interfaz (español, inglés y portugués de Brasil).
• Colores por familia de claves.
• Resaltado de sintaxis básico para .lang en el editor de texto.

Requisitos para desarrollar

• VS Code 1.90 o superior.
• Node.js 20 o superior (probado con Node 24).
• npm.

Desarrollo

cd minecraft-lang-editor-vscode
npm install
npm run compile

Para depurar: abre esta carpeta en VS Code y pulsa F5 (configuración Ejecutar extensión). Se abre una ventana de VS Code con la extensión cargada.

Para recompilar mientras desarrollas:

npm run watch

Tests

npm test

Empaquetar el .vsix

npm run package

Genera minecraft-bedrock-language-editor-0.4.0.vsix, que se instala con:

code --install-extension minecraft-bedrock-language-editor-0.4.0.vsix

Publicar en el Marketplace

1. Crea una cuenta en https://marketplace.visualstudio.com/manage y una organización de publisher. El identificador debe coincidir con publisher en package.json (ahora Roxter).

2. Crea un Personal Access Token (PAT) en Azure DevOps con el permiso Marketplace → Manage y cópialo.

3. Inicia sesión una vez:

   npx.cmd vsce login Roxter
   

4. Publica:

   npm.cmd run publish
   

   Para subir la versión automáticamente: npm.cmd run publish:patch, npm.cmd run publish:minor o npm.cmd run publish:major.

Si cambias de publisher, actualiza también publisher, homepage, bugs y repository en package.json. El repositorio es opcional para publicar, pero mejora la ficha del Marketplace.

Atajos

Uso

1. Abre la paleta de comandos (Ctrl+Shift+P).
2. Ejecuta Minecraft Bedrock Language Editor: Abrir editor .lang.
3. Pulsa Elegir carpeta y selecciona la carpeta texts del resource pack (o la raíz del pack).
4. Elige idioma origen y destino.
5. Traduce en la columna Nuevo y pulsa Guardar (Ctrl+S).

Para actualizar desde una versión anterior del pack: pulsa Heredar versión anterior y elige la carpeta que contiene el en_US.lang y el es_ES.lang antiguos. Las traducciones se cargan en la tabla (aún sin guardar), se marcan las claves a revisar y puedes filtrarlas con Solo nuevas/por revisar.

También puedes abrir el editor desde el botón de la barra de título al editar cualquier archivo .lang.

Comparar carpetas

Ejecuta Comparar dos carpetas texts (Ctrl+Alt+C) y elige la carpeta A (versión actual) y la B (versión anterior). La tabla muestra los archivos con altas, bajas y claves cambiadas; al seleccionar uno se ve el detalle clave por clave.

Detectar textos

Ejecuta Detectar textos traducibles (Ctrl+Alt+T), elige la carpeta del pack y revisa las cadenas encontradas en .lang, .json y scripts. Marca las que quieras y pulsa Importar al editor: se añaden como claves nuevas del origen actual para que las traduzcas y guardes con Ctrl+S.

Glosario, nombres propios e IA

• Glosario (Ctrl+Alt+G) abre un archivo de texto con el formato original = equivalencia1 | equivalencia2. La IA lo usa como contexto; nunca sustituye texto por sí solo.
• Nombres propios (Ctrl+Alt+N) detecta nombres en el origen y permite añadirlos al glosario para conservarlos sin traducir.
• Traducir con IA (Ctrl+Alt+I) y Revisar con IA (Ctrl+Alt+R) usan los modelos disponibles en VS Code (vscode.lm). Necesitas una extensión que aporte modelos, como GitHub Copilot Chat. Las propuestas se cargan en la tabla sin guardar; revísalas y pulsa Ctrl+S.

Estructura

src/
  core/            Núcleo (lectura/escritura, idiomas, colores, comparación,
                   detección, glosario, nombres propios e i18n)
  panel.ts         Panel webview y flujo de guardado
  compararPanel.ts Panel de comparación de carpetas
  deteccionPanel.ts Panel de detección de textos
  ia.ts            Integración con vscode.lm
  extension.ts     Activación y comandos
media/
  main.ts          Lógica de la interfaz (tabla, filtros, atajos)
  comparar.ts      Interfaz de comparación de carpetas
  deteccion.ts     Interfaz de detección de textos
  style.css        Estilos basados en el tema de VS Code
test/              Tests del núcleo (vitest)
syntaxes/          Gramática TextMate para .lang

Licencia

GPL-3.0-or-later. Consulta el archivo LICENSE incluido en el paquete. Copyright (C) 2026 Roxter.