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

• 🌐 Official Website
• 📖 Documentation Wiki
• 💻 GitHub Repository

---

📄 License

Licensed under the MARV License.
Copyright © 2025 Marv.