# Folia Phantom \ud83d\udc7b<\/p>\n
**A powerful on-the-fly bytecode transformer to bridge the gap between legacy Bukkit plugins and the Folia environment.**<\/p>\n
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.<\/p>\n
—<\/p>\n
## \ud83d\udd0c Primary: Server-Side Plugin<\/p>\n
The core of Folia Phantom is its **Server-Side Plugin**. Designed for seamless integration, it enables:
\n– **On-the-fly Transformation**: Automatically patches plugins as they load or via simple commands.
\n– **Set it and forget it**: Configure automated patching rules in the `config.yml`.
\n– **Zero Config**: Injects a tiny runtime bridge so patched plugins run without any external dependencies.<\/p>\n
## \ud83c\udfa8 Also Available: Pro Dashboard GUI<\/p>\n
For batch processing and plugin developers, we provide a **Modern Desktop GUI**:
\n– **Stunning Interface**: A premium glassmorphism-styled dashboard.
\n– **Drag & Drop**: Patch dozens of plugins at once with ease.
\n– **Detailed Stats**: Monitor bytecode scanning and transformation statistics in real-time.<\/p>\n
—<\/p>\n
## \u2728 Key Features<\/p>\n
– **\ud83d\ude80 High-Performance Engine**: Uses advanced ASM bytecode manipulation with parallel processing and fast-fail scanning.
\n– **\ud83d\udee1\ufe0f Thread Safety Enforcement**: Automatically wraps `Block.setType` and other world-modifying calls to execute on correct region threads.
\n– **\u26a1 Smart Schedulers**: Seamlessly converts `BukkitScheduler` to Folia’s `RegionScheduler`, `GlobalRegionScheduler`, or `AsyncScheduler`.
\n– **\ud83d\udce6 Seamless Compatibility**: Handles JAR signatures and automatically adds the `folia-supported: true` flag to `plugin.yml`.<\/p>\n
—<\/p>\n
## \ud83d\udcd6 Quick Start<\/p>\n
### 1. Using the Plugin (Recommended) ### 2. Using the GUI —<\/p>\n ## \ud83d\udd17 Links<\/p>\n – **\ud83c\udf10 Official Website** —<\/p>\n ## \ud83d\udcc4 License<\/p>\n Licensed under the **MARV License**. Modernize plugins for Folia<\/p>\n","protected":false},"featured_media":71721,"template":"","meta":{"_minecraft_slug":"folia-phantom","_minecraft_project_id":"kSB0jRWO","_minecraft_author":"Summer1106221","_minecraft_license":"LicenseRef-Marv-License","_minecraft_downloads":34,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"folia-phantom.zip","_minecraft_size_bytes":279998,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:52:25.059080Z","_minecraft_date_created":"2026-01-13T21:08:36.064084Z","_minecraft_date_modified":"2025-12-23T02:36:08.284418Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/folia-phantom","_minecraft_icon_attachment_id":71721,"_minecraft_imported_at":"2026-06-04T01:44:25+00:00","_minecraft_import_hash":"15d7b7c009c19f5d02bd7d3692c4d3ee","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,90,127,123],"mod_loader":[131,132],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-71720","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-optimization","mod_category-paper","mod_category-technology","mod_loader-folia","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n1. Download `Folia-Phantom-Plugin.jar` from Releases.
\n2. Drop it into your Folia server’s `plugins` folder.
\n3. Start the server and use `\/foliaphantom patch
\n1. Download `Folia-Phantom-GUI.jar`.
\n2. Launch it on your desktop (JDK 17+).
\n3. Drag legacy plugins into the sidebar and click **EXECUTE PATCH**.<\/p>\n
\n– **\ud83d\udcd6 Documentation Wiki**
\n– **\ud83d\udcbb GitHub Repository**<\/p>\n
\nCopyright \u00a9 2025 **Marv**.<\/p>\n","protected":false},"excerpt":{"rendered":"