🏷 MysticNameTags v1.2.0

---

✨ Glyph Nameplate System Update

This update focuses on continued improvements to the experimental Glyph Nameplate system, moving it closer toward a stable and usable foundation.

While still evolving, the system has received meaningful stability, behavior, and performance improvements.

---

🔧 Improvements

Rendering Stability

• improved consistency of glyph positioning
• reduced visual jitter in nameplate elements
• better alignment across different player states

---

Attachment Behavior

• improved handling of glyph attachment to player entities
• more stable positioning during movement and rotation
• reduced desync between player and glyph objects

---

Update Handling

• improved update behavior when:
  • tags change
  • player state updates
  • nameplates refresh
• reduced unnecessary re-application of glyph effects

---

Internal Cleanup

• cleaned up glyph rendering pipeline
• improved organization of glyph-related systems
• reduced redundant operations in update cycles

---

🌍 Cross-World Stability Improvements

A major stability improvement has been introduced for multi-world environments.

Changes

• added cross-world support for nameplates
• nameplates now safely handle players moving between worlds
• prevented crashes caused by nameplate entities persisting across worlds

New Fail-Safe System

• implemented a fail-safe system for glyph/nameplate loading
• if a nameplate fails to load while a player is in another world:
  • the server world will not crash
  • the player will not crash
• nameplates will safely skip or recover instead of causing fatal errors

Result

• significantly improved stability for multi-world servers
• safer handling of edge cases during world transitions

---

⚡ Performance Improvements

• reduced excessive update calls in certain scenarios
• improved efficiency of glyph refresh handling
• better control over when glyphs are re-rendered

⚠ Glyph nameplates are still more performance-heavy than standard nameplates.

---

🔗 Integration Update

EcoTalesQuests Support (Early Integration)

• added support for Adventurer Rank nameplate overrides
• allows quest progression systems to influence player nameplates

This integration will expand further as EcoTalesQuests introduces a more complete API layer. Current support is implemented with limited access points and may be expanded once an official API is available.

---

🛠 Bug Fixes

• fixed multiple edge cases causing glyph desync
• improved stability during player join/leave events
• resolved inconsistencies when refreshing nameplates
• general stability improvements across glyph-related systems

---

⚙ Glyph Update Behavior (Important)

To improve performance and prevent unnecessary load across multiple worlds, glyph nameplates are not forcefully refreshed on reload.

Behavior

• /mnatags reload does not refresh all active glyph nameplates
• prevents mass updates across all worlds

---

When do nameplates update?

Glyph nameplates update naturally when:

• a player equips a tag
• a player joins a world
• a player’s state changes
• a refresh event is triggered internally

---

Manual Refresh

• players can re-equip their tag to force an update

---

Why this exists

• prevents cross-world update spikes
• avoids large-scale entity refresh lag
• improves scalability and stability

---

⚙ Recommended Glyph Settings

These configurations are optimized based on server size and expected player load.

---

🟢 Small Servers (1–15 players)

Goal: Maximum visual quality

"experimentalGlyphUpdateTicks": 1,
"experimentalGlyphMaxEntitiesPerPlayer": 72,
"experimentalGlyphViewerActivationDistance": 12.0,
"experimentalGlyphViewerDropDistance": 14.0,
"experimentalGlyphViewerRefreshActiveMs": 1,
"experimentalGlyphViewerRefreshIdleMs": 50,
"experimentalGlyphIdleFollowIntervalMs": 50,
"experimentalGlyphRotationSyncIntervalMs": 1,
"experimentalGlyphMaxLines": 2,
"experimentalGlyphMaxCharsPerLine": 32

✔ smooth animations ✔ highest visual fidelity ✔ minimal compromise

---

🟡 Medium Servers (15–40 players)

Goal: Balanced performance + visuals

"experimentalGlyphUpdateTicks": 2,
"experimentalGlyphMaxEntitiesPerPlayer": 48,
"experimentalGlyphViewerActivationDistance": 10.0,
"experimentalGlyphViewerDropDistance": 12.0,
"experimentalGlyphViewerRefreshActiveMs": 5,
"experimentalGlyphViewerRefreshIdleMs": 75,
"experimentalGlyphIdleFollowIntervalMs": 75,
"experimentalGlyphRotationSyncIntervalMs": 5,
"experimentalGlyphMaxLines": 2,
"experimentalGlyphMaxCharsPerLine": 24

✔ reduced entity load ✔ smoother scaling ✔ still visually strong

---

🔴 Large Servers (40+ players)

Goal: Stability and scalability

"experimentalGlyphUpdateTicks": 3,
"experimentalGlyphMaxEntitiesPerPlayer": 32,
"experimentalGlyphViewerActivationDistance": 8.0,
"experimentalGlyphViewerDropDistance": 10.0,
"experimentalGlyphViewerRefreshActiveMs": 10,
"experimentalGlyphViewerRefreshIdleMs": 100,
"experimentalGlyphIdleFollowIntervalMs": 100,
"experimentalGlyphRotationSyncIntervalMs": 10,
"experimentalGlyphMaxLines": 1,
"experimentalGlyphMaxCharsPerLine": 16

✔ significantly reduced entity count ✔ lower update frequency ✔ optimized for performance

---

💡 General Tips

• lowering MaxEntitiesPerPlayer has the biggest performance impact
• reducing MaxCharsPerLine drastically cuts entity usage
• increasing refresh intervals improves server performance
• use fewer lines for large servers

---

🚧 Ongoing Work

The glyph system is still actively being improved.

Current focus:

• continued stability improvements
• performance optimization
• reducing visual inconsistencies

---

🗺 Roadmap

Short-Term (1.2.x)

• continued progress toward a stable glyph nameplate system
• support for images in nameplates and tags
• expanded integration support for additional mods
• deeper compatibility with external systems

---

Mid-Term (Toward 2.0)

• major improvements to glyph rendering performance
• expanded customization capabilities
• deeper integration-driven behavior

---

Long-Term (v2.0 Goal)

• 🔥 full nameplate system revamp
• redesigned rendering approach
• improved performance and scalability
• more flexible architecture

---

📦 Summary

MysticNameTags v1.2.0 is a focused glyph system update with major stability improvements.

Highlights

• ✨ improved glyph rendering stability
• 🌍 cross-world support + crash fail-safes
• ⚙ optimized reload behavior to prevent performance spikes
• 🔧 better attachment and positioning behavior
• ⚡ reduced unnecessary update cycles
• 🔗 EcoTalesQuests Adventurer Rank support
• 🛠 multiple bug fixes
• 🗺 roadmap toward a full nameplate revamp in v2.0