🪄 MysticEssentials v1.0.0-alpha.12

Release Date: December 2025 Target: NeoForge / Fabric 1.21.x Status: Alpha — major rewrites, several systems still in flux

---

🚀 Alpha 12 Overview

Alpha 12 focuses on chat corrections, teleportation subsystem rewrites, help system fixes, and major placeholder improvements, while continuing the stabilization effort for cross-platform compatibility.

This release fixes several long-standing bugs but also reveals deeper issues still being addressed in Alpha 13.

---

✔️ Fixes & Improvements in Alpha 12

🧩 Chat Pipeline & LuckPerms

Fixed

• LuckPerms placeholders now resolve per-sender and per-viewer correctly
• Rank confusion bug resolved (all players previously showed the sender’s prefix)
• Private messaging no longer falls back to vanilla whisper
• Vanilla join/quit messages suppressed (custom messages now display exclusively)
• Help system replaced with /mhelp + pagination fixed

---

🧭 Teleportation System Rewrite

Fixed

• /tpaccept, /back, /deathback, and /warp now route through the unified Teleports handler

• Warmups cancel properly on:

  • movement
  • damage
  • dimension change

Note: Cooldowns/warmups are still not firing for some commands — see Known Issues below.

---

🗂 System Message Improvements

Fixed

• Duplicate join and leave messages
• Death messages formatted using combat tracker
• Redis-compatible MiniMessage formatting

Note: Death messages still duplicate under certain loading conditions — see Known Issues.

---

🔍 Misc Fixes

• AFK activity tracking properly marks movement & rotation
• Invsee closes cleanly on dimension changes
• Last-location and death-location tracking corrected
• First-join spawn teleport fixed (respects bed/anchor rules)

---

❗ Remaining Known Issues (Will be addressed in Alpha 13)

---

⛔ 1. Death messages are still duplicated

Even after suppressing vanilla broadcasts, the combat tracker output is firing twice in some lifecycle paths (especially NeoForge). Resolution planned: ✔ Move death message interception into a dedicated mixin to guarantee vanilla suppression on both loaders.

---

⛔ 2. Cooldowns & Warmups still not firing for some teleport commands

Even though the Teleports API is unified, the following still bypass cooldowns + warmups:

• /tpaccept
• /tpahere
• Direct home/warp → Teleports.pushBackAndTeleport paths

Cause: These commands execute task.run() immediately instead of going through WarmupManager.

Resolution planned: ✔ Wrap all Teleports.* calls in WarmupManager ✔ Enforce cooldown check before execution ✔ Add shared TeleportContext for easier rule evaluation

---

⛔ 3. AFK Mentions Not Working

When a user mentions an AFK player:

• The ping is not canceled
• The sender receives no AFK notification
• The AFK mention system appears to be skipped entirely

Cause: The new chat pipeline processes modifiers after pb4 placeholder application, skipping AfkPingUtil under some conditions.

Resolution planned: ✔ Move mention detection before custom pipeline handling ✔ Implement sender-side notification override ✔ Allow configurable AFK mention formatting

---

⛔ 4. <item> and <inv> Chat Tags Broken

• <item> fails to serialize in some client contexts
• <inv> shows incorrect inventory snapshots
• <inv> also allows item insertion/removal, causing permanent item deletion

Resolution planned: ✔ Lock inventory GUI → read-only ✔ Replace serialization with direct component NBT copy ✔ (If required) Use mixins to override server-side packet hack behavior

---

⛔ 5. Kits Redemption Visual Glitch

Redeeming a kit sometimes:

• Leaves ghost items
• Shows empty slots until a manual refresh
• Causes client desync when rewards overlap with open inventories

Resolution planned: ✔ Force client inventory sync packet after kit application ✔ Prevent overlapping slot writes ✔ Track last redemption state to avoid UI duplication

---

🔧 Developer Notes for Testers

If you're testing Alpha 12, please focus on:

Teleportation

Try invoking:

/tpa
/tpahere
/tpaccept
/back
/warp <name>

…with and without permissions:

• messentials.teleport.cooldown
• messentials.teleport.cooldown.bypass
• messentials.teleport.warmup
• messentials.teleport.warmup.bypass

Chat

Test:

• AFK mentions
• Rank placeholders
• Cross-server (Redis) messaging
• Item/inventory chat tags

System Messages

Verify no duplication in:

• Join
• Quit
• Death

---

❤️ Thank You

Alpha 12 would not exist without your debugging, logs, and patience. Alpha 13 will focus entirely on bug closure, mixins where appropriate, and completing the teleportation subsystem.