Three Player Modes
Choose how prayer times affect you — your preference is saved permanently!

• Kick Mode (Default) — Kicked from server during prayer time (12-min break). Command: /muslim kick
• Reminder Mode — Chat reminder only, no kick! Command: /muslim reminder
• Opt-Out — Nothing happens, fully opted out. Command: /non-muslim

Smart Kick Screen
The kick screen now shows your current mode and explains how to switch to Reminder Mode or Opt-Out — right on the disconnect page!

Tab Completions
All commands now have smart tab completion. Type /muslim and press Tab to see kick and reminder suggestions!

Auto-Migration
Old optout.yml data is automatically migrated to the new playerdata.yml system. No manual action needed!


FaithBreak helps Muslim players take breaks during prayer times — automatically and respectfully.

Smart Location Detection
Automatically detects each player's real-world location based on their IP, then calculates accurate prayer times for their specific region. No manual setup needed.

️ Timely Prayer Reminders
Two minutes before prayer time, players are kicked or reminded (based on their chosen mode) with a localized message showing the prayer name. Kicked players can rejoin after 12 minutes.

Multi-Language Magic
Messages automatically appear in each player's Minecraft client language! Supports 10 languages out of the box, with easy support for adding more.

Player Choice System
Three modes to choose from: Kick, Reminder, or Opt-Out. Use /muslim or /non-muslim to set your preference — saved permanently across restarts.


Prayer Time System

• Auto Location Detection – Detects player location via IP for accurate prayer times
• Accurate Calculation – Uses real-time prayer time data for each player's region
• Kick Mode – Players are kicked 2 minutes before prayer with a localized message + mode info
• Reminder Mode – Players receive a chat-only reminder without being kicked
• 12-Minute Break – Ensures kicked players have time for prayer before rejoining
• 5 Daily Prayers – Covers Fajr, Dhuhr, Asr, Maghrib, and Isha

Privacy & Preferences

• Persistent Modes – Your mode choice (Kick/Reminder/Opt-Out) saved to playerdata.yml, survives restarts
• Auto-Migration – Old optout.yml data migrated automatically to the new system
• Location Logging OFF – Player locations are NOT logged to console by default
• Configurable Logging – Admins can enable log-player-locations if needed
• VPN/Local IP Detection – Plugin auto-disables for private/local network connections

Language Support (10 Languages!)

• English (en_US)
• Arabic (ar_SA) - العربية
• Urdu (ur_PK) - اردو
• Spanish (es_ES) - Español
• French (fr_FR) - Français
• Indonesian (id_ID) - Bahasa Indonesia
• Hindi (hi_IN) - हिन्दी
• German (de_DE) - Deutsch
• Polish (pl_PL) - Polski
• Dutch (nl_NL) - Nederlands

Player Commands

• /muslim – Opt in with Kick Mode (default)
• /muslim kick – Set mode to Kick — kicked during prayer times
• /muslim reminder – Set mode to Reminder — chat alerts only, no kick
• /non-muslim – Opt out of all prayer kicks and reminders (saved permanently!)
• /fb lang – View current language and available options
• /fb lang <code> – Change your language (e.g., /fb lang ar_SA)

All commands support tab completion for faster typing!​

️ Admin Tools (OP Only)

• /fb kick <prayer> – Test the kick screen without the 12-minute timer — rejoin immediately!
• Hot Reload – Reload config without restarting the server
• Debug Mode – Enable detailed logging for troubleshooting

What Players See​

English Player (Kick Screen)

Code (Text):

It's Fajr prayer time! Please take a break.
You can rejoin in 12 minutes.

You are in Kick Mode. Type /muslim reminder for chat-only alerts.
Not Muslim? Type /non-muslim to opt out.
(Your choice is saved permanently and survives restarts)

Learn More: https://modrinth.com/plugin/faithbreak
 

English Player (Reminder Mode — Chat)

Code (Text):

⏰ Reminder: It's Fajr prayer time!
(You are in Reminder Mode. Use /muslim kick to enable strict kicking)
 

Arabic Player (Kick Screen)

Code (Text):

حان وقت صلاة الفجر! يرجى أخذ استراحة.
يمكنك العودة بعد 12 دقيقة.

You are in Kick Mode. Type /muslim reminder for chat-only alerts.
Not Muslim? Type /non-muslim to opt out.
(Your choice is saved permanently and survives restarts)

معرفة المزيد: https://modrinth.com/plugin/faithbreak
 

⚙️ Configuration​

Code (Text):

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

❓ Frequently Asked Questions​

Q: What's the difference between Kick Mode and Reminder Mode?
A: Kick Mode removes you from the server for 12 minutes during prayer. Reminder Mode sends you a chat message but lets you keep playing.

Q: Will my mode choice be remembered after I log off?
A: Yes! Your mode (Kick/Reminder/Opt-Out) is saved permanently to playerdata.yml.

Q: I was using /non-muslim from the old version — will my data be lost?
A: No! FaithBreak automatically migrates your old optout.yml data to the new system.

Q: I'm not Muslim, will I get kicked?
A: No! Type /non-muslim once to permanently opt out — no kicks, no reminders, ever.

Q: Is my location logged to console?
A: Not by default! Location logging is OFF unless the server admin enables log-player-locations in config.

Q: How do I test the kick screen?
A: Use /fb kick Fajr (or any prayer name) as an OP — you can rejoin immediately!

Q: Can I change the language?
A: Yes! Use /fb lang <code> to change manually, or let the plugin auto-detect from your Minecraft client.

Q: What if I'm on a VPN or local network?
A: The plugin detects local/private IPs and disables itself for those connections.

Q: How do I add a new language?
A: Copy any existing language file from plugins/FaithBreak/messages/, rename it, translate, and restart!

Why I Made This

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

Also, fun fact: 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 running your plugins! ⚡

⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯​

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

Contributing
Translate: Add your language by creating a new .yml file
Report Bugs: Contact me on Discord
Suggest Features: Share your ideas!
⭐ Star & Share: Help others discover this plugin!​

☕ Support Me on Ko-fi
If you like my work, consider buying me a coffee:

​

Made with ❤️ for the Muslim Minecraft community
JazakAllahu Khairan (May Allah reward you with goodness) for using FaithBreak!​