Jak vytvořit plugin pro Folii

Krok za krokem

1. 1.Ověř, že Folii potřebuješ

   Folia pomáhá serverům s mnoha hráči rozptýlenými po světě. Většina serverů běží na Paperu; spousta oblíbených pluginů Folii nepodporuje, takže nejdřív zkontroluj ty, na kterých závisíš.

2. 2.Sestavuj proti API Folie

   V projektu Maven nebo Gradle použij závislost folia-api pro svou verzi z repozitáře PaperMC se scope provided.

3. 3.Nahraď plánovač Bukkitu

   Bukkit.getScheduler() na Folii nefunguje. Na práci na určitém místě použij plánovač regionu, na práci s hráčem nebo mobem plánovač entity, na úlohy pro celý svět plánovač globálního regionu a na I/O asynchronní plánovač.

4. 4.Na věci sahej jen z jejich vlastního regionu

   Blok nebo entitu měň jen ve vlákně, které ji vlastní. Místo teleport použij teleportAsync a před změnou cíle naplánuj práci do jeho regionu.

5. 5.Deklaruj podporu Folie

   Přidej do plugin.yml folia-supported: true. Bez toho Folia odmítne plugin načíst.

6. 6.Otestuj na serveru s Folií

   Kompilace dokazuje, že se kód sestaví proti API Folie, ne že je bezpečný pro vlákna. Spusť ho na testovacím serveru s Folií s několika hráči na různých místech.

Čtyři plánovače

Co se obvykle rozbije

• Opakované úlohy pro všechny hráče: jedna smyčka přes všechny hráče online už nefunguje; místo toho naplánuj úlohu v plánovači entity každého hráče.
• Teleporty a čekání: „teleport po 3 sekundách“ potřebuje plánovač entity a teleportAsync.
• Sdílená data: mapy a počítadla používané z více regionů musí být bezpečné pro vlákna, třeba souběžné kolekce.
• Závislosti: knihovna, která volá plánovač Bukkitu, vyhodí na Folii UnsupportedOperationException.

Jeden plugin pro Paper i Folii

Plánovače regionu, entity, globální a asynchronní jsou v aktuálních verzích i součástí API Paperu, takže plugin, který používá jen je a deklaruje folia-supported: true, běží na Paperu i na Folii. To je často nejlepší cíl: jeden .jar pro každý server.

S Codexe

Vyber typ Folia. Vygenerovaný plugin plánuje práci přes plánovače regionu, entity, globálního regionu a asynchronní, deklaruje folia-supported: true a sestavuje se proti API Folie přes Maven. Než je Ready, zkompiluje se a zkontroluje.

Do zadání napiš podrobnosti o časování („každou minutu pro každého hráče online“, „teleport po 3 sekundách“): právě tam se kód pro Folii liší nejvíc. Vyzkoušet hned zatím servery s Folií nespouští, takže .jar otestuj na vlastním serveru s Folií.

Otázky