NorrionProject Plugin Core - Changelog v1.0.0

🎉 Initial Release

This is the first stable release of NPPluginCore, the shared PaperMC plugin framework for the NorrionProject MMO ecosystem. It provides core infrastructure used by NPDiscord, NPEnderChest, and NPParties.

---

✨ Features

Core Framework

• AbstractProjectPlugin — Base plugin class with unified lifecycle (onEnable → enable()), NBT API preloading, and language registration
• DependencyManager — Declarative soft-dependency checks for other plugins (Vault, MMOCore, MMOItems, etc.)

Data Persistence (data/)

• DataManager — Central registry for all data managers with async save support via CustomFuture
• AbstractManager — Base classes for YAML-based persistence (single-file or directory-per-entity modes)
• YamlBackend — Default YAML storage implementation
• SqlBackend + IDataBackend — NEW: MariaDB/MySQL support with connection pooling (HikariCP)
• CoreConfigManager / CoreConfigData / CoreSqlConfig — Central configuration with SQL toggle

Internationalization (i18n)

• LanguageUtils — Loads JSON translation files from JAR → plugin data folder on first run, registers with NPCore's I18nHelper
• Editable language files — messages_en.json, messages_fr.json, languages.json copied to plugins/NorrionProject/ for server admins to customize
• Unified key structure — norrion-project.plugin-core.<category>.<key>

Command System (command/)

• MainCommand — Advanced command router with:
  • Sub-command support with required/optional arguments
  • Tab completion for arguments and sub-commands
  • Permission handling per command
  • Paginated /help with DefaultFontInfo/FontUtils for aligned output
• AbstractCommand — Base class declaring main command, sub-commands, arguments, permission, and allowed sender (AllowSender: PLAYER, CONSOLE, BOTH)
• CommandRegister — Central registration utility

Plugin Messaging Channels (pluginchannel/)

• ChannelManager — Registry for plugin↔mod (Fabric) communication channels
• ChannelData / ChannelEnum — Type-safe channel definitions with custom AbstractChannelData serialization
• ModModule — Built-in module handling norrion:mod channel (player mod presence tracking, quit listener)

Economy Integration

• Vault Economy — Automatic detection and registration via setupEconomy(), accessible via NPPluginCore.getEconomy()

NBT Utilities

• NbtUtils — Safe NBT read/write helpers (shadow-relocated de.tr7zw.nbtapi → fr.norrion.nbtapi)
• ListenerUtils — Common event utilities

Inventory & Item Configuration (inventory/)

• InventoryItemConfig / InventoryItemConfigManager — Data-driven item definitions from YAML (material, name, lore, enchantments, NBT, custom model data)
• CoreItems — Registry for core plugin items
• IItemConfigType / AbstractInventory — Type-safe item configuration and paginated inventory base class (added to support NPParties plugin split)

---

🐛 Bug Fixes

• Fixed NPE in NbtUtils — Guard against null ItemStack when reading NBT (commit 4173371)

---

Made with ❤️ for the NorrionProject community.
Questions? Open an issue on our Discord.