BlueMap is a high-performance, strictly optimized fork of BlueMap, engineered specifically for the BTC Studio infrastructure. This fork drops support for legacy platforms (Spigot, Bukkit, older NMS, Fabric, Forge) to provide native, blazingly fast integration with Paper and Folia.
Warning
PLATFORM COMPATIBILITY NOTICE This fork is STRICTLY for Paper 1.21.11+ and Folia 1.21.11+. Legacy compatibility layers have been removed to maximize performance. If you are not running modern Paper/Folia, this plugin will not function.
- Native Folia Support: Deeply integrated with Folia's
RegionSchedulerandGlobalRegionScheduler. No main-thread blocking operations. - Async Rendering: Map updates happen asynchronously, respecting regionized threading rules to prevent server lag.
- Zero-Overhead Logic: Removed unnecessary abstraction layers for non-compatible platforms.
- Custom Block Support: Natively renders
CraftEnginefurniture and custom blocks. - Auto-Discovery: Automatically parses CraftEngine configuration packs to resolve custom models.
- Zero-Config: Works out of the box by scanning
plugins/CraftEngine.
- Java 21 Native: Leveraging the latest JVM optimizations for maximum throughput and memory efficiency.
- Legacy Cleanup: Removed support for Forge, Fabric, Sponge, and CLI to focus purely on the server plugin implementing.
- BTC Core Integration: Native detection of BTC Core platform to enable specialized optimizations.
- Steamlined Loading: Faster startup times through reduced library dependencies.
- Plug & Play: Automatic threading context detection for both Paper and Folia environments.
BlueMap is optimized out-of-the-box, but stays configurable via core.conf and webapp.conf in plugins/BlueMap.
| File | Description |
|---|---|
core.conf |
Core rendering settings, threading, data storage. |
webapp.conf |
Webserver settings, port, external webroot. |
No manual configuration needed. The plugin automatically detects configurations in plugins/CraftEngine/packs or plugins/CraftEngine.
Requires Java 21.
# Clean and compile the project
./gradlew clean buildThe resulting artifact will be in implementations/paper/build/libs/.
This project is built upon the innovation of the broader Minecraft development community:
- BlueMap - The original project.
- Custom BTC-CORE Patches: Proprietary to BTC Studio.
- Upstream Source: Original licenses apply to their respective components from BlueMap (MIT).
Fork maintained by BTCSTUDIO