🌟 MysticEssentials

A modern, server-side Essentials-style utility mod for NeoForge and Fabric, built for modded Minecraft servers.

✅ No client installation required
⚡ Lightweight, fast, and configurable
🧩 Designed for large & modded servers

---

🧭 Overview

MysticEssentials provides a refined set of administrative and quality-of-life tools inspired by EssentialsX, rebuilt for modern Minecraft mod loaders.

All features are:

• Fully server-side
• Stored in human-readable JSON
• Shared logic across NeoForge & Fabric

---

🔐 Vault System (GUI-Based)

• /vault
• /vaultadmin

Vault Permissions:

messentials.vault
messentials.vault.others
messentials.vault.amount.<number of vaults>
messentials.vault.row.<1-6>
messentials.vault.item.<item_name>
messentials.vault.rename
messentials.vault.rename.color.<code>
messentials.vault.rename.format.<format letter>
messentials.vault.reset [This allows resetting the vault to defaults AND clearing items]
messentials.vault.reset.exempt
messentials.vault.reset.all

A powerful, fully GUI-driven personal vault system:

• Paginated vault selector
• Unlimited vault support (permission-based)
• Vault settings GUI:
  • Rename vaults (with color support)
  • Set custom vault icons
  • Reset individual vaults
  • Reset all vaults (admin-only)
• Per-player vault storage
• Safe SNBT item serialization

✔️ No commands required — everything is done in GUIs

---

🏠 Homes & Warps

• /home, /sethome, /delhome
• /warp, /setwarp, /delwarp
• Permission-based limits
• Configurable cooldowns & warmups

---

🧭 Teleportation

• /tpa, /tpaccept, /tpdeny
• /back (death & teleport return)
• Spawn fallback handling

---

💤 AFK System

• Manual & automatic AFK detection
• AFK Pools (region-based AFK zones)
• AFK reward commands & items
• Idle kick support

---

💬 Chat System

• Private messages & replies
• AFK mention notifications
• Clickable links (http / https)
• Localized messages (en_us, es_es)
• Optional Redis-backed cross-server support

---

🛠️ Moderation Tools

• Warning system with persistent logs
• Moderation tracking & audit logs
• God mode & freeze support
• More moderation features planned

---

🧩 Technical Highlights

• 🖥️ Server-side only (clients do NOT need the mod)
• 📁 JSON-based storage (safe & readable)
• 🧱 Modular architecture
• 🔄 NeoForge & Fabric parity
• 🧵 Optimized for large servers

---

📂 Configuration

All files generate automatically on first startup:

/config/mysticessentials/
├─ config.json
├─ messages/
│ ├─ en_us.json
│ ├─ es_es.json
├─ chat/
├─ playerdata/
├─ vaults/

⚠️ On major updates, server owners may need to delete config.json
or message files to regenerate new keys (see changelog).

---

🔧 Installation

1. Download MysticEssentials from Modrinth
2. Place it into your server’s mods/ folder
3. Start the server
4. Edit files under /config/mysticessentials/ if desired

✔️ Works on NeoForge and Fabric
✔️ No client installation required

---

📜 Requirements

• Minecraft 1.21+
• NeoForge or Fabric Loader
• Java 21+

---

🪪 License

Licensed under the GNU General Public License v3.0

---

👤 Credits

Created by Alphine
Powered by MysticHorizonsMC

---

🌐 Links

• 🌍 Website: https://mystichorizons.net
• 💬 Discord: https://discord.gg/3mBtPsTP5t
• 💻 Source Code: https://github.com/L8-Alphine/MysticEssentials

---

MysticEssentials — The essential toolkit for modern Minecraft servers.