ZRing 1.0.2

[h1]ZRing — Cursed ring[/h1]

by madz200 — youtube.com/@madz200

[h2]🇪🇸 ESPAÑOL[/h2]

[h3]Descripción[/h3]

Plugin dedicado a agregar un anillo maldito multi-tier a tu servidor: un ítem legendario que castiga tanto como recompensa. El jugador que se lo pone gana bendiciones poderosas (más experiencia, más alcance, encantamientos extra, acceso al ender chest) a cambio de siete maldiciones reales que cambian por completo cómo se juega mientras lo lleva puesto — más daño recibido, menos daño a monstruos, insomnio permanente, fuego que no se apaga, y el anillo no se puede sacar del inventario salvo rompiendo el pacto con un ítem especial.

No es un ítem decorativo: cada maldición y cada bendición está implementada como lógica real de gameplay, no como texto en el lore.

[h3]✦ Las 7 Maldiciones + 1 Bendición (por tier)[/h3]

La única forma de librarse del pacto es usando la Lágrima de Redención, un ítem especial que rompe la maldición permanentemente al usarlo (con confirmación — no se puede deshacer).

[h3]🔧 Cómo consigue el ítem el jugador (3 modos, automáticos)[/h3]

ZRing detecta solo qué tenés instalado y elige de dónde saca los ítems del anillo — no hace falta configurar nada a mano salvo que quieras forzar un modo:

1. Con MythicMobs → usa tus ítems de MythicMobs.
2. Sin MythicMobs pero con MMOItems → usa tus ítems de MMOItems.
3. Sin ninguno de los dos instalado → el plugin genera sus propios ítems y sus propias recetas de mesa de crafteo, 100% autocontenido. Nunca te vas a quedar sin el anillo por no tener otro plugin instalado.

[h3]🛠️ Recetas de mesa de crafteo (modo autónomo)[/h3]

Cuando ZRing genera sus propios ítems, también registra 5 recetas reales en la mesa de crafteo vanilla — visibles como sugerencia en el recetario del jugador apenas tiene los ingredientes:

1. Anillo Tier I — Fragmento de Amatista, Sensor de Sculk Calibrado, Manzana Dorada, Bloque de Hierro, Fragmento Resonante, Tótem de la Inmortalidad.
2. Anillo Tier II — Manzana Dorada Encantada, Tótem de la Inmortalidad, Lingote de Netherite, Anillo Tier I, Cristal del End, Bloque de Diamante.
3. Anillo Tier III — Libro Encantado (Maldición de Ligadura), Plantilla de Mejora de Netherite, Frasco Ominoso (nivel 5), Anillo Tier II, Ojo de Ender, Núcleo Pesado.
4. Corazón Maldito (ingrediente intermedio) — Lágrima de Ghast, Polvo de Blaze, Corazón del Mar, Redstone, Ojo de Ender.
5. Lágrima de Redención — Balde de Lava, Corazón Maldito, Aliento de Dragón, Piedra, Cristales de Prismarina, Estrella del Nether.

Recetas



[h3]⚙️ Comandos[/h3]

Todos los subcomandos tienen autocompletado (jugadores online, tiers 1-3), filtrado según el permiso de quien escribe.

[h3]📦 Dependencias[/h3]

No necesita ninguna dependencia obligatoria — funciona de fábrica con su modo autónomo.

Opcionales (el plugin las detecta y usa solo si están presentes):

1. MythicMobs o MMOItems — para usar tus propios ítems custom en vez del modo autónomo.
2. LuckPerms — para el acceso automático al Ender Chest del tier III.
3. PlaceholderAPI + AuraSkills — para que el daño del anillo escale con el nivel de una skill.
4. EssentialsX — si está instalado, sus propios /ec/enderchest se usan en vez de los del plugin (sin conflicto).

[h3]✅ Compatibilidad[/h3]

Paper/Purpur 1.21.x hasta 26.x (última versión probada). Requiere Java 21 o superior en el server.

[h3]🌍 Idiomas[/h3]

Español e inglés incluidos de fábrica (lang/es.yml, lang/en.yml), 100% editables. Agregar un idioma nuevo es tan simple como copiar y traducir un archivo.

[h3]⚡ Rendimiento[/h3]

Diseñado para servers grandes: sincronización instantánea de efectos (sin ticks de demora), debounce de eventos de inventario, e intervalo de comprobaciones pesadas que se ajusta solo según la cantidad de jugadores conectados.

[h2]🇬🇧 ENGLISH[/h2]

[h3]Description[/h3]

Plugin dedicated to adding a multi-tier cursed ring to your server: a legendary item that punishes as much as it rewards. The player who wears it gains powerful blessings (more experience, more reach, extra enchantments, Ender Chest access) in exchange for seven real curses that completely change how the game plays while it's equipped — more damage taken, less damage to monsters, permanent insomnia, fire that never goes out, and the ring can't be removed from the inventory unless the pact is broken with a special item.

This isn't a decorative item: every curse and every blessing is implemented as real gameplay logic, not just lore text.

[h3]✦ The 7 Curses + 1 Blessing (per tier)[/h3]

The only way out of the pact is the Tear of Redemption, a special item that permanently breaks the curse when used (with confirmation — it can't be undone).

[h3]🔧 How the player gets the item (3 automatic modes)[/h3]

ZRing auto-detects what you have installed and picks where the ring's items come from — no manual setup needed unless you want to force a specific mode:

1. With MythicMobs → uses your MythicMobs items.
2. No MythicMobs but with MMOItems → uses your MMOItems items.
3. Neither installed → the plugin generates its own items and its own crafting table recipes, fully self-contained. You'll never be stuck without the ring for lacking another plugin.

[h3]🛠️ Crafting Table Recipes (standalone mode)[/h3]

When ZRing generates its own items, it also registers 5 real vanilla crafting table recipes — shown as a suggestion in the player's recipe book as soon as they have the ingredients:

1. Ring Tier I — Amethyst Shard, Calibrated Sculk Sensor, Golden Apple, Iron Block, Echo Shard, Totem of Undying.
2. Ring Tier II — Enchanted Golden Apple, Totem of Undying, Netherite Ingot, Ring Tier I, End Crystal, Diamond Block.
3. Ring Tier III — Enchanted Book (Curse of Binding), Netherite Upgrade Smithing Template, Ominous Bottle (level 5), Ring Tier II, Ender Eye, Heavy Core.
4. Cursed Heart (intermediate ingredient) — Ghast Tear, Blaze Powder, Heart of the Sea, Redstone, Ender Eye.
5. Tear of Redemption — Lava Bucket, Cursed Heart, Dragon's Breath, Stone, Prismarine Crystals, Nether Star.

[h3]⚙️ Commands[/h3]

All subcommands have tab-completion (online players, tiers 1-3), filtered according to the sender's permissions.

[h3]📦 Dependencies[/h3]

No required dependencies — works out of the box in standalone mode.

Optional (the plugin detects and uses them only if present):

1. MythicMobs or MMOItems — to use your own custom items instead of standalone mode.
2. LuckPerms — for automatic Ender Chest access on Tier III.
3. PlaceholderAPI + AuraSkills — so the ring's damage scales with the skill level.
4. EssentialsX — if installed, its own /ec/enderchest commands are used instead of the plugin's (no conflict).

[h3]✅ Compatibility[/h3]

Paper/Purpur 1.21.x through 26.x (latest tested version). Requires Java 21 or higher on the server.

[h3]🌍 Languages[/h3]

Spanish and English are included out of the box (lang/es.yml, lang/en.yml), 100% editable. Adding a new language is as simple as copying and translating an existing file.

[h3]⚡ Performance[/h3]

Built for large servers: instant effect syncing (no tick delay), inventory event debouncing, and heavy-check intervals that automatically scale based on the number of connected players.