v0.1.1-alpha - Folia 26.1.2

Threaded regions, plugin compatibility work.

SilkMC keeps Folia's regional multithreading architecture while narrowing the rough edge for Paper, Bukkit, and Spigot plugins. It is meant to make failures clearer, startup safer, and testing less mysterious.

Early alpha build. Test on a backup or staging server first.

Direct download for the runnable paperclip build.

v0.1.1 latest public release
Folia regional architecture
paperclip runnable server jar
GPL-3.0 open source

Closer to Paper plugin expectations without pretending Folia is single-threaded.

Metadata-aware startup

Plugins can opt into SilkMC compatibility while Folia-aware metadata remains honored for upstream interoperability.

plugin loading
Scheduler bridging

Legacy task assumptions are handled where the server can preserve correctness across region-threaded execution.

thread ownership
Visible unsafe edges

When behavior cannot be made safe, SilkMC should warn, disable, or fail loudly instead of hiding a corruption risk.

guardrails
What it is trying to improve

Paper, Bukkit, and Spigot plugin startup paths; lifecycle timing; scheduler assumptions; async misuse diagnostics; and more readable incompatibility reports.

What it is not promising

It is not a guarantee that every plugin works, and it is not production-hardened yet. Test carefully before using it for anything important.

Use the runnable paperclip jar and test plugins in layers.

01
Build the project

Apply patches first, then build the server and paperclip package.

git clone https://github.com/tame-gg/SilkMC.git cd SilkMC ./gradlew applyAllPatches ./gradlew build ./gradlew :silkmc-server:createPaperclipJar
02
Run paperclip, not the module jar

The plain silkmc-server jar is not meant to be launched standalone.

java -Xms4G -Xmx4G -jar silkmc-server/build/libs/silkmc-paperclip-26.1.2.local-SNAPSHOT.jar nogui
03
Treat warnings as test data

Add plugins gradually, keep logs from each run, and test on a backup or staging world while the alpha settles.