?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Folia Phantom

Folia Phantom

Modernize plugins for Folia

41
0
41
0

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x

Platforms

Links

Report issues View source Visit wiki Join Discord server

Tags

Creators

Details

Licensed Marv License
Published 5 months ago

Folia Phantom ๐Ÿ‘ป

A powerful on-the-fly bytecode transformer to bridge the gap between legacy Bukkit plugins and the Folia environment.

Folia Phantom is a professional-grade tool designed for Folia server owners. It automatically rewrites class files to convert thread-unsafe API calls (like global schedulers and direct block modifications) into Folia-compatible region-based or asynchronous operations.

๐Ÿ”Œ Primary: Server-Side Plugin

The core of Folia Phantom is its Server-Side Plugin. Designed for seamless integration, it enables:

  • On-the-fly Transformation: Automatically patches plugins as they load or via simple commands.
  • Set it and forget it: Configure automated patching rules in the config.yml.
  • Zero Config: Injects a tiny runtime bridge so patched plugins run without any external dependencies.

๐ŸŽจ Also Available: Pro Dashboard GUI

For batch processing and plugin developers, we provide a Modern Desktop GUI:

  • Stunning Interface: A premium glassmorphism-styled dashboard.
  • Drag & Drop: Patch dozens of plugins at once with ease.
  • Detailed Stats: Monitor bytecode scanning and transformation statistics in real-time.

โœจ Key Features

  • ๐Ÿš€ High-Performance Engine: Uses advanced ASM bytecode manipulation with parallel processing and fast-fail scanning.
  • ๐Ÿ›ก๏ธ Thread Safety Enforcement: Automatically wraps Block.setType and other world-modifying calls to execute on correct region threads.
  • โšก Smart Schedulers: Seamlessly converts BukkitScheduler to Folia's RegionScheduler, GlobalRegionScheduler, or AsyncScheduler.
  • ๐Ÿ“ฆ Seamless Compatibility: Handles JAR signatures and automatically adds the folia-supported: true flag to plugin.yml.

๐Ÿ“– Quick Start

1. Using the Plugin (Recommended)

  1. Download Folia-Phantom-Plugin.jar from Releases.
  2. Drop it into your Folia server's plugins folder.
  3. Start the server and use /foliaphantom patch <plugin_name> to convert specific plugins.

2. Using the GUI

  1. Download Folia-Phantom-GUI.jar.
  2. Launch it on your desktop (JDK 17+).
  3. Drag legacy plugins into the sidebar and click EXECUTE PATCH.

๐Ÿ”— Links

๐Ÿ“„ License

Licensed under the MARV License.
Copyright ยฉ 2025 Marv.