xRewards

# ⭐ xRewards – Advanced Rewards & Token System <div align="center"> xRewards es un plugin ligero, optimizado y 100% configurable para gestionar recompensas diarias, semanales y mensuales en tu servidor Minecraft. Incluye sistema de tokens, protección anti-abuso, menús GUI modernos y soporte para recompensas con items, dinero, comandos y permisos temporales. Perfecto para networks, lobbies, survival, skyblock y servidores con economía. </div> --- ## 🚀 Características Principales ### 🎁 Sistema de Recompensas Escalonado - **Diarias**: Dinero, tokens, items básicos. - **Semanales**: Recompensas mejoradas + posibilidad de bonus. - **Mensuales**: Premios premium, permisos VIP, items legendarios. ### 🔐 Anti-Abuso Inteligente - Detección por IP para evitar multicuentas. - Logs separados para intentos de abuso. - Configuración flexible para LAN/familias. ### 💎 Sistema de Tokens Integrado - Acumulables y utilizables en otras funciones del servidor. - Comandos para administrar saldos (`/xrewards tokens <add/remove> <jugador> <cantidad>`). ### 🎨 GUI 100% Personalizable - Menús con slots, materiales, nombres y lore editables. - Soporte para colores HEX (`&#RRGGBB`) y legacy (`&a`). - Placeholders dinámicos: `%player%`, `%tokens%`, `%status%`, `%time_long%`. ### ⚙ Configuración Modular ```yaml # ___ __ _ # / __\___ _ __ / _(_) __ _ ⋆✴︎˚｡⋆ # / / / _ \| '_ \| |_| |/ _` | Plugin by ˖⁺‧₊˚♡˚₊‧⁺˖ # / /__| (_) | | | | _| | (_| | xPlugins # \____/\___/|_| |_|_| |_|\__, | # |___/ .yml # Sistema de almacenamiento (YAML, SQLITE, MYSQL) storage: type: YAML # MySQL (solo si utilizas la opción de type = MYSQL) mysql: host: localhost port: 3306 database: xrewards username: root password: '' cooldowns: daily: 86400000 weekly: 604800000 monthly: 2592000000 anti-abuse: # Verificar IP para detectar multicuentas (¡NO TOCAR!) ip-check: true # Permitir que varias cuentas en la misma IP reclamen (¡NO TOCAR!) # (útil para familias o lan parties) (¡NO TOCAR!) allow-multiaccount: false # Registrar intentos de abuso en consola (¡NO TOCAR!) log-abuse-attempts: true # Crear archivo de log separado para abusos (¡NO TOCAR!) create-abuse-log-file: true ``` ### 🎯 Recompensas con Múltiples Formatos | Tipo | Soporta | |------|---------| | 💰 Dinero | Vault compatible | | ⭐ Tokens | Sistema interno | | 📦 Items | Con encantamientos, nombre y lore | | ⚡ Comandos | Ejecución automática con `%player%` | | 🔑 Permisos | Temporales o permanentes | ### 🌈 Mensajes con Estilo Todos los mensajes usan formato visual con bordes decorativos y colores HEX: ```yaml reward-claimed: | &8&m&l------------------------- &a&l✔ &r&a¡Recompensa Reclamada! &7Has reclamado tu recompensa &e%type%&7. &8&m&l------------------------- ``` --- ## 🔩 Comandos & Permisos **Permiso principal:** `xrewards.admin` | Comando | Descripción | |---------|-------------| | `/xrewards` | Abre el menú principal | | `/xrewards reload` | Recarga la configuración | | `/xrewards tokens <add/remove> <jugador> <cantidad>` | Administra tokens | | `/xrewards force <daily/weekly/monthly> <jugador>` | Fuerza recompensa (debug) | --- ## 📥 Instalación Rápida 1. Descarga el `.jar` y colócalo en `/plugins`. 2. Reinicia el servidor. 3. Edita `config.yml` para personalizar recompensas y menús. 4. ¡Listo! Los jugadores pueden usar `/xrewards`. > ✅ **Compatibilidad**: Spigot / Paper / Purpur 1.16.5+ > ✅ **Dependencias opcionales**: Vault (para economía) --- <details> <summary>💡 Tips de Configuración</summary> - Usa `%time_long%` para mostrar cooldowns legibles (`5 días 3 horas`). - Las recompensas con `chance: 25.0` solo se otorgan el 25% de las veces. - Los `temp-permissions` usan duración en milisegundos (ej: `604800000` = 7 días). - Puedes añadir múltiples items/commands por recompensa. - Recomendable utiliza **VAULT** & **LuckPerms** </details> --- <div align="center"> > Desarrollado con ❤️ por **xPlugins** > *Configuración limpia • Rendimiento optimizado • Experiencia profesional* </div>