TQDB: La Base de Datos Definitiva de Titan Quest

Titan Quest, el legendario ARPG lanzado originalmente en 2006, ha demostrado tener una longevidad admirable, en gran parte gracias a una comunidad de jugadores apasionados que se niegan a dejarlo en el olvido. Con la llegada de la Anniversary Edition y sus posteriores expansiones bajo el amparo de Nordic Games, el juego recibió una nueva vida, pero también cambios significativos en su base de datos interna. Esto dejó a las antiguas wikis y bases de datos, como la popular GameBanshee, obsoletas. En este contexto nace TQDB, un proyecto moderno y vital que busca solucionar este problema, ofreciendo a los jugadores una fuente de información precisa y actualizada sobre cada rincón del vasto mundo de Titan Quest.

Pero TQDB es mucho más que un simple sitio web con listas de objetos. En su núcleo, es una poderosa herramienta de software, un parser escrito en Python, diseñado para desentrañar los secretos contenidos en los archivos del juego. Este artículo se sumerge en las profundidades de TQDB, explicando qué es, cómo funciona y por qué es un recurso indispensable tanto para el jugador casual que busca el mejor equipo como para el modder o entusiasta técnico que desea manipular los datos del juego directamente.

¿Qué es Exactamente TQDB?

En su forma más técnica, TQDB es un parser de Python. Un parser es un programa que lee datos en un formato y los traduce a otro más útil y manejable. En el caso de Titan Quest, los datos del juego (objetos, habilidades, monstruos, etc.) están empaquetados en archivos con formatos específicos, principalmente los archivos ARZ y ARC. El creador de TQDB desarrolló este script para leer, interpretar y extraer toda esa información de manera sistemática.

La motivación principal fue la necesidad de una base de datos que reflejara fielmente los cambios introducidos por Nordic Games. Con cada parche y expansión, los valores, objetos y mecánicas podían cambiar, haciendo que la información antigua fuera poco fiable. TQDB resuelve esto yendo directamente a la fuente: los propios archivos del juego en su versión más reciente.

El resultado de ejecutar este parser es doble y extremadamente útil:

• Un único archivo JSON: Para cada idioma disponible en el juego, el parser genera un archivo JSON que contiene de forma estructurada toda la información del juego. Esto incluye equipo, sets de objetos, habilidades, botín de jefes, recompensas de misiones y mucho más. El formato JSON es un estándar moderno para el intercambio de datos, fácil de leer tanto para humanos como para máquinas.
• Una hoja de sprites CSS: Junto con los datos, el parser también extrae las imágenes de todos los objetos y las compila en una única imagen de sprites, acompañada de su correspondiente hoja de estilos CSS. Esto permite mostrar los iconos de los objetos de manera muy eficiente en una aplicación web.

La Implementación Práctica: tq-db.net

Para la gran mayoría de los jugadores, la interacción con TQDB no será a través de la ejecución de código Python, sino a través de su implementación web: el sitio tq-db.net. Este portal es la cara visible del proyecto, una base de datos en línea construida con ReactJS que utiliza los archivos JSON generados por el parser para presentar la información de una manera limpia, navegable y con potentes filtros.

En este sitio web, los jugadores pueden encontrar:

• Listas completas de todo el equipo épico y legendario.
• Información detallada sobre los "Monster Infrequents" (MIs), objetos raros que solo sueltan enemigos específicos.
• Detalles sobre los sets de armadura y sus bonificaciones.
• Datos precisos sobre las habilidades de todas las maestrías.

Es el recurso definitivo para planificar la construcción de tu personaje, buscar ese objeto que te falta para completar un set o simplemente explorar la inmensa cantidad de botín que Titan Quest tiene para ofrecer.

Guía Técnica: Cómo Funciona y Cómo Usar el Parser

Para aquellos con un perfil más técnico o curiosidad por el proceso, el proyecto TQDB es de código abierto y puede ser ejecutado localmente. Esto permite a cualquiera extraer los datos por sí mismo, quizás para un proyecto personal, un mod o simplemente para analizar las entrañas del juego. A continuación, se detalla el proceso, que se divide en una configuración automatizada y una manual.

Configuración Automatizada (Recomendada para Usuarios de Steam)

El proyecto incluye un script que simplifica enormemente el proceso, aunque tiene una condición importante: asume que tienes Titan Quest Anniversary Edition instalado a través de Steam. Si cumples este requisito, los pasos son muy sencillos:

1. Ejecuta el script prepare.py usando Python.
2. Una vez finalizado, solo necesitas realizar el primer paso de la configuración manual (la extracción de la base de datos ARZ) para completar el proceso.

Guía de Configuración Manual Detallada

Si tu instalación no es de Steam o prefieres tener un control total sobre el proceso, la configuración manual es tu camino. Requiere seguir una serie de pasos utilizando herramientas que vienen con el propio juego.

Requisitos previos:

• Tener instalado Python 3.6 o superior.
• Utilizar Pipenv para gestionar las dependencias del proyecto.

Paso 1: Extraer la Base de Datos ARZ

Los archivos ARZ son el corazón de la base de datos de Titan Quest. Necesitarás usar la herramienta ARZExtractor.exe para descomprimirlos. El proceso consiste en seleccionar el archivo Database/database.arz de tu directorio de instalación del juego y extraer su contenido en una carpeta específica dentro del proyecto TQDB.

Paso 2: Extraer las Plantillas (Templates)

Las plantillas definen la estructura de los registros de la base de datos. Se extraen utilizando la herramienta ArchiveTool.exe sobre el archivo Toolset/Templates.arc.

Paso 3: Extraer los Recursos de Texto

Los textos del juego (nombres de objetos, descripciones, diálogos) están en archivos ARC separados para cada idioma. Deberás ejecutar ArchiveTool.exe sobre el archivo del idioma que desees. Por ejemplo, para el español, sería Text/Text_ES.arc.

Paso 4 y 5: Extraer Texturas y Misiones

De manera similar, se utiliza ArchiveTool.exe para extraer los archivos de texturas de los objetos (Resources/Items.arc, Resources/XPack/Items.arc, etc.) y los datos de las misiones (Resources/Quests.arc).

Ejecutando el Parser

Una vez que todos los archivos del juego han sido extraídos y están en las carpetas correctas, ejecutar el parser es tan simple como un comando en la terminal:

pipenv run python ./run.py

Este comando ejecutará el script con el idioma inglés por defecto. Si deseas otro idioma, puedes especificarlo con la opción --locale, por ejemplo: --locale es para español. El proceso tardará varios minutos, durante los cuales verás mensajes en la consola indicando el progreso a medida que procesa los afijos, criaturas, equipo y demás categorías.

Preguntas Frecuentes (FAQ)

¿Qué es TQDB en pocas palabras?

TQDB es tanto una base de datos en línea (tq-db.net) como una herramienta de software (un parser de Python) para extraer y organizar toda la información del juego Titan Quest Anniversary Edition.

¿Necesito ser programador para usar la base de datos?

No. Para consultar información sobre objetos, sets o habilidades, simplemente visita el sitio web tq-db.net. La parte del parser y la programación es solo para aquellos usuarios avanzados que deseen extraer los datos del juego por sí mismos.

¿Por qué se creó TQDB si ya existían otras bases de datos?

Las bases de datos antiguas quedaron desactualizadas después de que Nordic Games lanzara la Anniversary Edition y sus expansiones, que modificaron muchos aspectos del juego. TQDB se creó para proporcionar una fuente de información precisa y moderna, extraída directamente de los archivos más recientes del juego.

¿Qué información puedo encontrar en TQDB?

Prácticamente todo lo que un jugador podría necesitar: estadísticas detalladas de todo el equipo (incluyendo Monster Infrequents, épicos y legendarios), bonificaciones de sets, descripciones de habilidades, botín de jefes, recompensas de misiones y más.

¿El parser funciona con mi copia del juego en español?

Sí. Durante la configuración manual, puedes elegir qué paquete de idioma extraer. Una vez extraído, puedes ejecutar el parser especificando el código de idioma (por ejemplo, 'es' para español) para generar un archivo JSON con todos los textos en ese idioma.