Contenido custom en servidores de Lineage 2: cómo añadir ítems personalizados sin romper el cliente

Casi todo el contenido custom de un servidor de Lineage 2 falla en el mismo punto: el servidor conoce el ítem nuevo, pero el cliente no. Un arma o una pieza de armadura personalizada son dos trabajos, no uno. Primero la defines en el servidor y luego le enseñas al cliente de cada jugador cómo se ve. Si te saltas la segunda parte, los jugadores verán un nombre en blanco o un icono que falta. Esta guía recorre las dos mitades para un servidor Interlude tipo L2J, y además cómo vender el ítem y distribuir el parche.

De qué se compone realmente un ítem custom

Interlude (C6) salió en NA/EU el 12 de abril de 2007 y sigue siendo la crónica que más personalizan los servidores privados. La estructura clásica de L2J de esa época reparte un ítem custom entre varios archivos. Una conocida guía de MaxCheaters lo resume así: "un archivo sql para tu base de datos, un archivo xml para el servidor y, por último, el archivo dat para el cliente".

Las builds más recientes eliminaron las tablas SQL, y los nombres de carpeta cambian de un pack a otro. Toma cualquier ruta que leas en un hilo de foro de hace 15 años como una pista y comprueba dónde guarda tu propia build (Mobius, aCis u otro fork) los XML de ítems antes de copiar nada.

Paso a paso: añadir un arma custom

Elige un solo ítem y haz que funcione de principio a fin antes de montar un set completo. El orden de abajo sigue el tutorial de MaxCheaters.

1. Elige un ID libre. La guía usa 99999. Escojas el que escojas, búscalo antes en tu datapack y en los archivos del cliente. Reutilizar un ID existente es una de las formas clásicas de romperlo todo.
2. Haz copia de seguridad de los .dat del cliente. Copia itemname-e.dat y el archivo grp correspondiente a un lugar seguro. En algún momento vas a romper uno.
3. Añade la definición en el servidor. Escribe el XML del ítem con sus stats. En una build L2J antigua, inserta también la fila SQL con el mismo ID.
4. Añade la entrada del nombre. Descifra itemname-e.dat, añade una línea con el ID, el nombre y la descripción, y deja una línea en blanco después de la última entrada.
5. Añade la entrada visual. En weapongrp.dat, añade el mismo ID y apúntalo a una malla, una textura y un icono. Reutilizar recursos originales es el camino fácil para un primer ítem.
6. Vuelve a cifrar y prueba. Guarda ambos archivos, reinicia el servidor, entra con un personaje GM y ejecuta //create_item 99999.

El ID tiene que ser idéntico en todos estos sitios: XML del servidor, fila SQL (si tu build la tiene), itemname-e.dat y el archivo grp. Una errata y el ítem existe en el servidor pero aparece mal, o directamente no aparece, en el cliente.

Editar archivos .dat sin corromper el cliente

Los .dat del cliente están cifrados, así que necesitas una herramienta para descifrarlos, editarlos y volver a cifrarlos. Las guías de la época de Interlude usan L2FileEdit o l2encdec y guardan los archivos como versión 413. Opciones de código abierto como open-l2encdec y L2crypt de acmi también manejan la familia de cabeceras 41x.

Haz coincidir la versión de cifrado con el cliente que realmente distribuyes. En un hilo, un usuario de Gracia Final obtuvo errores tras seguir los pasos de Interlude. La 413 es la elección habitual para Interlude, pero compruébala con tu propio cliente antes de publicar un parche.

La mayoría de parches rotos vienen de errores pequeños:

• Columnas y espacios. Estos archivos funcionan por columnas. Un espacio de menos o de más desplaza los valores siguientes y el cliente lee basura.
• Sin línea en blanco final. Las guías lo advierten por algo. Añádela siempre.
• Versión de la herramienta. Administradores de Interlude en l2jbrasil y RaGEZONE cuentan que la versión más nueva de FileEdit convertía las armas duales en espadas simples o no conseguía compilar weapongrp.dat. Muchos se quedan con la versión antigua por ese motivo. Son testimonios de la comunidad, así que si añades duales, pruébalas específicamente.

Guarda una copia limpia y sin modificar de la carpeta system del cliente junto a tu copia de trabajo. Cuando algo se vea mal, compararlo con el original es más rápido que adivinar.

Hacer llegar los ítems custom a los jugadores con multisell

Un ítem que los jugadores no pueden conseguir es solo un objeto de prueba. En los datapacks L2J, la forma habitual de repartir ítems es una tienda multisell, que normalmente se abre desde un NPC GM shop. Cada multisell es un archivo XML con el nombre de su ID numérico, así que la tienda 9000 está en 9000.xml.

Cada entrada tiene dos partes. Los ingredientes son lo que paga el jugador, ya sea adena, otro ítem o un montón de materiales. Los productos son lo que recibe. Eso hace del multisell la herramienta natural para rutas de mejora: entregar un arma normal más materiales a cambio de tu versión custom.

Hay dos flags que importan para el equipo custom:

• applyTaxes vale false por defecto. Si lo activas, los precios en adena pagan impuestos y lo recaudado va al castillo dueño del territorio. Vale la pena considerarlo si tu servidor tiene asedios activos.
• maintainEnchantment vale false por defecto. Cuando está activo, el nivel de encantamiento pasa al producto, pero solo en el modo que usa únicamente el inventario (exc_multisell). Si los jugadores mejoran un arma +10 y el resultado sale +0, revisa primero este flag y el modo de la tienda.

Pon precio a los ítems custom según la economía real de tu servidor, no en el vacío. Una tienda que vende equipo de primer nivel por adena el segundo día deja sin sentido el resto de tu progresión.

Distribuir el parche del cliente a los jugadores

Los .dat editados viven en la carpeta system del cliente, así que cada jugador necesita tus archivos parcheados para ver correctamente los ítems custom. No hay forma de evitarlo. Planifícalo desde el principio:

• Distribuye la carpeta system o un archivo de parche claro, con instrucciones de instalación pensadas para alguien que nunca ha tocado un .dat.
• Pon versión a tus parches. Cuando añadas ítems más adelante, los jugadores deben saber que su parche está desactualizado antes de reportar "armas invisibles" en Discord.
• Distribuye solo archivos que hayas generado tú a partir de una base limpia y publica sus checksums. Los jugadores tienen motivos para desconfiar de carpetas system cualquiera sacadas de internet.
• Mantén pequeños los cambios en el cliente. Cada ítem custom engorda el parche, y cada actualización del parche es una ocasión para que se vayan jugadores.

Sé honesto contigo mismo sobre el alcance. Los ítems custom le dan identidad a un servidor, pero no sustituyen unos rates estables ni una economía que funcione. Muchos servidores con largas listas de ítems custom murieron porque fallaba lo básico. Y todo esto se apoya en la propiedad intelectual de NCsoft, un riesgo legal que asume cualquier dueño de servidor privado.

Publica el servidor cuando el contenido esté listo

Una vez probados tus ítems custom, empaquetado el parche y con precios en las tiendas, el siguiente problema son los jugadores. Añade tu servidor a L2Calendar gratis para que quienes buscan tu crónica puedan encontrarlo. Menciona tu contenido custom y tu parche en la descripción para que los jugadores sepan desde el principio qué tienen que descargar. Si quieres más visibilidad en el lanzamiento, la posición VIP coloca tu ficha más arriba en la página.