vortexia-core

# vortexia-core > [!WARNING] > This is an **experimental** build of Vortexia Core under active development. Features are subject to change, and APIs or behaviors may break at any time. Use at your own risk in production environments! The core module of the **Vortexia** Minecraft Plugin ecosystem (version 1.21+). This module is responsible for Storage, Identity handling, Security (including 2FA PIN protection & Auth Hook systems), Wireless Networks, Custom Grids, and on-screen HUD displays. ## Features - **Storage & Caching**: Manages data operations across various platforms such as MySQL and SQLite, along with highly optimized caching powered by Caffeine. - **Identity Security (2FA PIN)**: The `IdentityMigrationHelper` mechanism prevents Account Hijacking when a player changes their name (changing UUID) by requiring a PIN verification before syncing changes to the database. - **AuthHook System (Delayed Execution)**: Resolves conflicts between Vortexia's PIN Security and external authentication plugins (e.g., AuthMe). Vortexia pauses its operations to let the Auth Plugin handle the baseline login before requiring the 2nd-layer PIN. - **Dynamic Grid & Economy**: A ticking multi-block network manager (`CoreGridManager`) handling energy routing, machinery linkages, and modular connections. - **WAILA HUD Display**: A real-time, highly-configurable look-at block display (`CoreWailaManager`) featuring support for Folia/Paper and customizable screen position parameters. - **Interactive Guide Book & GUI**: A user-friendly interface (`GuideGUI`) allowing players to learn plugin systems, view recipes (`RecipeViewerGUI`), and retrieve custom items if authorized. - **Custom Item & Recipe Registries**: Dynamically registers unique custom items (`CoreItemRegistry`) and advanced recipes (`CoreCustomRecipeManager`). - **Item Owner Tagging**: Automatically tags the crafter's UUID and username onto tools, weapons, and armors upon crafting. This ownership is safely preserved and transferred when repairing (Anvil), upgrading (Smithing Table), or refining (Grindstone) until the item is completely broken/destroyed. - **Shadow Inventory Sync**: Safe inventory and Ender Chest sync and recovery based on Citizen ID (CID) to prevent data loss or duplicate items during online-mode flips. Features history snapshot logs. - **Loader-Aware Update Checker**: Scans for the latest GitHub releases in the background and dynamically filters them based on the current server loader (e.g. Paper, Velocity, Sponge) to ensure version compatibility. - **CommandAPI & NBT**: Integrates deeply with specialized libraries for Advanced Command Parsing and System Item Handling.