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.setTypeand other world-modifying calls to execute on correct region threads. - ⚡ Smart Schedulers: Seamlessly converts
BukkitSchedulerto Folia'sRegionScheduler,GlobalRegionScheduler, orAsyncScheduler. - 📦 Seamless Compatibility: Handles JAR signatures and automatically adds the
folia-supported: trueflag toplugin.yml.
📖 Quick Start
1. Using the Plugin (Recommended)
- Download
Folia-Phantom-Plugin.jarfrom Releases. - Drop it into your Folia server's
pluginsfolder. - Start the server and use
/foliaphantom patch <plugin_name>to convert specific plugins.
2. Using the GUI
- Download
Folia-Phantom-GUI.jar. - Launch it on your desktop (JDK 17+).
- Drag legacy plugins into the sidebar and click EXECUTE PATCH.
🔗 Links
📄 License
Licensed under the MARV License.
Copyright © 2025 Marv.
