VortexPacks

VortexPacks

VortexPacks is the next generation of content management and distribution for Minecraft servers. It bridges the gap between Vanilla client limitations and Modded possibilities by offering a high-performance engine that handles everything from custom 3D models and blocks to shader-driven equipment and real-time version translation. Whether you are looking to create a fully custom MMORPG or simply want to elevate your server's aesthetics, VortexPacks enables you to do so without requiring a single client-side mod.

[hr]

Key Features
The Ultimate Custom Content Engine
Unleash your creativity with a system designed for limitless expansion:

• Advanced Custom Blocks: Utilize a massive array of Note Block states (with instrument, note, and powered variations) to define hundreds of unique blocks with custom break animations and sound profiles.
• Modern Equipment Assets: Native, full support for Minecraft's modern 1.21.2+ Equipment Asset system. Automatically generate high-definition armor sets, custom texture overlays, and unique individual piece designs.
• Interactive Furniture: Build complex decorative items featuring custom hitboxes, seat mechanics, and invisible barriers that allow players to interact with your furniture as if it were a vanilla block.
• Dynamic 3D Assets: Import and manage complex JSON models and high-resolution textures. Assets are automatically optimized and served to players through a real-time generation engine.
• Glyph & UI Management: Seamlessly bake custom fonts, emojis, and shift textures into chat and GUIs with built-in glyph mapping and ascent-validation.
• 3D Positional Audio: Go beyond text and visuals with custom .ogg sound support, including configurable audio categories, subtitles, and spatial positioning for a truly immersive atmosphere.

Compatibility that Actually Makes Sense
Don't let player versions limit your server's potential. VortexPacks includes a built-in translation and network modification layer:

• Dynamic Version Branching: Generate and serve tailored resource packs customized for each player's client version (from 1.18.2 up to 1.21.11+). The plugin automatically matches the client's version to a compatible resource pack, utilizing proper pack_format headers (such as format 75 for 1.21.11, 63 for 1.21.6, etc.) and native atlas configs.
• Zero-Dependency Netty Interception: Intercepts players' network connections using runtime reflection (with no compile-time NMS or Netty dependencies), resolving the Netty pipeline (supporting ModelEngine and standard connections) to inject packet listeners.
• Intelligent Packet Rewriting: On-the-fly translates modern 1.21.4+ item_model components back into legacy CustomModelData for older clients (1.18 - 1.21.1), ensuring everyone sees your content as intended. This includes unpacking, modifying, and repacking nested bundle packets (ClientboundBundlePacket).
• Robust Atlas Normalization: Features automatic Atlas generation and texture alignment. Dynamically handles split item/block atlases on 1.21.6+ clients to prevent duplicate-sprite pack load errors.
• Automated Equipment Validation: Automatically prunes generated equipment models with missing texture layers to prevent client-side pack load errors.
• Universal Importer: Moving from Oraxen or other systems? The Intelligent Importer maps your existing configurations directly into the Vortex ecosystem with a single command.

Built-in Shader Engine & Text Effects
Go beyond standard Minecraft aesthetics with a powerful, dynamic shader pipeline:

• Dynamic Text Shader Effects: Compile and bundle custom text rendering shaders (rendertype_text) mapped to custom color codes. Unleash premium text effects like:
  • Movements: Waving, iterating, flipping, skewing, growing, fade, blinking, glowing.
  • Visuals: Custom outlines, multi-color gradients, chromatic aberration, shimmers, rainbow cycles, metallic glints, and animated fire overlays.
• Shader-Driven Legacy Armor: In legacy clients (under 1.21.2), render complex custom armor textures, colors, animations (frames, speed, interpolation), and emissivity maps using leather overlays and vertex shaders driven by color-coded lookup keys.

Built for Developers & Power Users
VortexPacks isn't just a plugin; it's a platform:

• Robust Developer API: Directly access managers via the VortexPacksApi singleton to interact with:
  • BlockManager & FurnitureManager for custom mechanics.
  • ItemManager & ItemRegistry for custom items.
  • ArmorManager & GlyphManager for visuals and interface customization.
  • PackGenerator & PackService for programmatic resource pack building and config reloads.
• MSPT-Optimized Performance: Optimized from the ground up for Paper servers. Detects Paper's native disable-interaction Note Block settings to minimize right-click overhead, handling note block interactions with zero impact on server MSPT.