Folia Phantom

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： folia paper

标签： optimization technology

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.