Documentación del NetherPortalPlugin
1. Introducción
NetherPortalPlugin es un plugin de Minecraft que permite la creación y gestión dinámica de portales al Nether. Proporciona a los jugadores una experiencia emocionante y única al explorar el Nether, con características personalizables y efectos visuales atractivos.

2. Características

• Creación Automática de Portales: Los portales se generan en intervalos establecidos en la configuración.
• Duración de Portales: Cada portal tiene un tiempo de vida configurable y se cierra automáticamente al finalizar.
• Verificación de Integridad: El plugin verifica periódicamente la integridad del portal y lo repara si es necesario.
• Efectos de Partículas: Se generan efectos visuales alrededor del portal para mejorar la experiencia del jugador.
• Scoreboard Informativo: Muestra el tiempo restante antes de que el portal se cierre en la pantalla de los jugadores.
• Comandos Administrativos: Permite a los administradores crear, cerrar y obtener información sobre los portales mediante comandos simples.

3. Instalación

1. Descarga el Plugin:
   
   • Descarga el archivo .jar de NetherPortalPlugin desde SpigotMC o desde la fuente de distribución.
2. Coloca el Plugin:
   
   • Copia el archivo .jar en la carpeta plugins de tu servidor de Minecraft.
3. Reinicia el Servidor:
   
   • Reinicia tu servidor o utiliza el comando /reload para cargar el plugin.
4. Configuración Inicial:
   
   • Un archivo config.yml se generará automáticamente en la carpeta plugins/NetherPortalPlugin. Abre este archivo para personalizar la configuración.

4. Configuración
El archivo config.yml contiene las siguientes opciones configurables:

portalInterval: 72 # Intervalo en minutos para la creación de portales
portalDuration: 5 # Duración del portal en horas
portalSpawnRadius: 50 # Radio de búsqueda para la ubicación del portal

Ejemplo de config.yml:
portalInterval: 72
portalDuration: 5
portalSpawnRadius: 50

5. Comandos
Comandos para Administradores

• /netherportal create
  
  • Crea un portal al Nether en la ubicación actual del jugador.
  • Permiso requerido: netherportal.admin
• /netherportal close
  
  • Cierra el portal al Nether activo.
  • Permiso requerido: netherportal.admin
• /netherportal info
  
  • Muestra información sobre el portal activo, incluyendo su ubicación y tiempo restante.
  • Permiso requerido: netherportal.admin

Ejemplo de Uso:

1. Para crear un portal:
   
   /netherportal create
   
   
2. Para cerrar un portal:
   
   /netherportal close
   
   
3. Para obtener información sobre el portal:
   
   /netherportal info
   

6. Eventos
Evento PlayerJoinEvent

• Cuando un jugador se une al servidor, si hay un portal activo, se le notificará con un mensaje en el chat y se le asignará el scoreboard que muestra el tiempo restante.

7. Solución de Problemas

• El portal no se crea:
  
  • Asegúrate de que el servidor tenga permisos suficientes y que el plugin esté habilitado.
  • Verifica que el portalInterval en config.yml esté configurado correctamente.
• El portal no se cierra automáticamente:
  
  • Comprueba el valor de portalDuration en config.yml y asegúrate de que el tiempo haya pasado.
• Los efectos de partículas no aparecen:
  
  • Asegúrate de que el plugin esté activo y que no haya conflictos con otros plugins que manejen partículas.
• Errores en la consola:
  
  • Revisa los registros de la consola para identificar el error específico. Asegúrate de que estás utilizando una versión compatible de Spigot o Paper.

8. Contacto y Soporte
Para obtener soporte adicional o reportar problemas, puedes contactar al desarrollador a través del foro de SpigotMC o el canal de soporte correspondiente.

Esta documentación debería proporcionar a los usuarios toda la información necesaria para instalar, configurar y utilizar el NetherPortalPlugin de manera efectiva. Puedes personalizarla según sea necesario. ¡Espero que te sea útil!