Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt

Use this file to discover all available pages before exploring further.

Comparison: BTCMobs vs MythicMobs

This document provides a technical comparison between BTCMobs and MythicMobs. As of February 2026, BTCMobs has achieved 100% Feature Parity with MythicMobs v5.11+, effectively allowing it to serve as a drop-in replacement for legacy configurations while offering superior performance and additional features.
[!NOTE] Drop-In Compatibility: BTCMobs supports all standard Mechanics, Conditions, and Targeters. You can copy your existing Mobs, Skills, and Items folders directly.

Core Architecture & Performance

The most significant differences lie in how each engine handles internal processing and server resources.
FeatureMythicMobs (Legacy)BTCMobs (Modern)
Language & RuntimeJavaKotlin & JVM 21+ (Modern Optimizations)
ConcurrencySingle-Threaded (Main)Native Folia & Async Support (Region-Threaded)
Config ParsingSynchronous (Blocking)Background Thread Parallel Parsing
Math EngineStandard MathOptimized Vector Pools & Variable Math
VisualsArmorStands (High Traffic)Display Entities (Zero Server Lag)

Native Folia Support

Unlike legacy systems, BTCMobs is built for Advanced Slime Paper and Folia. It utilizes Region Schedulers to tick mobs in parallel across CPU cores. It literally cannot freeze your main thread because it doesn’t run solely on it.

Feature Parity & Extensions

BTCMobs implements the entire MythicMobs feature set.

Exclusive Features

BTCMobs extends the format with modern capabilities:
  1. Display Entities: Native displayBlock, displayItem, displayText mechanics that use Packet-based Display Entities for ultra-smooth, low-bandwidth effects.
  2. Formation AI: The squad mechanic allows mobs to coordinate attacks or use group tactics.
  3. Modern Components: Full Adventure Component support for all messages and items (MiniMessage).
  4. 1.21.1 Native: Support for windcharge, windburst, maceattack, and disableshield mechanics.
  5. RPGCore Integration: Level-based drop and XP multipliers via zero-dependency reflection bridge.
  6. Full Menu System: YAML-based menus with MiniMessage and data-driven pagination.
  7. Advanced Spawners: Structure detection, light-level ranges, and vanilla spawn overrides.
  8. Atomic Execution: Compiled bytecode sequences for mechanics, providing a 15-20% performance boost over traditional reflection-based systems.

Summary: Which to Use?

ScenarioRecommendation
Legacy Version SupportMythicMobs (Supports versions older than 1.19/1.20)
Modern PerformanceBTCMobs (Built for 1.21.11+ Paper/Folia)
Complex VisualsBTCMobs (Display Entities save massive TPS)
High Player CountsBTCMobs (Async/Region threading scales linearly with cores)

This benchmarking reflects the strict 100% parity status achieved through Phase 12 (February 2026).