AcTePuKc/bg-game-translation-qa

Control de Calidad de Localización de Videojuegos al Búlgaro

Usa esta habilidad para trabajar en la localización de videojuegos al búlgaro, donde preservar el formato del archivo es tan importante como mejorar el texto. Realiza cambios mínimos y seguros, y prefiere parches enfocados en lugar de reescribir archivos completos, a menos que el usuario solicite explícitamente una reescritura completa.

Flujo de Trabajo Principal

1. Identifica el formato del archivo y los campos traducibles antes de editar.
2. Preserva toda la estructura, orden, delimitadores, comillas, escapado, comentarios, claves, IDs y metadatos.
3. Traduce o edita solo el texto visible para el usuario.
4. Preserva marcadores de posición, etiquetas de formato, variables, secuencias de escape y saltos de línea exactamente, a menos que el usuario solicite explícitamente cambiarlos.
5. Sigue cualquier glosario del proyecto, base de términos, guía de estilo o memoria de traducción existente proporcionada por el usuario o presente en el proyecto.
6. Reporta cadenas inciertas por separado, en lugar de adivinar en silencio.
7. Resume qué cambió, qué se dejó sin cambios y cualquier riesgo o pregunta.

Contenido No Traducible

No traduzcas ni normalices identificadores internos, nombres de enumeraciones, nombres de archivos, rutas de archivos, nombres de clases, nombres de funciones, nombres de objetos, nombres de activos, nombres de eventos, comandos de consola, claves de configuración, IDs o metadatos técnicos, a menos que el usuario los marque explícitamente como texto visible para el jugador.

Para archivos estructurados, mantén intactos el número de filas, el orden de las claves, el anidamiento, los separadores y la codificación. Para tablas CSV/TSV, preserva la estructura exacta de las columnas. Para archivos JSON/XML/INI/PO, preserva la sintaxis y el escapado.

Marcadores de Posición y Etiquetas

Preserva los marcadores de posición y las etiquetas de formato byte por byte, incluyendo mayúsculas/minúsculas, puntuación, anidamiento, espaciado y orden. No traduzcas texto dentro de variables a menos que sea claramente texto de visualización para el jugador.

Protege siempre patrones como:

• {PLAYER}
• {0}
• %s
• %d
• <color=...>
• </color>
• <b>
• </b>
• \n
• \t
• [br]
• [[...]]
• $VARIABLE
• ${variable}

Lee references/placeholders.md cuando la tarea incluya tokens desconocidos, texto enriquecido, marcado de interfaz de usuario, sintaxis de scripting o marcadores de posición específicos del formato.

Estilo de Localización Búlgara

Usa frases naturales en búlgaro, no un orden de palabras literal del inglés. Mantén el texto de la interfaz de usuario conciso y legible, especialmente para botones, menús, logros, descripciones emergentes y mensajes de combate.

Prefiere una traducción búlgara culturalmente apropiada sobre la transliteración cuando sea posible, pero mantén los términos establecidos del juego y las elecciones del glosario del proyecto de manera consistente. Preserva la voz del personaje en los diálogos y evita formalizar en exceso el habla casual o humorística.

Cuando se desconozca el género del hablante o del jugador, evita frases con género forzado donde el búlgaro permita una construcción neutra. No introduzcas frases que suenen a ruso o ucraniano. Evita la capitalización innecesaria copiada de los encabezados en inglés, nombres de elementos o etiquetas de la interfaz de usuario, a menos que el estilo del proyecto lo requiera.

Términos Técnicos y Préstamos

No traduzcas un término técnico mecánicamente solo porque sea visible en el origen. Primero determina si es un identificador interno, un término especializado establecido o prosa visible para el jugador.

• Mantén sin cambios los nombres de API, comandos, claves de configuración, nombres de clases y otros identificadores.
• Para texto visible para el jugador, prefiere una descripción búlgara natural de la función sobre un préstamo literal.
• Si el origen no establece el rol técnico con precisión, no inventes uno. Usa una frase funcional neutra o reporta la cadena como incierta.
• Sigue el glosario del proyecto cuando defina un término, incluso si otra opción búlgara también es posible.

Ejemplos:

Término origen	Texto visible para el jugador	Explicación técnica	No asumas
hook	механизъм / точка за включване	обработчик / точка за разширяване	que significa un módulo o «кука»
compatibility hook	механизъм за съвместимост	обработчик за съвместимост o точка за включване за съвместимост	que модул, кука o прихващач siempre es correcto
fix	поправка / корекция	поправка за съвместимост	que la jerga фикс encaja con la audiencia
handler	describe su acción si es necesario	обработчик	que debe transliterarse como хендлър

Por ejemplo, traduce The journal level label was corrected through the compatibility hook. como Надписът за нивото в дневника е коригиран чрез механизма за съвместимост. para un registro de cambios visible para el jugador. No uses кука за съвместимост por defecto.

Términos Repetidos del Juego

Cuando un concepto de mecánica de juego o interfaz de usuario se repite, decide su nombre búlgaro en la primera aparición clara y regístralo en el glosario del proyecto. No colapses términos relacionados en una sola palabra búlgara solo porque suenen similares en inglés.

Términos origen a distinguir	Posibles elecciones búlgaras	Riesgo de calidad
skill, ability, perk, trait, feat	умение, способност, привилегия, черта	Los diferentes sistemas de progresión se vuelven indistinguibles
buff, debuff, status effect	положителен ефект, отрицателен ефект, ефект на състояние	El jugador no puede distinguir una bonificación de una condición
cooldown, charge, stack	време за изчакване, заряд, натрупване	Se confunden los mecanismos de tiempo, recurso y acumulación
loot, drop	плячка, изпуснат предмет	Un grupo de recompensas se confunde con un elemento producido por un evento o enemigo
spawn, despawn, trigger	появяване, изчезване, задействане	Los eventos del mundo y las condiciones de interacción se vuelven vagas
crafting, recipe, blueprint, upgrade	изработка, рецепта, чертеж, подобрение	La fabricación, los desbloqueos y las mejoras pierden su distinción mecánica
save, load, save slot	запазване, зареждане, място за запазена игра	La acción, la partida guardada y su ubicación se confunden

También revisa palabras técnicas sensibles al contexto como support, state, patch, build, release y slot. Por ejemplo, support puede significar съвместимост, поддръжка o помощ; patch puede ser поправка, корекция o обновление.

Tratamiento y Registro

No uses por defecto el tratamiento formal Вие / -те para la interfaz de usuario visible para el jugador, tutoriales, indicaciones, objetivos o mensajes genéricos del sistema. Prefiere el singular informal ти / -ш o una construcción neutra natural, a menos que el glosario del proyecto, la voz del personaje, el entorno o el contexto de origen requieran claramente un tratamiento formal.

Señala el tratamiento/registro no coincidente como un problema de calidad, especialmente cuando el inglés you se tradujo como búlgaro formal sin evidencia de que el juego use un tratamiento formal para el jugador.

Ejemplos:

• You have to do this. -> prefiere Трябва да направиш това. o Това трябва да се направи. según el contexto
• evita usar por defecto Вие трябва да направите това. en la interfaz de usuario normal para el jugador
• mantén el tratamiento formal para nobles, funcionarios, interfaces de tipo servicio al cliente, narraciones intencionalmente distantes o proyectos cuyo estilo establecido use Вие

Lastre de Traducción

Señala frases de origen que están técnicamente traducidas pero que agregan peso innecesario al texto de la interfaz de usuario en búlgaro. Trátalas como advertencias de calidad para revisión manual, no como correcciones automáticas.

Usa severidad low y acción manual review para posibles lastres de traducción. Mantén la frase cuando transmita información real de jugabilidad, espacial, de objetivo, de sincronización o mecánica.

Ejemplos comunes:

• through the air después de verbos como shoot, fire, throw o launch
  • shoots arrows through the air -> изстрелва стрели
  • señala variantes demasiado literales como изстрелва стрели във въздуха a menos que el viaje aéreo sea mecánicamente relevante
• nearby cuando la proximidad ya está implícita en la oración búlgara
  • when enemies are nearby -> когато има врагове наблизо
  • when senses lifeforms nearby -> когато усети живи същества наблизо
  • mantén наблизо cuando define el radio de detección, el objetivo, el rango de activación o la ubicación
• into pieces / apart después de verbos que ya implican romper
  • smashing things apart -> разбиване на неща
  • evita frases forzadas como разбиване на неща на парчета a menos que los fragmentos/piezas importen
• on the ground, in front of you, with your hands o by hand cuando el verbo o contexto búlgaro ya implica la información
  • manténlos cuando transmitan restricciones reales de posición, entrada, fabricación o interacción

Lee references/bg-text.md para obtener orientación práctica sobre el estilo búlgaro y references/glossary-template.md al crear o ampliar un glosario del proyecto.

Relación con bg-text

Cuando la habilidad bg-text esté disponible o el usuario solicite usarla, utilízala como referencia complementaria para la tipografía, claridad, puntuación, gramática y calidad editorial general del búlgaro. Aplica primero las restricciones de localización de juegos de esta habilidad: nunca permitas que la limpieza de tipografía o estilo altere la estructura protegida, claves, IDs, marcadores de posición, etiquetas, secuencias de escape, saltos de línea o terminología del proyecto.

Para archivos de juegos, trata bg-text como una guía de calidad del idioma, no como permiso para reescribir archivos completos o normalizar la sintaxis específica del motor.

Lista de Verificación de Calidad

Antes de la salida final, verifica:

• marcadores de posición rotos, cambiados, reordenados o faltantes
• etiquetas de formato faltantes, mal formadas o desequilibradas
• claves, IDs, nombres de archivos, rutas o metadatos cambiados
• filas faltantes o forma de tabla cambiada
• IDs duplicados introducidos o pasados por alto
• inglés sin traducir en campos traducidos
• restos de ucraniano
• restos de ruso
• términos del glosario inconsistentes
• términos técnicos traducidos mecánica o inconsistentemente
• mecánicas de juego relacionadas colapsadas en un solo término sin una decisión del glosario
• búlgaro demasiado literal
• tratamiento formal/informal no coincidente, especialmente Вие innecesario en la interfaz de usuario para el jugador
• posible lastre de traducción / frase literal que debe revisarse manualmente
• texto de interfaz de usuario obviamente demasiado largo para su control probable

Lee references/qa-checklist.md para una revisión final práctica.

Expectativas de Salida

Prefiere cambios tipo parche y correcciones enfocadas. Explica brevemente los cambios de traducción o calidad significativos. Enumera las cadenas inciertas por separado con la clave/ID o ubicación, el problema y el manejo sugerido más seguro.

Si el archivo es grande, inspecciona suficiente contexto circundante para evitar desviaciones de terminología, luego edita solo el alcance solicitado. Si un cambio solicitado corre el riesgo de dañar la estructura o los marcadores de posición, detente y pide una aclaración.