PLUGIN PREMIUM

RachaSystem

Un sistema de recompensas por inicio de sesión diario (Daily Streaks), inspirado en las rachas de TikTok. Motiva a los jugadores a entrar todos los días premiando su constancia con recompensas que mejoran conforme mantienen su racha.

Instalación

Sigue estos pasos para instalar y activar RachaSystem en tu servidor.

Importante: Para utilizar este plugin, debes unirte a nuestro Discord y solicitar tu Licencia mediante un ticket.

Obtener Licencia

Descarga el archivo RachaSystem.jar.
Colócalo en la carpeta /plugins de tu servidor.
Inicia el servidor para generar los archivos de configuración.
Abre el archivo config.yml e introduce tu licencia.

Configuración por Defecto (config.yml)

# --------------------------------------------------
# CLAVE DE LICENCIA (REQUERIDO)
# --------------------------------------------------
license-key: "PLUG-1A1D2D20-4372" # Introduce la clave de licencia generada por tu bot de Discord aquí.

# ==================================================
# CONFIGURACIÓN GENERAL - PANITAS NETWORK
# ==================================================
prefix: "&8[&6Racha&8] &r"
language: es

# --------------------------------------------------
# OPCIONES (FEATURES)
# --------------------------------------------------
features:
  open-menu-on-command: true   # Abrir menú con /racha
  show-join-title: true        # Título al entrar
  show-status-on-command: true # Mensaje de estado en chat

# --------------------------------------------------
# TIEMPOS (HORAS)
# --------------------------------------------------
settings:
  cooldown-hours: 24  # Horas para reclamar siguiente premio
  loss-hours: 48      # Horas antes de perder la racha

# --------------------------------------------------
# VISUALES (%racha_fire%)
# --------------------------------------------------
fire-emojis:
  enabled: true
  default: "§e" # Amarillo
  milestones:
    50: "§6"    # Naranja
    100: "§d"   # Rosa
    200: "§b"   # Aqua

# --------------------------------------------------
# INTEGRACIÓN DISCORD
# --------------------------------------------------
discord:
  enabled: true
  webhook-url: "https://discord.com/api/webhooks/TU_WEBHOOK_AQUI"
  milestones:
    interval: 10      # Avisar cada 10 días
    specific-days:    # Días especiales para avisar
      - 50
      - 100
      - 365

# --------------------------------------------------
# ALMACENAMIENTO DE DATOS
# --------------------------------------------------
use-mysql: false
data:
  address: "localhost"
  database: "minecraft"
  username: "root"
  password: ""
                    

Características Principales

Soporte MySQL

Sincronización de datos entre múltiples servidores (BungeeCord/Velocity) en tiempo real, con caché en memoria para alto rendimiento.

Menús GUI

Interfaces totalmente personalizables en menu.yml, con soporte para HeadDatabase, texturas custom y estados visuales.

Rachas Infinitas

Recompensas especiales para días específicos. Lógica de cooldown (24h) y pérdida (48h), con restauración via fichas.

Integración Discord

Notificaciones via Webhooks para hitos, pérdidas y restauraciones, personalizables con colores e imágenes.

Top 10 y Placeholders

Clasificación de rachas con placeholders para hologramas y visualización en juego.

Comandos y Permisos

Lista completa de comandos administrativos y de usuario.

Comando	Descripción	Permiso
/racha	Abre el menú de recompensas.	racha.use
/racha status	Muestra racha actual, fichas y tiempo.	racha.use
/racha restore	Intenta restaurar racha con ficha.	racha.use
/racha info	Estado de conexión Discord/MySQL.	ninguno
/rachaadmin reload	Recarga toda la configuración.	racha.admin
/rachaadmin set <user> <días>	Establece la racha de un jugador.	racha.admin
/rachaadmin add <user> <días>	Añade días a la racha actual.	racha.admin
/rachaadmin ficha <user> <cant>	Da fichas de restauración.	racha.admin

Archivos de Configuración

Además de config.yml, el plugin genera:

menu.yml: Configura el título, tamaño y los ítems del menú GUI.
es.yml / en.yml: Todos los mensajes de chat y el diseño de los Webhooks de Discord.
top-decenhologram.yml: Plantilla para crear hologramas de Top 10.

Developer API

Placeholders (PlaceholderAPI)

Placeholder	Función
%racha_racha%	Días de racha actual del jugador.
%racha_cooldown%	Tiempo restante para siguiente recompensa.
%racha_fire%	Emoji/Color configurado según el hito.
%racha_top_name_1%	Nombre del jugador Top #1.
%racha_top_score_1%	Racha del jugador Top #1.