⭐ xRewards – Advanced Rewards & Token System

---

🚀 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

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)

---

💡 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

---