Edupa PowerScaling

Here's the English version, ready for CurseForge.

---

**Powerscaling** transforms Minecraft into an ARPG full of legendary items and unpredictable enemies.
Every piece of equipment you find, craft, or steal receives a **Tier** that improves its attributes and enchantments, and monsters mutate with devastating abilities.
Can you climb to the top of power?

---

## 🔥 TES System (Tier Evolution System)

Every item that is not a building block receives a **Tier** (from 0 to 20+) when it appears.
Each tier adds a random combination of:

- **⚡ Stats+**: Damage, attack speed, reach, armor, toughness, luck, movement speed… and many more! (depends on item type)
- **✨ Enchantments**: The system chooses compatible enchantments for the item (or a wild one if none are compatible).
- **🛡️ Set Bonus**: Set bonuses that activate when equipping pieces of the same material.

Higher tiers shine with vivid colors (from humble gray to legendary red with obfuscated stars) and the total Power Score is displayed in the tooltip.

---

## 💎 Socket System

Combine any **TES item (tier ≥ 1)** with a material (ingots, gems, blocks) on the crafting table to insert a **Socket**.
The socket:

- Grants a **Power Score** bonus and **additional stats** depending on the material used.
- Rare materials (diamond, netherite, emerald…) give much greater bonuses than common ones.
- Changes the item name to “Base Material & Socket Material +Tier”.

---

## 🛡️ Set Bonus

When equipping several pieces of the same material (up to 5 counting the weapon), set bonuses activate.
Each piece can have its own set bonus level (1 to 4), which defines how many bonus lines it shows. Lines light up in yellow when you have enough pieces equipped.
Bonuses are random (damage, armor, speed…) but fixed for that specific piece; an iron helmet won't give the same as iron boots.

---

## 👾 Monster Mutations

Every creature (hostile or peaceful) can appear with **random mutations** that alter its attributes, size, color, and behavior.
Mutations stack and their colors blend. Available types:

### Basic (elite style)
- **Giant**: size x3, lots of health, less damage.
- **Armored**: +10 armor, speed reduction.
- **Champion**: size x1.3, red tint, +50% damage and health.
- **Elite**: size x1.5, golden tint, +100% damage, +100 health.
- **Toxic**: green tint, applies poison on hit.

### On Hit (contact effects)
*Slow Touch, Weak Touch, Blind Touch, Nausea Touch, Fatigue Touch, Harm Touch, Hunger Touch, Levitate Touch, Wither Touch, Rot Touch, Fire Touch, Drown Touch.*

### On Death (posthumous curses)
*Slow Doom, Weak Doom, Blind Doom, Nausea Doom, Fatigue Doom, Harm Doom, Hunger Doom, Levitate Doom, Wither Doom, Rot Doom, Fire Doom, Drown Doom.*

### Periodic (every X seconds)
- **Boom Burst**: explosion.
- **Skull Burst**: fires a Wither skull.
- **Ender Step**: teleportation.

### Defensive (passive)
*Iron Skin (resistance), Regrowth (regeneration), Fire Proof, Water Lungs, Shadow Skin (invisibility), Speed Runner, Strong Arm, Feather Fall, Tough Hide (absorption), Unstoppable (knockback resistance + toughness + attack speed).*

### Auras (affect players in area)
*Slow Aura, Weak Aura, Blind Aura, Nausea Aura, Fatigue Aura, Harm Aura, Hunger Aura, Levitate Aura, Wither Aura, Rot Aura, Fire Aura, Drown Aura.*
*Radius is usually 4-5 blocks; no direct contact needed.*

### Block Replacement (on death or during combat)
*Web Burst (cobwebs), Magma Trail (magma), Ice Path (ice), Water Burst (water), Lava Burst (lava), TNT Burst (TNT), Slime Burst, SoulSand Burst, Fire Burst, Sand Burst, Gravel Burst, Chaos Burst (random block).*
*Only affects the ground from the feet upward.*

### Summoning (necromancy)
*Necromancer (skeletons on death), Swarm Call (periodic zombies in combat), Pack Leader (wolves at combat start).*

### Creeper Exclusive
*Pop Rocket (instant explosion at 2 blocks), Big Boom (radius 6), Colossal Boom (radius 10 with countdown), Chunk Buster (radius 16 with countdown).*

---

## 📈 Usage Progression (Item XP)

Each TES item accumulates experience based on its type:
- **Weapons**: Souls (per kill).
- **Tools**: Works (per block broken).
- **Armor**: Survival (per damage taken).
- **Accessories**: History (per day equipped).

Upon reaching the goal, the item gains a tier and a random upgrade (enchantment, stat, or set bonus).
Requirements grow exponentially: from 50 kills for tier 1 to 1,000,000 for tier 19.
Tier 20 is only obtainable through lucky loot.

---

## 🎒 Completely Revamped Loot

- **Chests**: all their content is replaced by items from the mod’s global pool (every non-block item from all installed mods). Weights are based on Power Score: the more powerful an item, the rarer.
- **Mob drops**: automatically receive TES; elites (health ≥ 15) can drop several extra items with higher tiers.
- **Broken blocks**: their drops also go through TES (colored names).
- **Crafting**: any crafted item becomes a TES item.

---

## 💬 Dialogue & Phrases System

Monsters with mutations **speak** through temporary phrases that appear in their name (without erasing their identity). Phrases are chosen based on the mutation and situation: on spawn, on hurt, on kill, on death, and randomly every ~30 seconds.
Phrases and sounds (still placeholders) can be customized via an **external JSON file** (`config/powerscaling/phrases.json`). If it doesn't exist, default phrases are used.

---

## ⚙️ Customization

- The `phrases.json` file allows defining phrases per mutation, per mob type (hostile/peaceful), and per entity name.
- Sounds will be added in future versions (currently vanilla sounds are used).
- Each mutation's probability is in the code (0.01 by default for the new ones) and can be changed by recompiling.

---

## 📦 Compatibility

- **Forge 1.20.1** (recommended 47.4.20 or higher).
- Compatible with all mods that add items, enchantments, or mobs. The loot pool automatically detects any object.
- Respects other mods' names (mutations don't overwrite existing names; they prepend them).

---

## 🚧 Coming Soon (in development)

- **Killingspree** system (announcements and rewards for kill streaks).
- More visual mutations (particles, glow).
- **Custom sounds** for each mutation.
- **External configuration** of mutation probabilities and TES chances.

---

## ⚠️ Note

This mod is in **active alpha**. It may contain bugs. It is recommended to back up your worlds before using it.

---

## 🙏 Credits

Developed by **Edupa**
Inspired by ARPG systems like Diablo and Path of Exile.

---

sorry for missspeling or somethings english is not my navite language

**Thanks for playing!** If you find any issues or have suggestions, leave a comment on CurseForge.

Powerscaling transforma Minecraft en un ARPG lleno de objetos legendarios y enemigos impredecibles.
Cada pieza de equipo que encuentres, craftees o robes tendrá un Tier que mejora sus atributos y encantamientos, y los monstruos mutarán con habilidades devastadoras.
¿Podrás escalar hasta la cima del poder?

🔥 Sistema TES (Tier Evolution System)

Todo ítem que no sea un bloque de construcción recibe un Tier (del 0 al 20+) al aparecer.
Cada tier añade una combinación aleatoria de:

• ⚡ Estadísticas+: Daño, velocidad de ataque, alcance, armadura, dureza, suerte, velocidad de movimiento… ¡y muchas más! (depende del tipo de ítem)

• ✨ Encantamientos: El sistema elige encantamientos compatibles con el objeto (o uno salvaje si no hay compatibles).

• 🛡️ Set Bonus: Bonificaciones de conjunto que se activan al equipar piezas del mismo material.

Los tiers más altos brillan con colores vivos (desde gris humilde hasta rojo legendario con estrellas ofuscadas) y el Power Score total se muestra en el tooltip.

💎 Sistema de Socket

Combina cualquier ítem TES (tier ≥ 1) con un material (lingotes, gemas, bloques) en la mesa de crafteo para insertar un Socket.
El socket:

• Otorga un bono de Power Score y estadísticas adicionales según el material usado.

• Materiales raros (diamante, netherite, esmeralda…) dan bonos mucho mayores que los comunes.

• Cambia el nombre del objeto a “Material base & Material socket +Tier”.

🛡️ Set Bonus

Cuando equipas varias piezas del mismo material (hasta 5 contando el arma), se activan bonificaciones de conjunto.
Cada pieza puede tener su propio nivel de set bonus (1 a 4), que define cuántas líneas de bonificación muestra. Las líneas se iluminan en amarillo cuando tienes suficientes piezas equipadas.
Los bonos son aleatorios (daño, armadura, velocidad…) pero fijos para esa pieza; un casco de hierro no dará lo mismo que unas botas de hierro.

👾 Mutaciones de Monstruos

Cada criatura (hostil o pacífica) puede aparecer con mutaciones aleatorias que alteran sus atributos, tamaño, color y comportamiento.
Las mutaciones se apilan y sus colores se mezclan. Tipos disponibles:

Básicas (estilo élite)

• Giant: tamaño x3, mucha vida, menos daño.

• Armored: +10 armadura, reducción de velocidad.

• Champion: tamaño x1.3, tinte rojo, +50% daño y vida.

• Elite: tamaño x1.5, tinte dorado, +100% daño, +100 vida.

• Toxic: tinte verde, aplica veneno al golpear.

Al golpear (efectos al contacto)

Slow Touch, Weak Touch, Blind Touch, Nausea Touch, Fatigue Touch, Harm Touch, Hunger Touch, Levitate Touch, Wither Touch, Rot Touch, Fire Touch, Drown Touch.

Al morir (maldiciones póstumas)

Slow Doom, Weak Doom, Blind Doom, Nausea Doom, Fatigue Doom, Harm Doom, Hunger Doom, Levitate Doom, Wither Doom, Rot Doom, Fire Doom, Drown Doom.

Periódicas (cada X segundos)

• Boom Burst: explosión.

• Skull Burst: dispara una calavera de Wither.

• Ender Step: teletransporte.

Defensivas (pasivas)

Iron Skin (resistencia), Regrowth (regeneración), Fire Proof, Water Lungs, Shadow Skin (invisibilidad), Speed Runner, Strong Arm, Feather Fall, Tough Hide (absorción), Unstoppable (resistencia al retroceso + dureza + velocidad de ataque).

Auras (afectan a jugadores en área)

Slow Aura, Weak Aura, Blind Aura, Nausea Aura, Fatigue Aura, Harm Aura, Hunger Aura, Levitate Aura, Wither Aura, Rot Aura, Fire Aura, Drown Aura.
*El radio suele ser de 4-5 bloques; no necesitan contacto directo.*

Reemplazo de bloques (al morir o durante combate)

Web Burst (telarañas), Magma Trail (magma), Ice Path (hielo), Water Burst (agua), Lava Burst (lava), TNT Burst (TNT), Slime Burst, SoulSand Burst, Fire Burst, Sand Burst, Gravel Burst, Chaos Burst (bloque aleatorio).
Solo afectan al suelo desde los pies hacia arriba.

Invocación (necromancia)

Necromancer (esqueletos al morir), Swarm Call (zombies periódicos en combate), Pack Leader (lobos al iniciar combate).

Exclusivas de Creepers

Pop Rocket (explosión instantánea a 2 bloques), Big Boom (radio 6), Colossal Boom (radio 10 con cuenta atrás), Chunk Buster (radio 16 con cuenta atrás).

📈 Progresión por Uso (XP de objeto)

Cada objeto TES acumula experiencia según su tipo:

• Armas: Souls (por cada muerte).

• Herramientas: Works (por bloque roto).

• Armaduras: Survival (por daño recibido).

• Accesorios: History (por días equipado).

Al alcanzar la meta, el objeto sube un tier y gana una mejora adicional (encantamiento, estadística o set bonus).
Los requisitos crecen exponencialmente: de 50 kills para tier 1 a 1.000.000 para tier 19.
El tier 20 solo se obtiene mediante loot afortunado.

🎒 Loot Totalmente Renovado

• Cofres: todo su contenido es reemplazado por ítems del pool global del mod (todos los objetos no-bloque de todos los mods instalados). Los pesos se basan en el Power Score: cuanto más poderoso es un ítem, menos frecuente es.

• Drops de mobs: reciben TES automáticamente; los élites (vida ≥ 15) pueden soltar varios ítems extra y con tiers más altos.

• Bloques rotos: sus drops también pasan por TES (nombres de colores).

• Crafteo: cualquier objeto fabricado se convierte en un objeto TES.

💬 Sistema de Diálogos y Frases

Los monstruos con mutaciones hablan mediante frases temporales que aparecen en su nombre (sin borrar su identidad). Las frases se eligen según la mutación y la situación: al aparecer, al recibir daño, al matar, al morir y aleatoriamente cada ~30 segundos.
Las frases y los sonidos (aún placeholders) pueden personalizarse mediante un archivo JSON externo (config/powerscaling/phrases.json). Si no existe, se usan frases por defecto.

⚙️ Personalización

• El archivo phrases.json permite definir frases por mutación, por tipo de mob (hostil/pacífico) y por nombre de entidad.

• Los sonidos se añadirán en futuras versiones (actualmente se usan sonidos vanilla).

• Las probabilidades de cada mutación están en el código (0.01 por defecto para las nuevas) y pueden cambiarse recompilando.

📦 Compatibilidad

• Forge 1.20.1 (recomendada 47.4.20 o superior).

• Compatible con todos los mods que añadan ítems, encantamientos o mobs. El pool de loot detecta automáticamente cualquier objeto.

• Respeta los nombres de otros mods (las mutaciones no sobrescriben nombres existentes; se añaden delante).

🚧 Próximamente (en desarrollo)

• Sistema de Killingspree (anuncios y recompensas por rachas de muertes).

• Más mutaciones visuales (partículas, brillo).

• Sonidos personalizados para cada mutación.

• Configuración externa de probabilidades de mutaciones y chances de TES.

⚠️ Nota

Este mod está en alpha activa. Puede contener bugs. Se recomienda hacer copias de seguridad de los mundos antes de usarlo.