# \ud83d\udd4c **FaithBreak v1.4.0 \u2014 Player Modes & Smart Kick Screen!** \ud83d\udee1\ufe0f<\/p>\n
### \ud83c\udf1f **Join Our Discord for Giveaways & Events!** \ud83c\udfae<\/p>\n
Join our **Discord Server** \ud83d\udd17 for monthly giveaways & events where you can win coupon codes or plugins like **AstralSwords Premium** or **TrimBlades**! \ud83c\udfa8\ud83d\ude80<\/p>\n<\/div>\n
—<\/p>\n
Warriors of faith, **v1.4.0** is here with **three distinct player modes**, a **smarter kick screen**, and **tab completions**! Choose between Kick Mode, Reminder Mode, or Opt-Out \u2014 your choice is saved permanently. \ud83d\ude80<\/p>\n
—<\/p>\n
## \u2728 **What’s New in v1.4.0** \u2728<\/p>\n<\/div>\n
### \ud83c\udfaf Major Improvements
\n* **feat:** \ud83c\udfae **THREE PLAYER MODES** – Choose how prayer times affect you: **Kick**, **Reminder**, or **Opt-Out**!
\n* **feat:** \ud83d\udd4c **`\/muslim [kick|reminder]`** – New command to opt in and select your preferred mode (default: Kick)
\n* **feat:** \ud83d\udcfa **SMART KICK SCREEN** – Kick screen now shows your current mode and how to switch \u2014 right on the disconnect page!
\n* **feat:** \ud83d\udd24 **TAB COMPLETIONS** – All commands now have smart tab completion for faster typing
\n* **feat:** \ud83d\udcbe **PERSISTENT MODES** – Your mode choice (Kick\/Reminder\/Opt-Out) is saved permanently to `playerdata.yml`
\n* **feat:** \ud83d\udd04 **AUTO-MIGRATION** – Old `optout.yml` data is automatically migrated to the new system<\/p>\n
### \ud83c\udd95 How Modes Work
\n| Mode | What Happens | Command |
\n|——|————-|———|
\n| \ud83d\udd34 **Kick Mode** (Default) | Kicked from server during prayer time (12-min break) | `\/muslim kick` |
\n| \ud83d\udfe1 **Reminder Mode** | Chat reminder only \u2014 no kick! | `\/muslim reminder` |
\n| \ud83d\udfe2 **Opt-Out** | Nothing happens \u2014 fully opted out | `\/non-muslim` |<\/p>\n
—<\/p>\n
## \ud83d\udd0d What Does FaithBreak Do?<\/p>\n
FaithBreak helps players take breaks during prayer times:<\/p>\n
– \ud83c\udf0d **Smart Location Detection**: Automatically detects each player’s location based on their IP
\n– \ud83d\udd70\ufe0f **Prayer Time Awareness**: Calculates accurate prayer times for each player’s specific location
\n– \u23f1\ufe0f **Timely Reminders**: Two minutes before prayer time, players are kicked or reminded
\n– \u23f3 **Break Duration**: Kicked players can’t rejoin for 12 minutes, giving time for prayer
\n– \ud83c\udf10 **Multi-Language Magic**: Messages automatically appear in each player’s Minecraft language!
\n– \ud83c\udfaf **Player Choice**: Choose between Kick Mode, Reminder Mode, or Opt-Out \u2014 saved permanently!<\/p>\n
—<\/p>\n
## \ud83d\udcbb Commands<\/p>\n
### Player Commands ### Admin Commands (OP only) > \ud83d\udca1 **Tab Completions**: All commands support tab completion! Type `\/muslim ` and press Tab to see `kick` and `reminder` suggestions.<\/p>\n ---<\/p>\n ## \ud83c\udf0d Supported Languages (10 Total!)<\/p>\n - \ud83c\uddec\ud83c\udde7 **English** (en_US) **\ud83d\udca1 Server Owners**: Add more languages by creating `[code].yml` files in `plugins\/FaithBreak\/messages\/`!<\/p>\n ---<\/p>\n ## \ud83d\udccb Features in Detail<\/p>\n ### \ud83d\udd14 What Happens During Prayer Time?<\/p>\n **For Players in Kick Mode (Default):** **For Players in Reminder Mode:** **For Opted-Out Players:** ### \ud83c\udfae Choosing Your Mode<\/p>\n **Want to be kicked for prayer? (Strict enforcement)** **Want chat reminders only? (No kick)** ### \ud83d\udeab Don't Want Prayer Notifications?<\/p>\n Use `\/non-muslim` to opt out: ### \ud83d\udd12 Privacy First<\/p>\n By default, FaithBreak does NOT log player locations to console: ### \ud83e\uddea Test Mode for Admins<\/p>\n Want to see what players see when kicked? ---<\/p>\n ### \ud83d\udcf8 What Players See<\/p>\n ### English Player (Kick Screen) You are in Kick Mode. Type \/muslim reminder for chat-only alerts. Learn More: https:\/\/modrinth.com\/plugin\/faithbreak ### English Player (Reminder Mode \u2014 Chat Message) ### Arabic Player (Kick Screen) You are in Kick Mode. Type \/muslim reminder for chat-only alerts. \u0645\u0639\u0631\u0641\u0629 \u0627\u0644\u0645\u0632\u064a\u062f: https:\/\/modrinth.com\/plugin\/faithbreak ## \u2699\ufe0f Configuration<\/p>\n ```yaml **Q: What's the difference between Kick Mode and Reminder Mode?** **Q: Will my mode choice be remembered after I log off?** **Q: I was using `\/non-muslim` from the old version \u2014 will my data be lost?** **Q: Is my location logged to console?** **Q: How do I test the kick screen?** **Q: I'm not Muslim, will I get kicked?** **Q: Can I change the language?** **Q: What if I'm on a VPN or local network?** **Q: How do I add a new language?** ---<\/p>\n ## \ud83c\udfaf **Why Update to v1.4.0?**<\/p>\n **If you've wanted:** **v1.4.0 delivers all of this!**<\/p>\n ---<\/p>\n ## \ud83d\ude4f Why I Made This<\/p>\n I made this plugin to help my fellow **Muslim brothers and sisters** stay on track with their **prayer times**. Also, fun fact: this plugin is **automatically bundled** with every plugin I make. ---<\/p>\n ## \u2615 Support Me on Ko-fi<\/p>\n If you like my work, consider buying me a coffee:<\/p>\n <\/p>\n<\/div>\n ---<\/p>\n ## \ud83e\udd1d Contributing<\/p>\n Want to help improve FaithBreak?<\/p>\n - \ud83c\udf10 **Translate**: Add your language by creating a new `.yml` file ---<\/p>\n ## \u2753 Got questions?<\/p>\n Contact me on Discord<\/p>\n<\/div>\n ---<\/p>\n **Made with \u2764\ufe0f for the Muslim Minecraft community**<\/p>\n *JazakAllahu Khairan (May Allah reward you with goodness) for using FaithBreak!* \ud83e\udd32<\/p>\n","protected":false},"excerpt":{"rendered":" A thoughtful plugin that auto detects prayer times based on locations and gently reminds players!<\/p>\n","protected":false},"featured_media":68213,"template":"","meta":{"_minecraft_slug":"faithbreak","_minecraft_project_id":"Jghhg4Vq","_minecraft_author":"CiscoCodes","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":14723,"_minecraft_follows":9,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"faithbreak.zip","_minecraft_size_bytes":2272279,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T01:06:19.820008Z","_minecraft_date_created":"2025-04-20T19:33:03.202687Z","_minecraft_date_modified":"2026-04-04T19:22:14.831645Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/faithbreak","_minecraft_icon_attachment_id":68213,"_minecraft_imported_at":"2026-06-03T21:25:47+00:00","_minecraft_import_hash":"9000a26925db80db880d52d65d8a3026","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,867,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-68212","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| Command | Description |
\n|———|————-|
\n| `\/muslim` | Opt in with **Kick Mode** (default) |
\n| `\/muslim kick` | Set mode to **Kick** \u2014 kicked during prayer times |
\n| `\/muslim reminder` | Set mode to **Reminder** \u2014 chat alerts only, no kick |
\n| `\/non-muslim` | **Opt out** of all prayer kicks and reminders (saved permanently!) |
\n| `\/fb lang` | View current language and available options |
\n| `\/fb lang ` | Change your language (e.g., `\/fb lang ar_SA`) |<\/p>\n
\n| Command | Description |
\n|---------|-------------|
\n| `\/fb kick
\n- \ud83c\uddf8\ud83c\udde6 **Arabic** (ar_SA) - \u0627\u0644\u0639\u0631\u0628\u064a\u0629
\n- \ud83c\uddf5\ud83c\uddf0 **Urdu** (ur_PK) - \u0627\u0631\u062f\u0648
\n- \ud83c\uddea\ud83c\uddf8 **Spanish** (es_ES) - Espa\u00f1ol
\n- \ud83c\uddeb\ud83c\uddf7 **French** (fr_FR) - Fran\u00e7ais
\n- \ud83c\uddee\ud83c\udde9 **Indonesian** (id_ID) - Bahasa Indonesia
\n- \ud83c\uddee\ud83c\uddf3 **Hindi** (hi_IN) - \u0939\u093f\u0928\u094d\u0926\u0940
\n- \ud83c\udde9\ud83c\uddea **German** (de_DE) - Deutsch
\n- \ud83c\uddf5\ud83c\uddf1 **Polish** (pl_PL) - Polski
\n- \ud83c\uddf3\ud83c\uddf1 **Dutch** (nl_NL) - Nederlands<\/p>\n
\n1. 2 minutes before prayer \u2192 kicked from server
\n2. See localized message with prayer name + mode info
\n3. Kick screen shows how to switch to Reminder Mode or Opt-Out
\n4. Can rejoin after 12 minutes<\/p>\n
\n1. 2 minutes before prayer \u2192 receive a chat reminder
\n2. Message: \"\u23f0 Reminder: It's [Prayer] prayer time!\"
\n3. No kick \u2014 keep playing!<\/p>\n
\n- Nothing happens \u2014 fully invisible to the prayer system<\/p>\n
\n```
\n\/muslim kick
\n```<\/p>\n
\n```
\n\/muslim reminder
\n```<\/p>\n
\n- You won't receive kicks or reminders
\n- **Your choice is saved permanently!**
\n- Switch back anytime with `\/muslim`<\/p>\n
\n- No more \"Player X location detected: Country, City\" spam
\n- Enable `log-player-locations: true` in config only if needed<\/p>\n
\n```
\n\/fb kick Fajr
\n```
\n- Shows the exact kick screen with mode info
\n- No 12-minute timer - rejoin immediately!<\/p>\n
\n```
\nIt's Fajr prayer time! Please take a break.
\nYou can rejoin in 12 minutes.<\/p>\n
\nNot Muslim? Type \/non-muslim to opt out.
\n(Your choice is saved permanently and survives restarts)<\/p>\n
\n```<\/p>\n
\n```
\n\u23f0 Reminder: It's Fajr prayer time!
\n(You are in Reminder Mode. Use \/muslim kick to enable strict kicking)
\n```<\/p>\n
\n```
\n\u062d\u0627\u0646 \u0648\u0642\u062a \u0635\u0644\u0627\u0629 \u0627\u0644\u0641\u062c\u0631! \u064a\u0631\u062c\u0649 \u0623\u062e\u0630 \u0627\u0633\u062a\u0631\u0627\u062d\u0629.
\n\u064a\u0645\u0643\u0646\u0643 \u0627\u0644\u0639\u0648\u062f\u0629 \u0628\u0639\u062f 12 \u062f\u0642\u064a\u0642\u0629.<\/p>\n
\nNot Muslim? Type \/non-muslim to opt out.
\n(Your choice is saved permanently and survives restarts)<\/p>\n
\n```<\/p>\n
\n# config.yml
\ndebug-mode: false # Detailed debug logging
\nlog-player-locations: false # Log player country\/city (default: OFF)
\n```
\n## \u2753 Frequently Asked Questions<\/p>\n
\nA: **Kick Mode** removes you from the server for 12 minutes during prayer. **Reminder Mode** sends you a chat message but lets you keep playing.<\/p>\n
\nA: Yes! Your mode (Kick\/Reminder\/Opt-Out) is saved permanently to `playerdata.yml`.<\/p>\n
\nA: No! FaithBreak automatically migrates your old `optout.yml` data to the new system.<\/p>\n
\nA: Not by default! Location logging is OFF unless the server admin enables `log-player-locations` in config.<\/p>\n
\nA: Use `\/fb kick Fajr` (or any prayer name) as an OP - you can rejoin immediately!<\/p>\n
\nA: No! Type `\/non-muslim` once to permanently opt out.<\/p>\n
\nA: Yes! Use `\/fb lang ` to change manually, or let the plugin auto-detect from your Minecraft client.<\/p>\n
\nA: The plugin detects local\/private IPs and disables itself for those connections.<\/p>\n
\nA: Copy any existing language file from `plugins\/FaithBreak\/messages\/`, rename it, translate, and restart!<\/p>\n
\n- More control over how prayer times affect you
\n- Chat-only reminders instead of being kicked
\n- A smarter kick screen that explains your options
\n- Tab completions for faster command typing<\/p>\n
\nLet's be real \u2014 it's easy to get completely lost in Minecraft and forget \ud83d\ude05
\nThis plugin gives a gentle nudge at the right moment \ud83d\udd4c\u23f0<\/p>\n
\nCheck out my other creations on Modrinth! \ud83d\ude09\u2728<\/p>\n
\n- \ud83d\udc1b **Report Bugs**: Contact me on Discord
\n- \ud83d\udca1 **Suggest Features**: Share your ideas!
\n- \u2b50 **Star & Share**: Help others discover this plugin!<\/p>\n