🕋 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 SA | Community standards in mind:
Asynchronous API calls to prevent main thread lag.
Local Caching to minimize external requests.
Lightweight NBT/Data handling for player profiles.
