⭐ xRewards – Advanced Rewards & Token System

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.

🚀 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

#    ___             __ _
#   / __\___  _ __  / _(_) __ _ ⋆✴︎˚｡⋆
#  / /  / _ \| '_ \| |_| |/ _` |   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:

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

Descarga el .jar y colócalo en /plugins.
Reinicia el servidor.
Edita config.yml para personalizar recompensas y menús.
¡Listo! Los jugadores pueden usar /xrewards.

✅ Compatibilidad: Spigot / Paper / Purpur 1.16.5+
✅ Dependencias opcionales: Vault (para economía)

💡 Tips de Configuración

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

Desarrollado con ❤️ por xPlugins
Configuración limpia • Rendimiento optimizado • Experiencia profesional