FaithBreak

# 🕌 **FaithBreak v1.5.0 — Admin Controls & Configurable Breaks!** 🛡️ <div align="center"> ### 🌟 **Join Our Discord for Giveaways & Events!** 🎮 Join our **(https://discord.gg/snkKDmc89f)** 🔗 for monthly giveaways & events where you can win coupon codes or plugins like **(https://builtbybit.com/resources/astral-swords.81777/)** or **(https://builtbybit.com/resources/trimblades.87033/)**! 🎨🚀 </div> --- Warriors of faith, **v1.5.0** is here with **Force Kick Mode** for server admins and a **configurable break duration**! Full admin control over prayer enforcement, plus the flexibility to set your own break time. 🚀 --- <div align="center"> ## ✨ **What's New in v1.5.0** ✨ </div> ### 🎯 Major Improvements * **feat:** 🔒 **FORCE KICK MODE** — New config option for admins! When enabled, ALL opted-in players are kicked during prayer times — even those in Reminder Mode. Players who used `/non-muslim` are still respected. * **feat:** ⏱️ **CONFIGURABLE BREAK DURATION** — Admins can now set the prayer break length in minutes via `break-duration` in config. Minimum: 12 minutes, no upper limit! * **feat:** ⚠️ **SMART WARNINGS** — Players who try to select Reminder Mode while Force Kick is active get a clear warning that they'll still be kicked. * **fix:** 🧹 **CODE CLEANUP** — Cleaned up redundant kick logic in the non-Middle-Eastern player path for better reliability. ### 🆕 New Config Options | Option | Default | Description | |--------|---------|-------------| | `force-kick-mode` | `false` | When `true`, overrides Reminder Mode → Kick for all players | | `break-duration` | `12` | Prayer break duration in minutes (min: 12) | --- <div align="center"> ## 📋 **Full Feature List** 📋 </div> ### 🎮 Player Modes | Mode | What Happens | Command | |------|-------------|---------| | 🔴 **Kick Mode** (Default) | Kicked from server during prayer time | `/muslim kick` | | 🟡 **Reminder Mode** | Chat reminder only — no kick! | `/muslim reminder` | | 🟢 **Opt-Out** | Nothing happens — fully opted out | `/non-muslim` | > ⚠️ If the server has **Force Kick Mode** enabled, Reminder Mode players will still be kicked. Opt-Out players are always respected. --- ## 🔍 What Does FaithBreak Do? FaithBreak helps players take breaks during prayer times: - 🌍 **Smart Location Detection**: Automatically detects each player's location based on their IP - 🕰️ **Prayer Time Awareness**: Calculates accurate prayer times for each player's specific location - ⏱️ **Timely Reminders**: Two minutes before prayer time, players are kicked or reminded - ⏳ **Configurable Break**: Kicked players can't rejoin for the configured duration (default: 12 min) - 🌐 **Multi-Language Magic**: Messages automatically appear in each player's Minecraft language! - 🎯 **Player Choice**: Choose between Kick Mode, Reminder Mode, or Opt-Out — saved permanently! - 🔒 **Admin Override**: Server admins can force kick mode globally via config --- ## 💻 Commands ### Player Commands | Command | Description | |---------|-------------| | `/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`) | ### Admin Commands (OP only) | Command | Description | |---------|-------------| | `/fb kick <prayer>` | Test the kick screen without the break timer | > 💡 **Tab Completions**: All commands support tab completion! Type `/muslim ` and press Tab to see `kick` and `reminder` suggestions. --- ## 🌍 Supported Languages (10 Total!) - 🇬🇧 **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 **💡 Server Owners**: Add more languages by creating `.yml` files in `plugins/FaithBreak/messages/`! --- ## 📋 Features in Detail ### 🔔 What Happens During Prayer Time? **For Players in Kick Mode (Default):** 1. 2 minutes before prayer → kicked from server 2. See localized message with prayer name + mode info 3. Kick screen shows how to switch to Reminder Mode or Opt-Out 4. Can rejoin after the configured break duration **For Players in Reminder Mode:** 1. 2 minutes before prayer → receive a chat reminder 2. Message: "⏰ Reminder: It's prayer time!" 3. No kick — keep playing! > ⚠️ If `force-kick-mode: true` is set in config, Reminder Mode players are kicked instead. **For Opted-Out Players:** - Nothing happens — fully invisible to the prayer system ### 🎮 Choo