Introducción a ZenFairy

¡Bienvenidos a la wiki oficial de ZenFairy! Este plugin ha sido diseñado para transformar la exploración de tu mundo en una emocionante y gratificante búsqueda del tesoro. Prepárate para una experiencia donde la curiosidad y la dedicación se premian, creando una comunidad más activa y aventurera.

Primeros Pasos

Navega a las secciones clave para empezar a configurar tu sistema de almas coleccionables.

Instalación Aprende a instalar ZenFairy en tu servidor.

Comandos y Permisos Todos los comandos y permisos disponibles.

Creando Almas Personaliza tus tipos de almas y menús de recompensa.

Placeholders Variables dinámicas con PlaceholderAPI.

Características Principales

Sistema de Coleccionables

Crea una cantidad ilimitada de “tipos de almas” para que tus jugadores las encuentren y las intercambien por recompensas en menús interactivos.

Acciones Avanzadas

Ejecuta comandos, envía títulos, da stats de AuraSkills y mucho más como recompensa. El poder está en tus manos.

PlaceholderAPI

Integración completa con variables dinámicas para mostrar el progreso de los jugadores en cualquier lugar del servidor.

Moderno y Optimizado

Construido desde cero para Minecraft 1.21 en adelante, asegurando la máxima compatibilidad y rendimiento.

Guía de Inicio Rápido

Sigue estos simples pasos para tener ZenFairy funcionando en minutos.

1. Descargar el Plugin

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

2. Instalar en tu Servidor

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

   ¡Activa las Integraciones!

   Si tienes PlaceholderAPI y/o AuraSkills instalados, ¡las funciones avanzadas como placeholders y recompensas de stats se activarán automáticamente!

3. Reiniciar y Configurar

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

Conceptos Clave del Plugin

ZenFairy se basa en dos sistemas principales que trabajan juntos para fomentar la exploración.

Tipos de Almas

El corazón del plugin. Puedes crear fairy.yml, dragon.yml, abyssal.yml, etc. Cada archivo representa una categoría única de almas coleccionables, cada una con su propio menú de recompensas, sonidos, animaciones y acciones.

Menú de Intercambio (/souls menu <tipo>)

Un menú interactivo y personalizable para cada tipo de alma. Aquí, los jugadores pueden “gastar” las almas que han encontrado para obtener recompensas. Los ítems son inteligentes y cambian su apariencia si el jugador puede permitirse el intercambio o no.

Estructura de Archivos Generada

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

• DirectorioZenFairy/

  • Directoriosouls/

    • _example.yml Plantilla para crear nuevos tipos de almas.
    • fairy.yml El tipo de alma por defecto.
  • config.yml Configuración principal (mensajes y menú de localizaciones).
  • player_data.yml Almacenamiento de los datos de los jugadores.

Placeholders Destacados

Gracias a la integración con PlaceholderAPI, puedes mostrar información dinámica de los jugadores.

Placeholder	Descripción	Tags
%zenfairy_souls_found_fairy%	Muestra el número total de almas de tipo “fairy” que el jugador ha encontrado.	PAPI, Estadísticas
%zenfairy_souls_available_fairy%	Muestra cuántas almas de tipo “fairy” le quedan al jugador para intercambiar.	PAPI, Progreso
%zenfairy_souls_total_fairy%	Muestra la cantidad total de almas de tipo “fairy” que existen en el servidor.	PAPI, Información

Placeholder Personalizable

Puedes cambiar fairy por el ID de cualquier tipo de alma que hayas creado (ej: dragon, abyssal, etc.).

Preguntas Frecuentes

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

ZenFairy está diseñado específicamente para Minecraft 1.21 en adelante. No es compatible con versiones anteriores, ya que utiliza las APIs más modernas y eficientes de Paper.

¿Afecta al rendimiento del servidor (TPS)?

No. ZenFairy está altamente optimizado. La animación de las almas utiliza ArmorStands de tipo “marker” que tienen un impacto mínimo en el rendimiento, y el resto de operaciones están diseñadas para ser lo más ligeras posible.

¿Puedo personalizar las recompensas?

¡Absolutamente! Tienes control total. Cada tipo de alma tiene su propio archivo de configuración donde defines el menú y las acciones para cada recompensa, incluyendo ejecutar comandos, dar stats de AuraSkills, etc.

¿Soporta múltiples idiomas?

Sí. Todos los mensajes visibles para el jugador son configurables en config.yml, permitiéndote traducir el plugin a cualquier idioma.

¿Necesitas ayuda?

Únete a nuestro Discord para soporte directo, comparte tus configuraciones y sugiere nuevas ideas para ZenFairy.