TeroGenshin / GenshinMode

TeroGenshin — Elemental Reactions for Minecraft (Spigot/Paper)
Version: 13.0 · MC: 1.17 – 1.19.4

This plugin adds a full elemental system inspired by Genshin Impact: elemental states, configurable reaction damage, informative holograms, armor/artifact effects, ambient application by environment, and multiple performance optimizations.

Debajo encontrarás la misma guía en Español.

---

## English

### What does it do?
- 7 Elements: Anemo, Cryo, Hydro, Pyro, Geo, Electro, Dendro.
- 15+ Reactions: Freeze, Crystallize (pulse AOE), Melt, Electro-Charged (periodic ticks), Burning (DoT), Overload, Superconduct (debuffs), Swirl (spreads), Vaporize; Dendro set: Quicken (state), Aggravate, Spread, Bloom (seed/core), Hyperbloom (homing missiles), Burgeon (instant explosion).
- Lunar & Estelar Modifiers: Weapons can apply these unique states to enhance elemental reactions (e.g. Lunar Freeze) with extra damage multipliers and custom gradient holograms.
- Customizable damage formulas per reaction (optional), with element variables and extra reaction-specific variables.
- Holograms for states, damage and reactions; formats and colors customizable; rendering optimized.
- “Ambient” system: applies elements from environment (rain/water, lava/fire, snow, plants/minerals, lightning, etc.).
- Armor vs Artifact effects: enable one system and use lores/slots to grant bonuses.
- MythicMobs shields integration (optional): Features elemental weaknesses and can strictly require Lunar or Estelar damage.
- Performance-minded: radii/periods, entity filters, cleanup, chunk-based optimization.

### Compatibility
- Spigot/Paper 1.17 – 1.19.4
- Java 17 recommended
- No hard dependencies (MythicMobs optional for shields integration)

### Quick install
1) Drop the JAR into `plugins/`.
2) Start the server to generate configs.
3) Tweak `config.yml` and `items.yml`.
4) Run `/genshin reload`.

### Files you will edit
- `src/main/resources/config.yml` — core behavior: states, reactions, multipliers, particles, ambient, holograms, optimization, armor/artifact toggles.
- `src/main/resources/items.yml` — registered items (by display name) and optional types.
- `src/main/resources/placeholders.yml` — text formats and color codes for placeholders/holograms.
- `src/main/resources/bonuselementperclass.yml` — per-class bonuses (if you use MMOCore level/class integration).
- `src/main/resources/mythicmobsshields/guia1.yml` — example shields for MythicMobs.

### Key configuration (overview)
- `estados.*`: duration per element state (ticks).
- `hologramas.*`: enable/format holograms for states, damage and reactions; distance-based optimization.
- `reacciones.cooldown-ticks`, `reacciones.cooldown-dendro-ticks`: global cooldowns for standard and dendro reactions.
- `reacciones.multipliers.*`: per-reaction damage multipliers (some have `-jugadores` for player damage).
- `parametros.*`: reaction-specific knobs (radii, intervals, particle density, missile speed, etc.).
- `ambient.*`: environment-driven element application (rain, water blocks, lava, snow, plants, rocks, lightning…).
- `efects.armor` / `efects.artifact`: choose one effect system to enable.
- `armor.*` / `artifact.*`: lore lines, required slots, bonus patterns and thresholds.
- `formulas.*`: toggle and define custom formulas per reaction.

### Custom damage formulas (optional)
- Toggle with `formulas.ModifyFormulas: true`. If a reaction formula is missing, default math is used.
- Supported operators: `+ - * /` and parentheses.
- Variables (case-insensitive):
- Elements: `pyro`, `hydro`, `cryo`, `electro`, `dendro`, `anemo`, `geo` (these represent the current applied amounts).
- `multiplicador`: maps to `reacciones.multipliers.<reaction>`; for player damage, `-jugadores` is used when available.
- Amount aliases: `cantidadhydro`, `cantidad-hydro`, etc.
- Compat aliases: `a`, `b`, `suma` (for legacy configs).
- Extras:
- Crystallize: `multiplicador_pulso` (alias `multiplicador-pulso`).
- Aggravate: `nuevoelectro` (aliases: `electro_nuevo`, `electro-nuevo`).
- Spread: `nuevodendro` (aliases: `dendro_nuevo`, `dendro-nuevo`).

Example active in default pack:
```yml
formulas:
ModifyFormulas: true
vaporizado: "((hydro + pyro) / 2) * multiplicador"
sobreflorecimiento: "(((dendro + hydro) / 2) + electro) * multiplicador"
```

### Commands & permissions
Base: `/genshin`
- `reload` — Reload configs. Perm: `terogenshin.reload`
- `registrar` — Register the item in your main hand into `items.yml` (by display name). Perm: `terogenshin.registrar`
- `element <player> <element> <amount> <time>` — Apply a state to a player for a duration (`10s`, `100t`). Perm: `terogenshin.element`
- Elements: `anemo, cryo, hydro, pyro, geo, electro, dendro`
- `putelement <element> <target|area|coneinfrontme> <distance|radius> <entities|player>` — Apply elements by mode. Perm: `terogenshin.putelement`
- `give <itemId> <itemType> [player]` — Give an item by `items.yml` ID and chosen type (sword, bow, axe, trident, staff or any Bukkit `Material`). OP/Console only
- `removeholo [radius]` — Remove plugin holograms nearby or within radius. Perm: `terogenshin.removeholo` or OP
- `armorstatus` — Show armor set effects (if `efects.armor=true`). Perm: `terogenshin.armorstatus`
- `artifactstatus` — Show artifact effects (if `efects.artifact=true`). Perm: `terogenshin.artifactstatus`

### Elements & reactions
- Elements: `Anemo, Cryo, Hydro, Pyro, Geo, Electro, Dendro`.
- Classic reactions: Freeze, Crystallize (pulse AOE + element spread), Melt, Electro-Charged (periodic damage + short slowness), Burning (DoT), Overload, Superconduct (debuffs), Swirl (spreads), Vaporize.
- Dendro set:
- Quicken: temporary state on the target.
- Aggravate: AOE damage computed from `nuevoelectro` while Quicken is active.
- Spread: AOE damage from `nuevodendro`, also applies Dendro nearby.
- Bloom: safe seed/core with hologram and timed explosion (separate multipliers for players vs entities).
- Hyperbloom: homing missiles (configurable radii/particles).
- Burgeon: instant explosion.
- Lunar & Estelar Reactions: Hitting an entity affected by Lunar/Estelar transforms standard reactions into their Lunar/Estelar variants, multiplying damage and triggering custom holograms.

### Armor or Artifact effects
- Only one can be active (`efects.armor` or `efects.artifact`).
- Armor: requires all 4 pieces to contain exact lore lines.
- Artifact: a single inventory item with the lore is enough; can also use fixed slots (9..13) and configure a bonus pattern.

### Holograms
- Configurable format, color and visibility per type (state, apply, damage, reaction).
- Distance-based render optimization to avoid sending packets for far entities/chunks.
- Cleanup tool: `/genshin removeholo [radius]`.

### Ambient system
- Apply elements based on environment: rain/water, lava/fire, snow, plants, rocks, lightning.
- Tune the per-tick amounts and thresholds in `config.yml` under `ambient.*`.

### Performance tips
- Use `hologramas.optimize.*` to limit rendering to nearby chunks.
- Increase tick periods if TPS is low.
- Keep AOE radii reasonable.
- Filter entities and players when possible (`parametros.*` of each reaction).

### Placeholders & formatting
- Text formatting and color codes are in `placeholders.yml`.
- You can change prefix/suffix, color per element, and hologram lines.

### MythicMobs shields (optional)
- Examples live under `src/main/resources/mythicmobsshields/guia1.yml`.
- Enable and tune in `config.yml` -> `shields.*`.

### Troubleshooting
- No damage or no reaction? Check `cooldown` values and multipliers; ensure elements are applied and not immediately overridden by Ambient functions.
- Formulas enabled but no change? Ensure `formulas.ModifyFormulas: true` and the reaction key matches exactly (lowercase keys as in the examples).
- Holograms missing or not visible? Verify `hologramas.enable.*` and optimization distance, and ensure you’re near the target.
- Artifact/Armor effects not triggering? Only one system can be active; check lores and required slots.

### FAQ
- Different formula for players? Same formula is used, but `multiplicador` swaps to `-jugadores` when present.
- Do I have to use `a/b/suma`? No. Prefer explicit element names: `hydro`, `pyro`, etc.
- Is MythicMobs required? No. Only for shields integration examples.

---

## Español

### ¿Qué hace?
- 7 Elementos: Anemo, Cryo, Hydro, Pyro, Geo, Electro, Dendro.
- 15+ Reacciones: Congelado, Cristalizado (AOE por pulsos), Derretido, Electrocargado (ticks periódicos), Quemadura (Daño en el tiempo), Sobrecarga, Superconductor (debuffs), Torbellino (propaga), Vaporizado; set Dendro: Aceleración (estado), Intensificación, Propagación, Florecimiento (semilla/núcleo), Sobreflorecimiento (misiles teledirigidos), Crepitar (explosión inmediata).
- Modificadores Lunar y Estelar: Las armas pueden aplicar estos estados únicos para potenciar las reacciones elementales (ej. Congelado Lunar) aportando multiplicadores de daño extra y hologramas con degradados personalizados.
- Fórmulas de daño personalizables por reacción (opcional), con variables por elemento y extras específicos por reacción.
- Hologramas para estados, daño y reacciones; formatos y colores personalizables; render optimizado.
- Sistema “ambiental”: aplica elementos según el entorno (lluvia/agua, lava/fuego, nieve, plantas/minerales, rayos, etc.).
- Efectos por Armadura o por Artefacto: habilita un sistema y usa lores/slots para dar bonos.
- Integración opcional con MythicMobs para escudos, que incluye debilidades elementales y mecánicas que pueden requerir daño estrictamente Lunar o Estelar.
- Rendimiento: radios/periodos, filtros de entidades, limpieza y optimización por chunks.

### Compatibilidad
- Spigot/Paper 1.17 – 1.19.4
- Java 17 recomendado
- Sin dependencias obligatorias (MythicMobs opcional para escudos)

### Instalación rápida
1) Coloca el JAR en `plugins/`.
2) Inicia el servidor para generar los archivos.
3) Ajusta `config.yml` e `items.yml`.
4) Ejecuta `/genshin reload`.

### Archivos a editar
- `src/main/resources/config.yml` — comportamiento principal: estados, reacciones, multiplicadores, partículas, ambient, hologramas, optimización, toggles de armadura/artefacto.
- `src/main/resources/items.yml` — registro de ítems (por display name) y tipos opcionales.
- `src/main/resources/placeholders.yml` — formatos de texto y colores de placeholders/hologramas.
- `src/main/resources/bonuselementperclass.yml` — bonos por clase (si usas integración con MMOCore).
- `src/main/resources/mythicmobsshields/guia1.yml` — ejemplos de escudos para MythicMobs.

### Configuración clave (resumen)
- `estados.*`: duración por estado (ticks).
- `hologramas.*`: formato/visibilidad de hologramas de estado, daño y reacción; optimización por distancia.
- `reacciones.cooldown-ticks`, `reacciones.cooldown-dendro-ticks`: cooldown global estándar y para dendro.
- `reacciones.multipliers.*`: multiplicadores por reacción (algunas con variante `-jugadores`).
- `parametros.*`: parámetros específicos (radios, intervalos, densidad de partículas, velocidad de misiles, etc.).
- `ambient.*`: aplicación ambiental (lluvia, agua, lava, nieve, plantas, rocas, rayos…).
- `efects.armor` / `efects.artifact`: elige qué sistema de efectos activar.
- `armor.*` / `artifact.*`: líneas de lore, slots requeridos, patrón de bonos y umbrales.
- `formulas.*`: activar/definir fórmulas personalizadas por reacción.

### Fórmulas de daño personalizables (opcional)
- Activa con `formulas.ModifyFormulas: true`. Si no hay fórmula para una reacción, se usa el cálculo por defecto.
- Operadores soportados: `+ - * /` y paréntesis.
- Variables (insensibles a mayúsculas/minúsculas):
- Elementos: `pyro`, `hydro`, `cryo`, `electro`, `dendro`, `anemo`, `geo` (representan las cantidades aplicadas).
- `multiplicador`: enlaza con `reacciones.multipliers.<reaccion>`; para daño a jugadores usa `-jugadores` cuando exista.
- Aliases de cantidad: `cantidadhydro`, `cantidad-hydro`, etc.
- Compatibilidad: `a`, `b`, `suma`.
- Extras:
- Cristalizado: `multiplicador_pulso`.
- Intensificación: `nuevoelectro`.
- Propagación: `nuevodendro`.

Ejemplo activo por defecto:
```yml
formulas:
ModifyFormulas: true
vaporizado: "((hydro + pyro) / 2) * multiplicador"
sobreflorecimiento: "(((dendro + hydro) / 2) + electro) * multiplicador"
```

### Comandos y permisos
Comando base: `/genshin`
- `reload` — Recarga la configuración. Permiso: `terogenshin.reload`
- `registrar` — Registra en `items.yml` el objeto de tu mano por su nombre visible. Permiso: `terogenshin.registrar`
- `element <jugador> <elemento> <cantidad> <tiempo>` — Aplica un estado a un jugador por una duración (`10s`, `100t`). Permiso: `terogenshin.element`
- Elementos: `anemo, cryo, hydro, pyro, geo, electro, dendro`
- `putelement <elemento> <target|area|coneinfrontme> <distancia|radio> <entities|player>` — Aplica elementos según modo. Permiso: `terogenshin.putelement`
- `give <idItem> <tipoItem> [jugador]` — Da un ítem por ID de `items.yml` y tipo elegido (espada, arco, hacha, tridente, vara o cualquier `Material`). Solo OP/Consola
- `removeholo [radio]` — Elimina los hologramas del plugin cerca o dentro de un radio. Permiso: `terogenshin.removeholo` o ser OP
- `armorstatus` — Muestra efectos de armadura (si `efects.armor=true`). Permiso: `terogenshin.armorstatus`
- `artifactstatus` — Muestra efectos de artefactos (si `efects.artifact=true`). Permiso: `terogenshin.artifactstatus`

### Elementos y reacciones
- Elementos: `Anemo, Cryo, Hydro, Pyro, Geo, Electro, Dendro`.
- Reacciones clásicas: Congelado, Cristalizado (AOE por pulsos + propaga elemento), Derretido, Electrocargado (daño periódico + breve lentitud), Quemadura (DoT), Sobrecarga, Superconductor (debuffs), Torbellino (propaga), Vaporizado.
- Conjunto Dendro:
- Aceleración: estado temporal en el objetivo.
- Intensificación: daño AOE basado en `nuevoelectro` con Aceleración activa.
- Propagación: daño AOE basado en `nuevodendro`, aplica Dendro a cercanos.
- Florecimiento: semilla/núcleo con holograma y explosión al expirar (multiplicadores separados para jugadores vs entidades).
- Sobreflorecimiento: misiles teledirigidos (radios/partículas configurables).
- Crepitar: explosión inmediata.
- Reacciones Lunares y Estelares: Atacar a una entidad afectada por el estado Lunar o Estelar transforma las reacciones clásicas en sus variantes mejoradas, multiplicando su daño final y mostrando hologramas exclusivos.

### Armadura o Artefactos
- Solo uno puede estar activo (`efects.armor` o `efects.artifact`).
- Armadura: requiere que las 4 piezas contengan líneas de lore exactas.
- Artefacto: basta un objeto en inventario con el lore; también puedes usar slots fijos (9..13) y patrón de bono.

### Hologramas
- Formato, color y visibilidad configurables por tipo (estado, aplicación, daño, reacción).
- Optimización de render por distancia para evitar enviar paquetes a chunks lejanos.
- Limpieza: `/genshin removeholo [radio]`.

### Sistema ambiental
- Aplica elementos según entorno: lluvia/agua, lava/fuego, nieve, plantas, rocas, rayos.
- Ajusta las cantidades por tick y umbrales en `config.yml` bajo `ambient.*`.

### Rendimiento
- Usa `hologramas.optimize.*` para limitar render a chunks cercanos.
- Aumenta periodos de tick si los TPS bajan.
- Mantén radios de AOE razonables.
- Filtra entidades y jugadores cuando sea posible (`parametros.*`).

### Placeholders y formato
- Los formatos de texto y códigos de color están en `placeholders.yml`.
- Puedes cambiar prefijos/sufijos, color por elemento y líneas de holograma.

### MythicMobs (opcional)
- Ejemplos en `src/main/resources/mythicmobsshields/guia1.yml`.
- Activa y ajusta en `config.yml` -> `shields.*`.

### Solución de problemas
- ¿No hay daño o no reacciona? Revisa `cooldown` y `multipliers`; asegúrate de que los elementos se apliquen y no se sobrescriban por el sistema ambiental.
- ¿Fórmulas activadas pero sin efecto? Asegúrate de `formulas.ModifyFormulas: true` y que la clave de la reacción coincide exactamente (minúsculas como en los ejemplos).
- ¿Hologramas invisibles? Verifica `hologramas.enable.*`, la distancia de optimización y que estés cerca del objetivo.
- ¿Efectos de Artefacto/Armadura no activan? Solo uno puede estar activo; revisa los lores y slots requeridos.

### Preguntas frecuentes
- ¿Fórmula distinta para jugadores? Se usa la misma fórmula, pero `multiplicador` toma `-jugadores` cuando exista.
- ¿Debo usar `a/b/suma`? No. Es preferible usar nombres de elementos: `hydro`, `pyro`, etc.
- ¿Es obligatorio MythicMobs? No. Solo para ejemplos de escudos.

---

Made by: The_Alejo · Includes hologram optimizations and Dendro mechanics refactor.