PrayTime

# 🕋 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.