MagicCarpet v1.0.1 - Custom 3D Models, Fuel Subsystem & Modernization
BREAKTHROUGH: Custom 3D Models & ItemDisplays! (CustomModelData) Bring your server's resource pack to life! Players are no longer limited to riding vanilla glass blocks.
Ultimate 3D Support: Seamlessly mount 3D Hoverboards, Magic Broomsticks, Nimbus Clouds, or actual high-poly textured carpets!
ItemDisplay Native Engine: Automatically detects custom-model-data tags in config. Dynamically swaps the underlying system from BlockDisplay to ItemDisplay on-the-fly while preserving all scale vectors, tilt mechanics, and pivot centroids.
Intuitive GUI Preview: Custom 3D models aren't just rendered in flight; they are fully visible inside the Carpet Styles selection menu icon inventory too!
INTRODUCING: Kinetic Fuel & Energy Subsystem The definitive economy balancer for Survival, Faction, and RPG networks! You can now tie flight to dynamic energy consumption.
Smart Drainage Matrix: Flight uses differentiated vectors. Standing still drains minimal energy (`0.2/sec`), while traversing the skies drains more (`1.0/sec`), promoting active gameplay.
Dynamic BossBar Integration: Real-time visual telemetry in a fully customizable, animated BossBar displaying current status (`⚡ Magic Carpet Energy: 85%`).
Safe Depletion Gate: When energy hits 0, the carpet disintegrates automatically, immediately triggering the built-in Safe Fall Protection to prevent death by gravity!
SMART INTERACTIVE REFUELING
Material Absorption: Right-click with designated fuels (Ender Pearls, Amethyst, Glowstone) anywhere to recharge.
Visual Explosion: High-grade firework particles and electrical soundscapes trigger on absorption to give players instant visceral feedback.
PURE NATIVE MODERNIZATION (Zero-Deprecation)
Registry Sound Hooking: Fully updated to 1.21.3+ API specs. Sound lookup no longer uses legacy hardcoded enums; it dynamically interacts with the Paper SOUND_EVENT Registry for total futurascope safety.
Kyori Adventure Native Parsing: Eradicated deprecated legacy string builders. Replaced old text formats with modern deserialization pools for lighter RAM footprint and perfect RGB formatting.
Hot-Swapping Schema Auto-Updater: Backported LootGlow's elite YAML migration engine! Server admins can upgrade seamlessly; missing keys across all configs (config.yml, messages.yml, gui.yml) are intelligently merged automatically without wiping comments or custom settings.
HYGIENE & CRITICAL FIXES
Destroyed Vector Leak: Fixed a subtle resource leak inside the tracker thread. Offline transitions now correctly trigger total physical disposal of display entities every time.
Language Standardization: Extracted remaining hardcoded French fallbacks in system listener scopes and standardized them to pure, clean English.
WORLDGUARD & REGION MONITORING Comprehensive claim protections for your spawn and arenas.
Fly-Flag Respect: Native hooks to WG7 API to enforce fly deny regions. Players attempting to summon carpets inside restricted fly zones are blocked automatically.
Real-Time Border Cross Check: If players fly into a blacklisted region, their carpet dissolves instantly.
Soft-Depend Resilience: Isolated wrapper pattern guarantees the plugin runs perfectly even if WorldGuard isn't installed on the server.
PHYSICAL BOUNDARIES & DISCONNECT SAFETY
Dynamic Ceiling/Floor Lock: Admins can lock height limits (max-height and min-height). Players attempting to jump/fly higher than the ceiling are gently pushed back.
Offline Trace Snap: When players disconnect while flying, the system traces solid ground below and teleports them safely down before unloading, preventing fall-death on login.
Idle Auto-Despawn Timer: Saves server performance by dissolving carpets of players standing absolutely still for too long.
Anti-Spam Summon Cooldown: Configurable rate-limit (e.g. `3s`) preventing users from flooding server tasks by spamming toggles.
RENDERING & VISUAL TWEAKS
Force Full Brightness: Display entities can now ignore standard lightmaps, glowing intensely even in deep caves!
Dynamic Vertical Offset: Micro-manage the distance between the player's soles and the carpet block via config.
BALANCED. MODERN. SPECTACULAR. MagicCarpet is now ready to dominate any Economy network!