Introducción a ZenRewards

¡Bienvenidos a la wiki oficial de ZenRewards! Este plugin ha sido diseñado para transformar la conexión diaria de tus jugadores en una emocionante rutina llena de premios. Prepárate para una experiencia donde la lealtad y la constancia se recompensan, creando una comunidad más activa y comprometida.

Primeros Pasos

Navega a las secciones clave para empezar a configurar tu servidor.

Instalación Aprende a instalar ZenRewards en tu servidor

Comandos Todos los comandos disponibles

Menu Personaliza el menú de recompensas

Placeholders Variables dinámicas con PlaceholderAPI

Características Principales

Sistema de Recompensas

Menú totalmente personalizable donde los jugadores pueden reclamar premios diarios, semanales, únicos o por rango.

Sistema de Rachas

Premia a los jugadores por su constancia al conectarse días seguidos. Crea hábitos y fideliza tu comunidad.

PlaceholderAPI

Integración completa con variables dinámicas para mostrar información en cualquier parte de tu servidor.

Multi-versión

Compatible desde 1.8.8 hasta 1.21.x y futuras versiones gracias a XSeries.

Guía de Inicio Rápido

Sigue estos simples pasos para tener ZenRewards funcionando en minutos.

Descargar el Plugin

Obtén la última versión del archivo .jar desde nuestra página de lanzamiento oficial.
Instalar en tu Servidor

Coloca el archivo ZenRewards.jar en la carpeta plugins de tu servidor.

Si tienes PlaceholderAPI instalado (¡muy recomendado!), las variables como %zenrewards_streak_current% se activarán automáticamente.
Reiniciar y Configurar

Reinicia tu servidor por completo. Se generará la carpeta ZenRewards con todos los archivos de configuración listos para que los personalices a tu gusto.

Conceptos Clave del Plugin

ZenRewards se basa en dos sistemas principales que trabajan juntos para fomentar la retención de jugadores.

Menú de Recompensas (`/rewards`)

El corazón del plugin. Un menú totalmente personalizable donde los jugadores pueden reclamar premios diarios, semanales, únicos o por rango. Los ítems son inteligentes y cambian su apariencia según su estado (disponible, en cooldown, etc.).

Sistema de Rachas (`/streak`)

La joya de la corona. Premia a los jugadores por su constancia al conectarse días seguidos. Este sistema es clave para crear un hábito de conexión y construir una comunidad leal.

Estructura de Archivos Generada

Al iniciarse por primera vez, ZenRewards creará la siguiente estructura de carpetas y archivos.

DirectorioZenRewards/
- Directorioplayerdata/
  - uuid-del-jugador.yml
- config.yml Configuración principal
- menu.yml Configuración del menú de recompensas
- rewards.yml Definición de todas las recompensas
- streak-menu.yml Configuración del menú de rachas
- streaks.yml Configuración del sistema de rachas

Placeholders Destacados

Gracias a la integración con PlaceholderAPI, puedes mostrar información dinámica en cualquier parte de tu servidor.

Placeholder	Descripción	Tags
`%zenrewards_streak_current%`	Muestra el número de días de racha de conexión actual del jugador	PAPI, Racha
`%zenrewards_cooldown_daily_reward%`	Muestra el tiempo restante para la recompensa con ID ‘daily_reward’. Si está disponible, muestra “Ready”	PAPI, Cooldown
`%zenrewards_total_claimed%`	Total de recompensas reclamadas por el jugador	PAPI, Estadísticas

Preguntas Frecuentes

¿Este plugin funciona en mi versión de Minecraft?

¡Sí! ZenRewards está construido para ser retrocompatible. Funciona desde la versión 1.8.8 hasta la 1.21.x y futuras. Utilizamos la librería XSeries para manejar las diferencias de materiales y sonidos entre versiones de forma automática.

¿Afecta al rendimiento del servidor (TPS)?

No. Las operaciones clave, como la actualización de los menús y el manejo de datos, están optimizadas. El sistema de actualización de cooldowns en tiempo real solo se activa para los jugadores que tienen el menú abierto, evitando cualquier carga innecesaria.

¿Puedo personalizar los premios?

Absolutamente. Todos los premios, cooldowns, mensajes y apariencias están definidos en archivos YAML fáciles de editar. Consulta la sección de Configuración para más detalles.

¿Soporta múltiples idiomas?

Sí. Todos los mensajes son configurables en config.yml y puedes traducirlos al idioma que prefieras. Además, soporta colores y formato usando códigos de Minecraft estándar.