Repository navigation
FoliaScan: Drag-and-drop browser .jar scanner & CLI to check plugins before switching TYPE=FOLIA #4394
SalyyS1
started this conversation in
Show and tell
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Hi everyone,
When migrating a Paper server container over to
TYPE=FOLIA, checking 30 to 60 plugin.jarfiles by booting the container one crash at a time is painful: addingfolia-supported: true(or using automated bytecode patchers) only satisfies the loader, while legacyBukkitScheduler,Scoreboard,createWorld, synchronousEntity#teleport, or off-regionEntity/Block/Worldcalls only throwUnsupportedOperationExceptiononce a player triggers that code path.I built FoliaScan (open-source bytecode scanner derived directly from PaperMC/Folia's own patch set) and just shipped a 100% client-side Browser Multi-JAR Scanner so admins can check an entire
plugins/folder before switchingTYPE=FOLIA:.jarfiles locally, zero upload): https://salyys1.github.io/foliascan/uses: SalyyS1/foliascan@main): https://github.com/SalyyS1/foliascanserverdoctor): https://github.com/SalyyS1/serverdoctorWhat it checks
FS001-FS041): Missingfolia-supported: true, bytecode modified by automated Folia patchers (FS002),Bukkit.getScheduler()/BukkitScheduler/BukkitRunnable, synchronousEntity#teleport(Must use teleportAsync), unimplementedScoreboardregistration/assignment, andcreateWorld/unloadWorld.FS050-FS080in the CLI / GitHub Action): Propagates async taint fromAsyncScheduler,CompletableFuture.*Async,ExecutorService,AsyncChatEvent, andGlobalRegionScheduler(region={null}) across intra-jar helper methods while recognizingRegionScheduler/EntitySchedulerre-entry hops and runtimeisFoliaguards, automatically skipping shaded vendor libraries (bStats,Adventure,HikariCP,Kotlin,Guava).You can either drop your
.jarfiles straight onto https://salyys1.github.io/foliascan/ in the browser (runs locally viaDecompressionStream+ JVM0xCAFEBABEclassfile parsing) or scan a mounted volume viajava -jar foliascan.jar /data/plugins --fail-on critical. Hope this saves fellowTYPE=FOLIAadmins some crash-loop debugging!All reactions