Folia Compatibility

StarChat was built from the ground up with asynchronous packet processing to perfectly align with Folia\'s multi-threaded ticking regions.

What is Folia?

Folia is a fork of Paper that adds regionized multithreading to the server. This means different chunks of the world tick on different threads. Traditional plugins that assume a single "main thread" will crash or cause severe corruption on Folia.

StarChat + Folia

StarChat fully supports Folia without needing any special "Folia-specific" jars. It uses the modern Paper Plugin API and the Folia Scheduler to ensure that chat events, database operations, and minigames execute on the correct regional thread or asynchronously.

Limitations on Folia

Due to the nature of Folia\'s regionized multithreading, a few minor features might behave slightly differently:

  • Local Chat Radius: If chat-radius is enabled in config.yml, broadcasting messages to players in different ticking regions can incur a slight (1-2ms) delay as the message is handed off to the appropriate region scheduler.
  • Third-Party Plugins: Even if StarChat supports Folia, if you use a placeholder from another plugin (via PlaceholderAPI) that doesn\'t support Folia, that plugin may crash the server when calculating the placeholder.

🚀 Seamless Migration

You can migrate your existing StarChat configuration and database from a standard Paper server directly to a Folia server without changing any files.