Logo
Folia Phantom
PluginLicenseRef-Marv-License

Folia Phantom

Modernize plugins for Folia

10
Downloads
0
Followers
4 months ago
Updated
📦
1
Versions
optimizationtechnologyfoliapaper
Download Latestvv1.1.0View on Modrinth

📖About 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 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.