FaithBreak
PluginLicenseRef-All-Rights-Reserved

FaithBreak

A thoughtful plugin that automatically detects prayer times based on players' locations and gently kicks them for a 12-minute break. It helps Muslim players maintain their prayer schedule while encouraging everyone to take healthy breaks from gaming.

12.5K
Downloads
7
Followers
3 months ago
Updated
📦
7
Versions

📖About FaithBreak

🌟 Join Our Discord for Giveaways & Events! 🎮

Join our Discord Server 🔗 for monthly giveaways & events where you can win coupon codes or plugins like AstralSwords Premium or TrimBlades! 🎨🚀


🕌 FaithBreak v1.3.1 — Persistence & Privacy Update! 🛡️

v1.3.1 brings persistent opt-out preferences and enhanced privacy controls! Your /non-muslim choice is now saved forever, and server admins have full control over location logging. 🚀


🔍 What Does FaithBreak Do?

FaithBreak helps Muslim players take breaks during prayer times.

🕰️ How It Works

  • Smart Location Detection — Automatically detects each player's location via IP
  • Accurate Prayer Times — Calculates prayer times for each player's specific location
  • Timely Reminders — 2 minutes before prayer, players are gently kicked
  • Break Duration — Players can't rejoin for 12 minutes, giving time for prayer
  • Multi-Language — Messages appear in each player's Minecraft language

🎯 Player Choice

Use /non-muslim to opt out permanently — no kicks, no reminders, saved forever.


Features

  • 💾 Persistent Opt-Out/non-muslim preference saved to file, survives restarts
  • 🔒 Privacy Controlslog-player-locations config option (default: OFF)
  • 🎮 Unified Commands — All commands under /fb for clean organization
  • 🧪 Kick Test Command/fb kick <prayer> for admins to test kick screen
  • 🔇 Silent by Default — No location logging unless explicitly enabled

💻 Commands

Player Commands

Command Description
/non-muslim Toggle opt-out (saved permanently)
/fb lang View current language
/fb lang <code> Change language (e.g., /fb lang ar_SA)

Admin Commands

Command Permission Description
/fb kick <prayer> OP Test kick screen (no 12-min timer)

🌍 Supported Languages — 10 Total

🇬🇧 English • 🇸🇦 Arabic • 🇵🇰 Urdu • 🇪🇸 Spanish • 🇫🇷 French
🇮🇩 Indonesian • 🇮🇳 Hindi • 🇩🇪 German • 🇵🇱 Polish • 🇳🇱 Dutch

Add more by creating [code].yml files in plugins/FaithBreak/messages/


⚙️ Configuration

debug-mode: false              # Detailed debug logging
log-player-locations: false    # Log player country/city (default: OFF)

FAQ

Will my opt-out be remembered?

Yes — saved permanently to file as of v1.3.1.

Is my location logged?

Not by default. Enable log-player-locations in config if needed.

I'm not Muslim, will I get kicked?

No — type /non-muslim once to opt out forever.

What about VPNs or local networks?

The plugin detects private IPs and disables itself.


🙏 Why I Made This

I made this plugin to help my fellow Muslim brothers and sisters stay on track with their prayer times. It's easy to get lost in Minecraft and forget 😅 — this plugin gives a gentle nudge at the right moment 🕌⏰

This plugin is automatically bundled with every plugin I make. Check out my other creations on Modrinth! 😉✨


🖥️ Need a Server?

Looking for reliable Minecraft hosting? Check out Atlass Hosting — affordable, fast, and perfect for your server!⚡


💬 Got suggestions or found a bug?
Jump into Discord and let me know!


☕ Support Me on Ko-fi

If you like my work, consider buying me a coffee:

ko-fi


Made with ❤️ for the Muslim Minecraft community

JazakAllahu Khairan (May Allah reward you with goodness) for using FaithBreak! 🤲