🪄 MysticEssentials v1.0.0-alpha.06

Release Date: November 8 2025
Target: NeoForge / Fabric 1.21.x

⚙️ Major backend refactor focusing on AFK stability, player activity tracking, and enhanced command UX across both modloader platforms.

---

🚀 Core Framework Updates

• AFK Detection & Activity System

  • Reworked AFK logic to only mark activity on valid player chat when not muted.

  • Added integrated chat mention pings via AfkPingUtil.handleChatMention() for AFK callouts.

  • Fixed concurrency issues with punishment checks and AFK timers.

  • Safer handling of unsigned vs. signed chat content in ServerMessageEvents.ALLOW_CHAT_MESSAGE.

• AFK Pool System

  • Expanded AFK pool setup through the new AfkPoolSetupCmd.

  • Added persistent runtime edits synced with AfkPoolsStore.

  • Improved compatibility with default configs and live reloading.

  • Added documentation and edge-case safety for editing defined pool regions.

---

🧱 Command System Enhancements

🛠️ /workbench

• Fixed issue where crafting menu closed instantly.

• Added proper SimpleMenuProvider wrapper.

• Permission: messentials.workbench.use.

📜 /recipe

• Fully implemented recipe lookup with tab completion.

• Added auto-suggestions for all registered recipe IDs.

• Supports clean result feedback and component formatting.

📖 /help

• Re-built pagination with clickable next/prev navigation.

• Added hover and click events for easier browsing.

• Fixed out-of-range page crashes and improved layout.

☠️ /kill

• Added flexible entity targeting system:

  • /kill — self only

  • /kill players [radius]

  • /kill mobs [radius]

  • /kill entities [radius]

  • /kill all [radius]

• Fixed infinite-AABB issue that caused lag spikes.

• Permissions introduced:

  messentials.kill
  messentials.kill.players
  messentials.kill.mobs
  messentials.kill.entities
  messentials.kill.all
  messentials.kill.exempt
  

---

⚙️ Infrastructure & Integration

• Unified PlayerDataStore

  • Post-merge of HomeStore + KitsPlayerStore.

  • Stabilized saving/loading cycle across Fabric and NeoForge.

  • Integrated with AFK, TPA, and teleport warmup systems.

• Event Hooks

  • NeoForge: refined ServerChatEvent logic to defer to punishment system before marking activity.

  • Fabric: mirrored lifecycle parity with same tick ordering.

  • Both: ensured consistent AfkService.markActive() flow.

---

💬 Message & Config Updates

• messages/en_us.json

  • Added new messages for AFK/mute feedback.

  • Improved teleport and cooldown strings for readability.

• MEConfig

  • Added comments for AFK pool configuration options.

  • Implemented fallback defaults for missing values.

---

🧹 General Improvements & Fixes

• Standardized Component.literal usage across all commands.

• Simplified command registration boilerplate.

• Reordered command registration for cleaner /help output.

• Fixed possible NPEs in activity and teleport systems.

• Added inline documentation to major utility classes.

---

🧩 Internal Utilities

• AfkService

  • Modularized mark-active tracking (movement, chat, interaction).

  • Thread-safe concurrent player state map.

  • Improved tick synchronization.

• MessagesUtil

  • Simplified component creation and color formatting.

  • Unified MiniMessage-style placeholders.

---

🧾 Summary

MysticEssentials v1.0.0-alpha.06 introduces a complete AFK subsystem overhaul, adds refined command UX (Help / Kill / Recipe / Workbench), and improves platform parity between NeoForge & Fabric.
This update lays the groundwork for the upcoming 1.0.0 stable release, focusing on server performance, clarity, and cross-compatibility.

---

🔖 Commit Type Overview

Type	Count	Description
✨ Feature	6	AFK pool, recipe, kill commands
🐛 Fix	8	AFK logic, help pager, AABB crash, mute state
🔧 Refactor	5	Command registrar & event hooks
🧩 Internal	3	Config & storage consistency

---

🧰 Contributors

Developed by: Alphine
Project: MysticHorizons / NexxaWave Studios

---

Full Changelog: https://github.com/L8-Alphine/MysticEssentials/compare/1.0.0-alpha.05...1.0.0-alpha.06