From 2455ce3542e62121fd076eacf570d9b78d3a1797 Mon Sep 17 00:00:00 2001 From: Chamogelastos <150929858+Chamogelastos@users.noreply.github.com> Date: Sun, 8 Mar 2026 13:42:08 +0200 Subject: [PATCH 1/5] Document Folia support requirement in plugin.yml Added instructions for enabling Folia support in plugins. --- src/content/docs/paper/dev/api/folia-support.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/src/content/docs/paper/dev/api/folia-support.md b/src/content/docs/paper/dev/api/folia-support.md index e8a4a2502..6064cf9e1 100644 --- a/src/content/docs/paper/dev/api/folia-support.md +++ b/src/content/docs/paper/dev/api/folia-support.md @@ -9,6 +9,13 @@ slug: paper/dev/folia-support [Folia](https://github.com/PaperMC/Folia) is a fork of Paper, which is currently maintained by the PaperMC team. It adds the ability to split the world into regions as outlined [here](/folia/reference/overview) in more depth. +# Add Folia support + +Plugins can't run on Folia if you don't have this field in your paper-plugin.yml (or plugin.yml, respectively) +```yaml +isFoliaSupported: true +``` + # Checking for Folia Depending on what platform your plugin is running on, you may need to implement features differently. For this, you can From 6588c216d7407cc8588d8530dbde65c9d0a47b26 Mon Sep 17 00:00:00 2001 From: Chamogelastos <150929858+Chamogelastos@users.noreply.github.com> Date: Sun, 8 Mar 2026 13:55:43 +0200 Subject: [PATCH 2/5] Update isFoliaSupported to folia-supported in docs --- src/content/docs/paper/dev/api/folia-support.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/paper/dev/api/folia-support.md b/src/content/docs/paper/dev/api/folia-support.md index 6064cf9e1..3f8197fce 100644 --- a/src/content/docs/paper/dev/api/folia-support.md +++ b/src/content/docs/paper/dev/api/folia-support.md @@ -13,7 +13,7 @@ It adds the ability to split the world into regions as outlined [here](/folia/re Plugins can't run on Folia if you don't have this field in your paper-plugin.yml (or plugin.yml, respectively) ```yaml -isFoliaSupported: true +folia-supported: true ``` # Checking for Folia From bfbb30b8345e70769e7823b4cecab954837f83af Mon Sep 17 00:00:00 2001 From: Chamogelastos <150929858+Chamogelastos@users.noreply.github.com> Date: Sun, 8 Mar 2026 14:27:12 +0200 Subject: [PATCH 3/5] Update src/content/docs/paper/dev/api/folia-support.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Matouš Kučera --- src/content/docs/paper/dev/api/folia-support.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/paper/dev/api/folia-support.md b/src/content/docs/paper/dev/api/folia-support.md index 3f8197fce..f47bbd631 100644 --- a/src/content/docs/paper/dev/api/folia-support.md +++ b/src/content/docs/paper/dev/api/folia-support.md @@ -11,7 +11,7 @@ It adds the ability to split the world into regions as outlined [here](/folia/re # Add Folia support -Plugins can't run on Folia if you don't have this field in your paper-plugin.yml (or plugin.yml, respectively) +Plugins can't run on Folia if you don't have this field in your paper-plugin.yml (or plugin.yml, respectively): ```yaml folia-supported: true ``` From f102236b58157773bff36be457537fc986a7f5de Mon Sep 17 00:00:00 2001 From: Chamogelastos <150929858+Chamogelastos@users.noreply.github.com> Date: Sun, 8 Mar 2026 18:29:47 +0200 Subject: [PATCH 4/5] Update src/content/docs/paper/dev/api/folia-support.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Matouš Kučera --- src/content/docs/paper/dev/api/folia-support.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/paper/dev/api/folia-support.md b/src/content/docs/paper/dev/api/folia-support.md index f47bbd631..58dfbbdfe 100644 --- a/src/content/docs/paper/dev/api/folia-support.md +++ b/src/content/docs/paper/dev/api/folia-support.md @@ -9,7 +9,7 @@ slug: paper/dev/folia-support [Folia](https://github.com/PaperMC/Folia) is a fork of Paper, which is currently maintained by the PaperMC team. It adds the ability to split the world into regions as outlined [here](/folia/reference/overview) in more depth. -# Add Folia support +# Mark plugin as Folia-supporting Plugins can't run on Folia if you don't have this field in your paper-plugin.yml (or plugin.yml, respectively): ```yaml From c93d80018b10448366e591c88393a4fa848ae548 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Matou=C5=A1=20Ku=C4=8Dera?= Date: Tue, 10 Mar 2026 19:00:25 +0100 Subject: [PATCH 5/5] chore: stress the importance of developing with Folia in mind --- src/content/docs/paper/dev/api/folia-support.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/src/content/docs/paper/dev/api/folia-support.md b/src/content/docs/paper/dev/api/folia-support.md index 58dfbbdfe..fd32f04df 100644 --- a/src/content/docs/paper/dev/api/folia-support.md +++ b/src/content/docs/paper/dev/api/folia-support.md @@ -9,13 +9,20 @@ slug: paper/dev/folia-support [Folia](https://github.com/PaperMC/Folia) is a fork of Paper, which is currently maintained by the PaperMC team. It adds the ability to split the world into regions as outlined [here](/folia/reference/overview) in more depth. -# Mark plugin as Folia-supporting +# Mark plugin as supported on Folia Plugins can't run on Folia if you don't have this field in your paper-plugin.yml (or plugin.yml, respectively): ```yaml folia-supported: true ``` +:::danger + +Marking a plugin as supported on Folia is *not nearly enough* to support Folia. +You must specially develop your plugin with the intent of supporting Folia, keeping things mentioned on this page in mind. + +::: + # Checking for Folia Depending on what platform your plugin is running on, you may need to implement features differently. For this, you can