v1.0.26
Guia

Flujo Automatico

Localiza todos tus Canvas con unos pocos clics usando la Configuracion Rapida

ⓘ Este flujo es el recomendado si todos los Canvas de tu mundo estan hechos originalmente en el mismo idioma (por ejemplo, todos en español). Si mezclas idiomas base distintos, usa el Flujo Detallado.

Paso 1: Coloca el LocalizationManager en tu escena

Arrastra el prefab LocalizationManager.prefab a la raiz de tu escena. Lo encuentras en: Packages/com.benderdios.idiomas/Prefabs/LocalizationManager.prefab. Solo necesitas uno por mundo.

Prefab LocalizationManager en la jerarquia

El prefab incluye un Canvas con un dropdown de seleccion de idioma ya configurado. Si no quieres el dropdown todavia, puedes ocultarlo y añadirlo mas adelante.

Paso 2: Elige con que idiomas vas a trabajar

Selecciona el LocalizationManager en la jerarquia. En el inspector veras la lista de idiomas soportados. Marca los idiomas a los que quieres traducir tu mundo y elige el Idioma Fallback (el que se usara cuando un jugador tenga un idioma que no esta en tu archivo).

Seleccion de idiomas e idioma fallback
ⓘ Al principio el archivo de traduccion esta vacio. No te preocupes: se creara solo en el siguiente paso.
ⓘ Cuantos mas idiomas marques, mas tiempo tomara la auto-traduccion mas adelante. Puedes empezar con dos o tres y añadir mas despues.

Paso 3: Escanea la escena

Pulsa el boton "Escanear Escena". La herramienta recorre tu mundo y te muestra una lista de todos los Canvas que contienen textos. Todavia no ha modificado nada — es solo una vista previa para que veas que va a tocar.

Paso 4: Elige el idioma base comun y pulsa "Configuracion Rapida"

Justo encima del boton hay un desplegable de Idioma base. Elige el idioma en el que actualmente estan escritos los textos de tus Canvas (ejemplo: si escribiste todo en español, elige Español).

Boton Configuracion Rapida
⚠ Este idioma debe ser comun a todos los Canvas que vas a configurar de golpe. Si tienes un Canvas en ingles y otros en español, configuralos por separado usando el Flujo Detallado.

Pulsa "Configuracion Rapida". Con un solo clic la herramienta:

  1. Añade un componente CanvasLocalizer a cada Canvas detectado.
  2. Escanea los textos de cada Canvas de forma individual.
  3. Ignora automaticamente los textos que son solo numeros, signos o simbolos (no tiene sentido traducir "123" o "%").
  4. Genera claves unicas para cada texto traducible.
  5. Crea el archivo Assets/Idiomas_Data/translation.json y lo rellena con todas las claves en el idioma base.
Resultado del escaneo
ⓘ En la mayoria de casos, despues de este paso no necesitas tocar nada mas en cada Canvas. Solo revisa si quieres excluir algun texto especifico.

Paso 5: Auto-traducir a los demas idiomas

Baja en el inspector hasta la seccion "Traduccion" y pulsa "Auto-Traducir Idiomas Faltantes". Se abrira una ventana con el numero de textos que hay que traducir a cada idioma que marcaste.

Ventana de auto-traduccion

La herramienta usa dos servicios gratuitos, en orden:

Pulsa "Traducir X textos con MyMemory". Veras el progreso de cada idioma mientras se traducen los textos.

Traduccion en progreso

Paso 6: Revisar y guardar al JSON

Cuando termine, revisa las traducciones propuestas. Puedes editarlas directamente en la tabla antes de guardar (util si una traduccion automatica no te convence). Cuando estes contento, pulsa "Guardar al JSON".

Resultado final con boton Guardar al JSON
ⓘ Desde ese momento tu mundo ya esta traducido. Entra en Play Mode en Unity y veras los textos cambiar segun el idioma del jugador. Usa el dropdown del prefab para probar diferentes idiomas.
⚠ Los caracteres japoneses, coreanos y chinos pueden verse como cuadrados (□) en el editor de Unity. Esto es normal — en VRChat se renderizan correctamente gracias a las fuentes Noto Sans incluidas en el cliente.

Consejos importantes antes de publicar

Antes de subir tu mundo a VRChat, ten en cuenta estos puntos para que se vea bien en todos los idiomas:

  1. Usa TextMeshPro (TMP), no Legacy Text. La herramienta soporta los dos, pero TMP maneja mejor los acentos, los caracteres CJK y el rich text. Si tienes textos Legacy, considera convertirlos.
  2. Deja espacio extra en tus Canvas. El aleman puede ser un 40 % mas largo que el ingles, mientras que el japones suele ser mas corto. Diseña los cuadros con margen holgado y activa Auto Size en los TextMeshPro para que el texto se ajuste solo.
  3. Cuidado con las fuentes para idiomas CJK. Las fuentes latinas estandar no tienen caracteres chinos, japoneses ni coreanos. VRChat carga Noto Sans como respaldo, pero si usas una fuente propia, asegurate de añadir los atlas CJK o tus textos apareceran como cuadros □□□.
  4. Puedes editar el archivo JSON a mano. Se guarda en Assets/Idiomas_Data/translation.json. Si una traduccion automatica no te gusta, abrelo con cualquier editor de texto y cambiala directamente.
  5. Puedes tener varios archivos de traduccion. Util si quieres versiones distintas del mundo (eventos especiales) o separar textos de UI y subtitulos. Apunta el LocalizationManager al archivo que quieras cargar.
  6. Si modificas un texto en un Canvas despues de configurarlo, vuelve a escanear ese Canvas para que la herramienta detecte el cambio.

Resultado

Despues de estos 6 pasos, tu mundo tiene: