Saltar al contenido
Plataformas

Plugins de Folia

El multihilo por regiones de Folia cambia la forma en que los plugins programan las tareas. Cómo genera Codexe plugins seguros para Folia y qué incluir en la petición.

Actualizado

En esta página
  1. Qué hace Codexe de forma distinta
  2. Qué poner en la petición
  3. Compilación y verificación
  4. Problemas habituales

Folia es el fork de Paper que procesa los ticks de distintas regiones del mundo en hilos diferentes. No existe un único "hilo principal", así que la programación de tareas habitual de Bukkit (Bukkit.getScheduler().runTask(...)) no es válida.

#Qué hace Codexe de forma distinta

Cuando eliges el tipo Folia, el plugin generado:

  • programa las tareas con los programadores de región, de entidad, de región global y asíncrono en lugar del programador de Bukkit,
  • declara folia-supported: true en plugin.yml,
  • se compila contra la API de Folia (Maven).

#Qué poner en la petición

Todo lo de la guía de Spigot y Paper, más los detalles que dependen del tiempo: "teletransportar después de 3 segundos", "repetir cada minuto para cada jugador conectado". Es ahí donde más se diferencia el código de Folia.

#Compilación y verificación

Los plugins de Folia se compilan y se comprueban como cualquier otro plugin antes de estar Listos. Compilar demuestra que el código se construye contra la API de Folia. La seguridad entre hilos durante la ejecución sigue dependiendo de la lógica, así que pruébalo en un servidor Folia.

#Problemas habituales

SíntomaCausa probable
UnsupportedOperationException relacionada con el programador de tareasHay código (a menudo de una dependencia) que usa el programador de Bukkit. Pide en el chat que lo mueva al programador de región o de entidad.
El plugin no carga en FoliaFalta folia-supported: true en plugin.yml.
Plugins de Folia | Codexe Docs