Folia Phantom

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 Zero Config. Designed for seamless integration, it enables: - Zero Config: Automatically patches plugins as they load or via simple commands. - Zero Config: 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 Detailed Stats: - Detailed Stats: A premium glassmorphism-styled dashboard. - Detailed Stats: Patch dozens of plugins at once with ease. - Detailed Stats: Monitor bytecode scanning and transformation statistics in real-time.

---

✨ Key Features

- 📦 Seamless Compatibility: Uses advanced ASM bytecode manipulation with parallel processing and fast-fail scanning. - 📦 Seamless Compatibility: Automatically wraps `Block.setType` and other world-modifying calls to execute on correct region threads. - 📦 Seamless Compatibility: 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. Copyright © 2025 Marv.