Upgrader

Upgrader is a survival-friendly item upgrade plugin with a clean GUI, balanced probability system, roulette animation, and admin tools.

Features:
- Upgrade items using other items as input.
- GUI-based item selection.
- Roulette-style animation when attempting an upgrade.
- Balanced chance calculation based on item value, quantity, rarity, and enchantments.
- Supports enchanted items in the probability system.
- Output quantity selector.
- Admin menu for managing allowed and blocked items.
- Supports creative-only items if enabled by an admin.
- Global language support: English and Spanish.
- Local API support for advanced integrations.
- Designed for survival servers.

Commands:
- /up - Opens the Upgrader menu.
- /up search <item> - Search upgrade items.
- /up admin - Opens the admin menu.
- /up reload - Reloads the plugin configuration.

Permissions:
- upgrader.use - Allows players to use /up.
- upgrader.admin - Allows access to admin commands and configuration tools.

Installation:
1. Download the .jar file.
2. Place it inside your server's plugins folder.
3. Restart your server.
4. Use /up in game.

Requirements:
- Java 21
- Paper, Spigot, or Purpur compatible server
- Tested on Minecraft 1.20.6 and 1.21.x





Spanish


Upgrader es un plugin para servidores survival que permite mejorar e intercambiar objetos mediante una interfaz gráfica, con cálculo de probabilidades, animación tipo ruleta y herramientas de administración.

Características:
- Sistema de mejoras e intercambios de objetos desde un menú GUI.
- Animación tipo ruleta al intentar una mejora.
- Cálculo balanceado de probabilidad según el valor del objeto de entrada, el objeto de salida, la cantidad, la rareza y los encantamientos.
- Compatible con objetos encantados dentro del cálculo de probabilidad.
- Selector de cantidad para elegir cuántos objetos quieres recibir.
- Menú de administración para permitir o bloquear objetos intercambiables.
- Posibilidad de permitir objetos que normalmente solo existen en creativo.
- Soporte de idioma en español e inglés.
- API local opcional para integraciones avanzadas.
- Pensado para servidores survival con economía basada en objetos.

Comandos:
- /up - Abre el menú principal de Upgrader.
- /up search <objeto> - Busca objetos disponibles para mejorar/intercambiar.
- /up admin - Abre el menú de administración.
- /up reload - Recarga la configuración del plugin.

Permisos:
- upgrader.use - Permite usar /up.
- upgrader.admin - Permite usar comandos y menús de administración.

Instalación:
1. Descarga el archivo .jar.
2. Colócalo dentro de la carpeta plugins de tu servidor.
3. Reinicia el servidor.
4. Usa /up dentro del juego.

Requisitos:
- Java 21
- Servidor compatible con Paper, Spigot o Purpur
- Probado en Minecraft 1.20.6 y 1.21.x