CraftEngine

CraftEngine is a next-generation, high-performance plugin for custom content implementation, engineered specifically for the BTC Studio infrastructure. This fork is optimized for 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.

---

🚀 Key Features in Detail

⚡ Concurrency & Threading (Folia Native)

• Hardcoded Folia Scheduler: Deeply integrated FoliaExecutor ensures that all tasks (Global & Region-synced) are handled correctly without the overhead of dynamic platform detection.
• Zero-Overhead Logic: Slashed unnecessary logic checks for non-Folia platforms, resulting in faster tick-to-task execution.

🛠️ Core Optimisations & Debloating

• Java 21 Native: Leveraging the latest JVM optimizations for maximum throughput and memory efficiency.
• Legacy Cleanup: Removed legacy compatibility code for older versions, focusing exclusively on 1.21.11+.
• Adventure Native: Full integration with Kyori Adventure for modern text handling.

🌍 Deployment & Startup

• Streamlined Loading: Faster startup times through optimized resource discovery and reduced library dependencies.
• Plug & Play: Automatic threading context detection for both Paper and Folia environments.

---

⚙️ Configuration

CraftEngine is primarily tuned via its configuration files.

Key Settings

Key	Default	Description
config_version	61	Internal configuration version.
latest_supported_version	1.21.11	Target Minecraft version.
lang_version	44	Language file version.

---

🛠 Building & Deployment

Requires Java 21.

# Clean and compile the project
./gradlew clean build

The artifact will be generated under /target folder.

---

🤝 Credits & Inspiration

This project draws inspiration from the broader Minecraft development community:

• Paper - High-performance Minecraft server.
• LuckPerms - Permission management.
• Fabric - Modding toolchain.
• packetevents - Packet manipulation.
• DataFixerUpper - Data migration.
• ViaVersion - Protocol translation.

Core Dependencies

• cloud-minecraft - Command framework.
• adventure - Text API.
• byte-buddy - Runtime code generation.

---

🌍 Translations

1. Clone this repository.
2. Create a new language file in: /common-files/src/main/resources/translations
3. Submit a pull request to dev branch for review.

---

📜 License

• Custom BTC-CORE Patches: Proprietary to BTC Studio.
• Upstream Source: GPLv3 license applies to original CraftEngine components.

---

CraftEngine API

repositories {
    maven("https://repo.momirealms.net/releases/")
}

dependencies {
    compileOnly("net.momirealms:craft-engine-core:0.0.66.4")
    compileOnly("net.momirealms:craft-engine-bukkit:0.0.66.4")
}

---

Fork maintained by BTCSTUDIO