🪄 MysticEssentials v1.0.0-alpha.11

Release Date: December 1 2025
Target: NeoForge / Fabric 1.21.x

⚙️ This unified Alpha 11 release includes all changes from Alpha 07 through Alpha 11, delivering a complete cross-platform chat foundation, Adventure formatting pipeline, LuckPerms support, versioning improvements, and a Modrinth update checker.

---

🚀 Major Additions & Systems

💬 Cross-Platform Chat Architecture (Fabric + NeoForge)

• Implemented the shared ChatModule responsible for formatting, permissions, and routing.
• Added Fabric Chat Bridge (ServerMessageEvents.ALLOW_CHAT_MESSAGE).
• Added NeoForge Chat Bridge with full event parity to Fabric.
• Unified abstractions:
  • CommonPlayer
  • CommonServer
• Ensured consistent handling of:
  • Signed / unsigned chat messages
  • Permission checks
  • AFK activity marking
• Fixed Adventure → platform component conversion issues.

---

🎨 Adventure-Based Formatting Pipeline (Bundled)

• MysticEssentials now ships Adventure internally:
  • adventure-api
  • adventure-text-minimessage
  • adventure-text-serializer-gson
• Standardized MiniMessage as the primary formatting engine.
• Unified serialization for:
  • Hover events
  • Click events
  • Gradients
  • Rich formatting components
• Fixed multiline and nested MiniMessage tag issues.
• Ensured consistent chat rendering across Fabric + NeoForge.

---

🔑 LuckPerms Placeholder Support

• Added full support for LP placeholders:
  • Prefix
  • Suffix
  • Primary group
  • Meta key/value pairs
• Implemented unified placeholder resolver shared across all systems.
• Added graceful fallback for servers without LuckPerms.
• Fixed raw %placeholder% text appearing in chat.

---

⚙️ Core Infrastructure Enhancements

🧩 Unified Placeholder Engine

• Centralizes ME placeholders, LP placeholders, and external expansions.
• Improved nested tag expansion.
• Added async-safe logic for LP lookups during chat events.
• Reduced edge cases causing partial renders or dropped formatting.

---

🔧 Versioning Overhaul

• Introduced shared getVersion() method reading from gradle.properties.
• Eliminated version duplication across modules.
• Improved startup reporting:
  • Detected platform
  • Build type (release/dev/dirty)
  • ME version

---

🌐 Modrinth Auto-Update Checker

• Added passive startup check to compare installed version against Modrinth’s latest release.
• Prints
  • Installed version
  • Latest version
  • Update availability
• Does not auto-download or modify files.

---

💬 Message Output & Platform Parity

• Standardized all command/system output to consistent Adventure components.
• Unified message serialization on both modloaders.
• Synchronized chat event flow to ensure identical behavior between platforms.
• Improved handling of signed, unsigned, and modified messages.

---

🧱 Internal Architecture & Refactoring

• Moved large portions of chat code into the shared common module.
• Simplified formatting utilities and serializers.
• Improved debug logging for:
  • Chat events
  • Placeholder expansion
  • Module initialization steps
• Reworked component builders to maintain consistent formatting.

---

🧹 General Fixes & Stability

• Fixed multiple NPE sources during early boot initialization.
• Resolved platform parity issues in chat event ordering.
• Fixed hover/click event rendering bugs.
• Patched LP color inheritance conflicts.
• Fixed multiline MiniMessage parsing issues.
• Improved runtime resilience across Fabric, NeoForge, and mixed mod stacks.

---

🧾 Summary

MysticEssentials v1.0.0-alpha.11 is a cumulative release including all features and changes from Alpha 07–11.
It delivers:

• Full cross-platform chat system
• Bundled Adventure API
• LuckPerms prefix/suffix integration
• Unified placeholder engine
• Versioning overhaul
• Modrinth update checker
• Major stability improvements

This update forms the backbone of the upcoming Beta and 1.0.0 stable releases.

---

🔖 Commit Type Overview

Type	Count	Description
✨ Feature	9	Chat bridges, Adventure bundle, LP integration, version utilities, updater
🐛 Fix	20	Formatting, serializers, NPEs, parity issues
🔧 Refactor	12	Common module cleanup, formatting pipeline, platform logic
🧩 Internal	7	Diagnostics, logging, parser stability

---

🧰 Contributors

Developed by: Alphine
Project: MysticHorizons / NexxaWave Studios