Plugin de Mejora de Armas

🔧 Requisitos

DESCARGAR —>
– **Hybrid API** (Serilum:Hybrid) – Manejado automáticamente como una dependencia

📖 Descripción General

Weapon Enhancer es un plugin integral para Hytale que transforma cada arma en un objeto único, mejorado aleatoriamente con propiedades poderosas. Cuando fabricas o obtienes un arma, automáticamente recibe afijos aleatorios (bonificaciones de estadísticas) basados en su nivel de rareza y tipo de material, creando un sistema de botín atractivo similar a los RPG de acción como Diablo.
Este plugin añade profundidad al combate al introducir un sistema de rareza con cinco niveles (COMÚN, MÁGICO, RARO, ÉPICO y LEGENDARIO), cada uno con diferentes números de afijos y límites de valor. Las armas de mayor rareza pueden tener más afijos y alcanzar valores de estadísticas más altos, haciendo que las armas legendarias sean realmente poderosas y deseadas.
Además, el plugin cuenta con un sistema de balanceo basado en materiales donde los materiales de menor nivel (como el Cobre) tienen valores de afijo reducidos en comparación con los materiales de mayor nivel (como el Hierro o el Acero), incluso cuando comparten la misma rareza. Esto crea una progresión natural y asegura que las mejoras de materiales se sientan significativas.
El sistema es completamente configurable, permitiendo a los administradores del servidor equilibrar los valores de afijo, ajustar las distribuciones de rareza, personalizar los multiplicadores de materiales y ajustar cada aspecto del sistema de mejora para que coincida con el estilo de juego de su servidor.

🎮 Lo Que Hace Este Plugin

Weapon Enhancer mejora automáticamente cada arma que fabricas u obtienes con propiedades aleatorias. Cada arma recibe:
– Un nivel de rareza aleatorio (COMÚN a LEGENDARIO)
– Múltiples afijos aleatorios basados en la rareza
– Bonificaciones de estadísticas que afectan el combate (daño, golpes críticos, robo de vida, etc.)
– Escalado de valores basado en materiales (los materiales de menor nivel tienen valores de afijo más bajos)
– Retroalimentación visual que muestra las estadísticas y cálculos de daño de tu arma

El plugin se integra perfectamente con el sistema de combate de Hytale, modificando el daño en tiempo real basado en los afijos de tu arma. Verás los números de daño final mostrados en los enemigos, incluyendo todos los modificadores y golpes críticos, dándote una retroalimentación clara sobre la efectividad de tu arma.

✨ Mejora Automática

Las armas reciben afijos automáticamente cuando:
– **Se fabrican** en cualquier estación de fabricación (incluyendo el Yunque del Herrero)
– **Se recogen** de cofres, botines, o se encuentran en el suelo
– **Se obtienen** de cualquier fuente que añada un arma a tu inventario

Recibirás un mensaje de notificación cuando un arma sea mejorada, informándote si fue fabricada o encontrada.

🚫 Elementos Excluidos

Algunos elementos están excluidos de la mejora para mantener el equilibrio del juego:
– **Flechas** – Munición de proyectiles
– **Bombas** – Elementos explosivos
– **Tótems** – Elementos de utilidad especiales
– **Escudos** – Equipamiento defensivo

Estos elementos no recibirán afijos, manteniendo el sistema de mejora enfocado en las armas de combate.

📋 Comandos

`/weaponstats` o `/wstats`

Ver estadísticas detalladas de tu arma equipada actualmente. Este comando muestra:
– El nivel de rareza de tu arma
– Todos los afijos y sus valores actuales
– Desglose de estadísticas formateado

Uso: Simplemente escribe `/weaponstats` o `/wstats` mientras sostienes un arma para ver sus propiedades.

`/weaponenhancer` o `/wenhancer` o `/weaponregen`

Regenera todas las propiedades de tu arma equipada. Este comando:
– Aleatoriza completamente la rareza y los afijos de tu arma
– Requiere un número configurable de elementos (por defecto: 20, configurable a través de `requiredCopperIngots` en `config.json`)
– Utiliza un tipo de elemento configurable (por defecto: Lingotes de Cobre, configurable a través de `regenerationItemId` en `config.json`)
– También se puede usar para aplicar afijos a armas que no tienen ninguno
– Puede ser deshabilitado a través de la configuración si prefieres solo la mejora automática

Uso: Sostén el arma que deseas regenerar y escribe `/weaponenhancer`. Asegúrate de tener suficientes de los elementos requeridos en tu inventario. El tipo de elemento y la cantidad pueden ser personalizados en `config.json`.
Nota: Este comando puede ser deshabilitado en el archivo de configuración, haciendo que la generación de afijos dependa únicamente de la fabricación y la recogida de elementos.

🎲 Mejora Aleatoria de Armas

– **Mejora Automática**: Cada arma fabricada o recogida recibe automáticamente propiedades aleatorias
– **5 Niveles de Rareza**: COMÚN, MÁGICO, RARO, ÉPICO y LEGENDARIO
– **Múltiples Afijos**: Cada nivel de rareza puede tener un número configurable de afijos aleatorios
– **Propiedades Únicas**: Cada arma es única con estadísticas aleatorias
– **Escalado Basado en Materiales**: Los materiales de menor nivel tienen valores de afijo reducidos en comparación con los materiales de mayor nivel
– **Límites de Valor por Rareza**: Cada nivel de rareza tiene un límite de valor máximo que limita cuán altos pueden ser los valores de afijo:
  – **COMÚN**: Puede alcanzar hasta el 30% de los valores máximos de afijo
  – **MÁGICO**: Puede alcanzar hasta el 50% de los valores máximos de afijo
  – **RARO**: Puede alcanzar hasta el 70% de los valores máximos de afijo
  – **ÉPICO**: Puede alcanzar hasta el 85% de los valores máximos de afijo
  – **LEGENDARIO**: Puede alcanzar el 100% de los valores máximos de afijo (sin límite)

🔧 Balanceo Basado en Materiales

El plugin cuenta con un avanzado sistema de balanceo basado en materiales que asegura una progresión natural a través de los niveles de materiales:
– **Materiales de Menor Nivel** (Crudo, Madera, Hueso, Cobre): Reciben el 30-50% de los valores base de afijo
– **Materiales de Nivel Medio** (Bronce, Hierro): Reciben el 65-80% de los valores base de afijo
– **Materiales de Alto Nivel** (Acero, Plata, Oro): Reciben el 90-95% de los valores base de afijo
– **Materiales de Fin de Juego** (Mithril, Adamantita, Cobalto, etc.): Reciben el 100% de los valores base de afijo
Ejemplo: Una espada de Cobre con rareza RARA tendrá valores de afijo más bajos que una espada de Hierro con la misma rareza RARA, creando una progresión significativa y haciendo que las mejoras de materiales se sientan gratificantes.
El multiplicador de material se aplica primero, luego se aplica el límite de rareza al rango ajustado por material. Este sistema dual asegura una progresión equilibrada mientras mantiene la emoción de encontrar armas de alta rareza.

⚔️ Afijos de Armas

Las armas pueden recibir varios afijos que mejoran su efectividad en combate:
– **Poder**: Aumenta el porcentaje de daño
– **Golpe Crítico**: Aumenta el multiplicador de daño crítico
– **Oportunidad Crítica**: Aumenta la posibilidad de realizar golpes críticos
– **Robo de Vida**: Restaura salud basada en el daño infligido
– **Carga de Energía**: Genera energía por golpe
– **Durabilidad**: Aumenta la durabilidad del arma

🎯 Características de Combate

– **Modificación de Daño**: Los afijos modifican el daño base del arma en tiempo real
– **Golpes Críticos**: Oportunidad de golpe crítico y daño configurables
– **Robo de Vida**: Restauración de salud basada en el daño infligido
– **Generación de Energía**: Las armas pueden generar energía por golpe
– **Mensajes de Daño Detallados**: Ve exactamente cómo tus afijos afectan el daño (configurable)
– **Visualización del Daño Final**: Los números de daño en los enemigos muestran el daño final calculado incluyendo todos los modificadores

⚙️ Configuración

El plugin crea archivos de configuración en `plugins/weapon-enhancer/` en la primera ejecución:

`config.json`

Archivo de configuración principal:
– `enableDamageMessages`: Habilitar/deshabilitar mensajes de daño en el chat (por defecto: `true`)
– `requiredCopperIngots`: Número de elementos necesarios para la regeneración (por defecto: `20`)
– `regenerationItemId`: ID del elemento requerido para el comando `/weaponenhancer` (por defecto: `”Ingredient_Bar_Copper”`)
– `enableRegenerationCommand`: Habilitar/deshabilitar el comando `/weaponenhancer` (por defecto: `true`)

Puedes personalizar qué elemento se requiere para la regeneración de armas cambiando el valor de `regenerationItemId`. Por ejemplo, para requerir lingotes de oro en lugar de lingotes de cobre, configúralo a `”Ingredient_Bar_Gold”` (o cualquier otro ID de elemento válido de Hytale).

`affix.json`

Configura los valores mínimos/máximos para cada tipo de afijo. Consulta `AFFIX_CONFIG_README.md` para más detalles.

`rarity.json`

Configura el número de afijos y límites de valor por nivel de rareza:
– **COMÚN**: 1 afijo, límite de valor del 30% (0.30)
– **MÁGICO**: 2 afijos, límite de valor del 50% (0.50)
– **RARO**: 3 afijos, límite de valor del 70% (0.70)
– **ÉPICO**: 4 afijos, límite de valor del 85% (0.85)
– **LEGENDARIO**: 5 afijos, límite de valor del 100% (1.0)

El `maxValueCap` determina el porcentaje máximo del rango de valor de un afijo que se puede alcanzar. Por ejemplo, si un afijo tiene un rango de 0.1 a 0.5:
– Un arma COMÚN puede alcanzar hasta 0.1 + (0.5 – 0.1) × 0.30 = 0.22
– Un arma LEGENDARIA puede alcanzar el máximo completo de 0.5

`material.json`

Configura los multiplicadores de materiales que determinan qué porcentaje de los valores base de afijo puede alcanzar cada nivel de material:
– **Crudo/Madera/Hueso**: multiplicador del 30% (0.3)
– **Cobre**: multiplicador del 50% (0.5)
– **Bronce**: multiplicador del 65% (0.65)
– **Hierro**: multiplicador del 80% (0.8)
– **Acero**: multiplicador del 90% (0.9)
– **Plata/Oro**: multiplicador del 95% (0.95)
– **Mithril y superiores**: multiplicador del 100% (1.0) – sin reducción

El multiplicador de material se aplica al rango base de afijo antes de que se aplique el límite de rareza. Esto asegura que la progresión de materiales se sienta significativa y equilibrada. Consulta `MATERIAL_CONFIG_README.md` para ejemplos detallados y consejos de balanceo.

`messages.json`

Localización de mensajes completamente personalizable. Todos los mensajes pueden ser traducidos a cualquier idioma. Incluye mensajes basados en contexto:
– `weaponMessages.crafted`: Mensaje mostrado cuando se fabrica un arma
– `weaponMessages.picked_up`: Mensaje mostrado cuando se encuentra/recoge un arma
– `weaponMessages.command`: Mensaje mostrado cuando un arma es regenerada a través de un comando

📦 Instalación

1. Descarga el último archivo JAR de la página de lanzamientos
2. Coloca el archivo JAR en el directorio `plugins/` de tu servidor Hytale
3. Reinicia tu servidor
4. Los archivos de configuración se generarán automáticamente en `plugins/weapon-enhancer/`

📝 Archivos de Configuración

El plugin crea automáticamente los siguientes archivos de configuración en la primera ejecución:
– `config.json` – Configuraciones principales
– `affix.json` – Valores mínimos/máximos de afijos
– `rarity.json` – Conteo de afijos por rareza
– `material.json` – Multiplicadores de materiales
– `messages.json` – Localización de mensajes
– `AFFIX_CONFIG_README.md` – Guía detallada de configuración de afijos
– `RARITY_CONFIG_README.md` – Guía detallada de configuración de rareza
– `MATERIAL_CONFIG_README.md` – Guía detallada de multiplicadores de materiales

Todos los archivos de configuración están bien documentados y son fáciles de personalizar.

🎮 Uso

Comenzando

1. Fabrica cualquier arma o recógela de un cofre o del suelo
2. El arma recibirá automáticamente propiedades aleatorias basadas en su material y rareza
3. Verás un mensaje de notificación cuando el arma sea mejorada
4. Usa `/weaponstats` para ver las propiedades de tu arma
5. Usa `/weaponenhancer` para volver a lanzar las propiedades del arma (costo de elementos configurables) o para aplicar afijos a un arma que no tiene ninguno

Personalizando Tu Servidor

1. Edita `plugins/weapon-enhancer/config.json` para ajustar configuraciones principales
2. Edita `plugins/weapon-enhancer/affix.json` para equilibrar los valores de afijo
3. Edita `plugins/weapon-enhancer/rarity.json` para cambiar el conteo de afijos
4. Edita `plugins/weapon-enhancer/material.json` para ajustar los multiplicadores de materiales
5. Edita `plugins/weapon-enhancer/messages.json` para traducir mensajes
6. Reinicia tu servidor o usa `/reload` (si es compatible)

🆕 Actualizaciones Recientes

– **Sistema de Balanceo Basado en Materiales**: Los materiales de menor nivel ahora tienen valores de afijo reducidos en comparación con los materiales de mayor nivel, creando una progresión natural y haciendo que las mejoras de materiales sean significativas
– **Mejora Automática para Todas las Fuentes**: Las armas ahora reciben afijos cuando se recogen de cofres, del suelo o de cualquier otra fuente, no solo cuando se fabrican
– **Exclusión Inteligente de Elementos**: Flechas, bombas, tótems y escudos son automáticamente excluidos de la mejora
– **Control de Comandos**: Opción para deshabilitar el comando de regeneración, confiando solo en la mejora automática
– **Mejor Compatibilidad**: Funciona sin problemas con el Yunque del Herrero y todas las estaciones de fabricación…