El gaming es algo global. Dependiendo de qué estadísticas leas, entre 2,6 mil millones y 3,3 mil millones de personas juegan a videojuegos en todo el mundo. En 2023, el mercado de videojuegos solo en China ya movía 82,06 mil millones de dólares, y los países donde no se habla inglés estaban entre los que tenían más jugadores en el mundo.
Eso significa que la localización ya no es algo opcional si quieres aumentar el alcance y el potencial de ingresos de tu juego. Y si eres un desarrollador de Unity, nos gusta pensar que la mejor manera de hacer que tus juegos estén disponibles en los idiomas locales de los jugadores es usar el plugin de localización en Unity de Phrase Strings.
Aquí, te mostraremos los fundamentos que has de conocer para trabajar con Phrase Strings y Unity.
¿Qué problema estamos resolviendo aquí?
Antes de entrar en los aspectos prácticos, veamos los desafíos de localización que este plugin resuelve.
Como su nombre indica, Phrase Strings es la parte de la plataforma de localización de Phrase que te ayuda a gestionar versiones localizadas de las diversas cadenas que componen la interfaz de usuario de tu juego. Como una solución verificada de Unity, nuestro nuevo plugin ha sido construido según los más altos estándares de calidad y compatibilidad de Unity.
Si has localizado un proyecto de Unity anteriormente, hay muchas posibilidades de que acabes con un montón de hojas de cálculo, muchas discusiones y un proceso manual para importar archivos CSV de nuevo a las tablas de cadenas de Unity, solo para descubrir que hay problemas de formato y de desbordamiento de texto durante las pruebas de juego.
Usando el plugin de Phrase Strings para Unity, el flujo de trabajo se vuelve más automatizado y predecible:
- Creas, apruebas y gestionas las traducciones en la plataforma de Phrase.
- Tus tablas de cadenas se unen directamente a Phrase Strings a través del plugin.
- Puedes enviar el texto fuente a Phrase con un solo clic desde dentro de Unity.
- Y luego puedes descargar las traducciones completadas directamente en tu proyecto de Unity cuando estés listo.
Entonces, ¿cómo empiezas a usar el plugin Phrase Strings para Unity?
Comenzando con Phrase Strings y Unity
Nota: Para esta introducción vamos a usar el juego de muestra Endless Runner de Unity. Si aún no lo tienes, descárgalo y ábrelo en el editor de Unity.
El plugin de Unity de Phrase se basa en el paquete de localización de Unity y, en particular, en sus colecciones de tablas de cadenas. Así que el siguiente paso es instalar Unity Localization.
Si ya tienes experiencia con Unity, esto es bastante sencillo, pero para un recién llegado puede ser un poco abrumador, ya que hay varias formas diferentes de instalar paquetes de Unity. Afortunadamente, el paquete de localización está disponible en el registro oficial de paquetes de Unity.
- Abre el menú superior Window y luego selecciona Package Manager.
- Haz clic en el icono de búsqueda a la izquierda y así podrás buscar en Unity Registry.
- Busca «localization».
- Pulsa «Install» cuando encuentres el paquete correcto (pista: en el momento en el que se redactó este artículo, debería ser el único resultado). Como cabría esperar, el paquete se instalará en tu ordenador.

Ahora que el paquete está instalado, tenemos que inicializar la localización en nuestro proyecto.
En el menú de arriba deberás ir a Edit, haz clic en Project Settings y luego navega a la sección Localization del panel de configuración.

Pulsa el botón Create y luego guarda el archivo de configuración.
Si estás organizando tu proyecto de Unity por tipo de activo, es posible que quieras crear una carpeta llamada Localización para guardar el archivo de configuración, así como los futuros recursos de localización que crearemos. Pero si solo estás experimentando por ahora, puedes guardar tu configuración en la carpeta Assets.
La localización ahora está activada en el proyecto, pero hay más cosas que hacer.
Agrega los idiomas con los que quieres trabajar
Necesitamos decirle a Unity qué idiomas o dialectos queremos incluir en nuestro juego.

Haz clic en Add Locale y verás una lista de idiomas que podrás seleccionar.

No hay presión para elegir todas las localizaciones que deseas soportar en esta etapa. Dado que estás utilizando Phrase Strings, en lugar de un montón de hojas de Excel, agregar idiomas es prácticamente tan fácil como seleccionarlas, completar las traducciones en la plataforma de Phrase y luego subir esas cadenas traducidas de nuevo al proyecto de Unity.
Por ahora, selecciona inglés, alemán y la variante del alfabeto latino del serbio.
Establecer un idioma predeterminado en el caso de no contar con lo que el usuario prefiera
Vale la pena tomarse un momento para hablar sobre cómo funcionan los mecanismos de la segunda opción de un idioma.
El serbio es un gran ejemplo de la complejidad que puede llegar a darse. El serbio puede usar tanto el alfabeto cirílico como el latino.
El cirílico es el alfabeto oficial en Serbia, pero el latino también se usa ampliamente. El serbio también tiene varios dialectos regionales (Šumadija-Vojvodina, Kosovo-Resava y otros) y variantes de pronunciación (Ekavian e Ijekavian).
Al implementar la versión en alfabeto latino del serbio (sr-Latn), atenderemos a los usuarios de todas las variantes serbias basadas en el alfabeto latino.
Incluso si has elegido una variante para tu idioma, Unity elegirá sr-Latn como la alternativa predeterminada. Sin embargo, eso no tiene por qué aplicarse para las personas cuyos sistemas están configurados en la versión cirílica del serbio (sr-Cyrl).
Si su sistema está configurado para usar el alfabeto latino, verán esa localización, pero de lo contrario verán el idioma predeterminado del proyecto.
Hasta ahora, hemos seleccionado tres idiomas de los cientos que son compatibles oficialmente por el plugin de localización de Unity. Así que necesitamos establecer un idioma predeterminado para los millones de personas con cuyos idiomas preferidos no tenemos previsto contar.
Hacia la parte inferior del modal, puedes especificar cuál será el idioma predeterminado entre la lista de opciones que acabamos de seleccionar.

Especificando qué idioma usar
La localización de Unity también nos permite elegir cómo seleccionar qué idioma usar al cargar el juego. Hay varios métodos diferentes, entre ellos:
- Un idioma especificado como un argumento de línea de comandos
- El idioma proporcionado por el sistema del usuario
- Una alternativa distinta al idioma predeterminado del proyecto.
Probablemente puedes quedarte con el orden predeterminado, a menos que tengas una fuerte preferencia por otra cosa.
Configura las tablas de cadenas
Unity gestiona las cadenas en las tablas de cadenas. Cada idioma tiene su propia tabla que contiene pares de valores clave. Esta clave es lo que usas como referencia en tu código de UI, y el valor es el texto localizado real para ese idioma.
Antes de conectar Phrase a Unity, necesitamos configurar esas tablas de cadenas.
En el menú del nivel superior Window, selecciona Asset Management y luego Localization Tables. En la ventana que se abre, verás un mensaje que te indicará que no hay tablas.
Podemos solucionar eso haciendo clic en el botón New Table Collection. Por defecto, todos nuestros idiomas estarán seleccionados, así que solo necesitamos ponerle nombre a la colección (algo como «UI» servirá por ahora), luego hacer clic en Create y luego guardarlo en el directorio Assets.

Eso te deja con una tabla en blanco lista para añadir tus traducciones.

Vamos a agregar una clave lista para su traducción. Haz clic en New Entry y agrega la clave:
Main/UICamera/Loadout/StartButton/Text
Esto nos permitirá localizar el botón que inicia la partida en Endless Runner.

Ahora necesitamos reemplazar la cadena codificada en el código. En este caso, para cambiar el texto del botón en el que pone Run! en la pantalla principal, necesitamos editar:
Scripts > GameManager > LoadoutState.cd
Primero, necesitamos llamar al plugin de localización:
con UnityEngine.Localization.Settings;
Y luego reemplazar runButton.GetComponentInChildren<Text>().text = «Run!»; por:
runButton.GetComponentInChildren<Text>().text = LocalizationSettings.StringDatabase.GetLocalizedString(«UI», «UI_RUN_BUTTON»);
Podemos ver una vista previa de eso ejecutando el juego y cambiando el idioma:



Instala y conecta el plugin de Phrase
Ahora que hemos localizado una cadena, deja que Phrase se encargue de la traducción real y de la gestión de cadenas. Empieza con la instalación del plugin de Unity de Phrase Strings.
En el momento en que se redacta este artículo, el plugin de Phrase Strings aún no está disponible en la tienda de recursos de Unity. Lo instalaremos desde el repositorio de GitHub clonándolo en el directorio Packages > com.phrase.plugin de tu proyecto.
Ahora hay que conectar el plugin de Phrase a Phrase Strings en sí. Este es un proceso de dos pasos.
Primero, crea un proyecto de Phrase Strings para tu juego de Unity. En tu tablero de Phrase Strings, haz clic en Agregar proyecto. Dale un nombre a tu proyecto y, una vez que esté creado, agrega los idiomas con los que estamos trabajando en Unity. inglés, alemán y serbio (latín).

Ahora que tienes un proyecto listo para usar, necesitarás obtener una clave de API para conectar el plugin de Unity de Phrase a tu cuenta de Phrase Strings. Haz clic en tu cara en la esquina superior derecha y ve a Perfil > Configuración > Tokens de acceso.
El botón Generar token te llevará a un modal en el que podrás generar la clave.

Después de copiar la clave, regresa a Unity, donde necesitas visitar Assets > Scripts > UI > Configuración y luego hacer clic en el icono de Phrase. En el Inspector, agrega tu token de API y haz clic en Fetch Projects.
Si todo va bien, verás el proyecto que acabas de crear en la lista y los idiomas que coinciden entre tu proyecto de Phrase Strings y el proyecto de Unity.

Necesitamos llevar las cadenas que creamos anteriormente («Run!», «Laufen!» y «Trči!») a Phrase Strings, así que haz clic en Push to Phrase.
Haz tu primera traducción en Phrase
Resulta que «Laufen!» podría no ser la mejor palabra para los jugadores alemanes de nuestro juego. «¡Rennen!» está más cerca de lo que buscamos, ya que puede significar comenzar una carrera.
En el proyecto de Phrase Strings, abre el proyecto Endless Runner y luego visita la pestaña Idiomas.

Haz clic en el botón Editor para alemán y empezarás a ver cuánto puede ayudarte Phrase Strings con el proceso de localización, incluyendo sugerencias automáticas. Por ahora, reemplaza «Laufen!» por «Rennen!» y luego haz clic en Guardar.

De vuelta en el proyecto de Unity, haz clic en Pull languages y asegúrate de que las tres localizaciones estén seleccionadas, luego haz clic en Pull to Unity para descargar la traducción actualizada de Phrase Strings.
Una vez que la importación se haya completado, ejecuta el juego y selecciona la localización alemana para ver nuestra cadena recién actualizada en acción.

Localización de Unity con Phrase Strings
Al conectar el plugin de localización de Unity a Phrase Strings, puedes optimizar tu flujo de trabajo de localización sin necesidad de Google Sheets, archivos Excel, archivos CSV u otras complicaciones similares.
En esta breve introducción, solo hemos arañado la superficie de cómo Phrase Strings puede ayudarte a conseguir una localización mejorada con menos trabajo. Para más información, lee nuestra guía oficial sobre la integración entre Phrase y Unity.

Localización de videojuegos automatizada y sin errores
La comunidad de jugadores actual exige juegos inmersivos que estén disponibles en sus propios idiomas. Sin embargo, los procesos de localización manuales, la cantidad de equipos trabajando por separado y los errores de traducción pueden traer retrasos y ponerte trabas para llegar a un público global de forma efectiva.
Phrase soluciona todo esto gracias a su integración con Unity al automatizar flujos de trabajo y ofrecer el contexto exacto a los traductores. Esto acelera la llegada al mercado y garantiza unas traducciones precisas y de impacto.

