🕋 PrayTime - Advanced Prayer Management & Alerts

PrayTime is a high-performance, intelligent Minecraft plugin designed to bridge the gap between gaming and spiritual devotion. By utilizing real-time geolocation and precise astronomical calculations, it ensures players never miss their prayers while maintaining server fairness.

---

✨ Why PrayTime?

Unlike static reminder plugins, PrayTime is dynamic. It adapts to each player's specific location anywhere in the world, providing a personalized experience that respects their local schedule without requiring manual timezone configuration.

---

🌟 Core Features

• 🌍 Automated Geolocation: Seamlessly detects Country, City, and Timezone via IP (using the Aladhan API) — no setup needed from the player.
• 🕒 Dynamic API Integration: Automatically pulls and caches daily times for Fajr, Dhuhr, Asr, Maghrib, and Isha.
• ⚠️ Triple-Phase Notifications: Visual alerts via Titles, Subtitles, and Action Bars that countdown to the prayer.
• ⚔️ Combat Log Prevention: Runs configurable commands (like disabling PvP) the moment a warning starts to ensure players are safe to leave.
• 🔐 Mathematical Lockdown Engine: Prevents "offline dodging." If a player tries to log back in during an active prayer window, the system calculates the remaining time and restricts access until finished.
• 🛡️ Admin Control: Features a Global Whitelist, one-time bypasses (/praytime resume), and robust testing commands.
• ⚙️ Highly Configurable: Customize messages, calculation methods (e.g., Umm Al-Qura, MWL), and lockdown durations in config.yml.

---

🕹️ Player Modes

Players can choose how the plugin interacts with them:

• 🔴 Kick Mode (Strict): Receive UI warnings and a temporary kick during prayer time.
• 🟡 Reminder Mode (Soft): Receive UI warnings and chat reminders only. No kicks.
• ⚪ Off Mode (Exempt): Completely disables all notifications and restrictions.

---

🛠️ Commands & Permissions

Command	Permission	Description
/praytime	None	View your detected location and prayer agenda.
/praytime <mode>	None	Switch between Kick, Reminder, or Off modes.
/non-muslim	praytime.op	Shortcut to disable all notifications.
/praytime reload	praytime.op	Safely reloads the configuration.
/praytime whitelist <user>	praytime.op	Toggles a player in the bypass list.
/praytime resume <user>	praytime.op	Grants a one-time bypass for an active block.
/praytime test <type>	praytime.op	Simulate warnings/kicks for testing.
/praytime clearprayerdata	praytime.op	Clears the mapped user cache.

---

🚀 Performance

Designed with HellMC standards in mind:

• Asynchronous API calls to prevent main thread lag.
• Local Caching to minimize external requests.
• Lightweight NBT/Data handling for player profiles.