Skip to content

FaithBreak — Compatibility & Troubleshooting

Server requirements, compatibility information, and common issue fixes.

Server Requirements

Requirement Value
Minecraft Version Paper 1.21+
Java Version Java 21 or higher
Server Software Paper (Spigot compatibility not guaranteed)
RAM Minimum 1GB allocated to server

Known Compatibility

Status Details
✅ Compatible Most economy, permission, and utility plugins
✅ Compatible PlaceholderAPI (optional, for enhanced messages)
✅ Compatible Anti-cheat plugins (properly configured)
⚠️ Caution VPN/proxy plugins may affect IP geolocation accuracy

Troubleshooting

Players Not Being Kicked

  1. Debug Mode: Enable debug-mode: true in config.yml to see why
  2. Player Location: Check if player location was detected (console logs)
  3. IP Geolocation Failure: Ensure server can reach external APIs
  4. Opt-Out: Verify player hasn't used /non-muslim
  5. Mode Check: Player may be in Reminder Mode — use /muslim kick to switch

Players Not Being Located

  1. Local Networks: Players connecting from local/private IPs cannot be geolocated
  2. VPN/Proxy: Players using VPNs may be detected as wrong location
  3. API Failures: All geolocation services may be temporarily unavailable
  4. Debug Check: Enable debug mode to see API responses

Prayer Times Not Calculating

  1. Timezone: Ensure detected timezone is valid
  2. Debug Mode: Check debug logs for prayer time calculation
  3. API Data: Verify prayer time API is returning valid data

Language Issues

  1. Auto-Detection: Language is detected from client on join
  2. Manual Override: Use /fb lang <code> to set manually
  3. Available Languages: Ensure language code is valid (see Languages page)

Players Can't Rejoin After Kick

  • 12-Minute Block: Players are blocked for 12 minutes after being kicked
  • This is intentional — they should use the prayer break
  • Block automatically expires after 12 minutes

Debug Mode

Enable debug mode for detailed troubleshooting:

debug-mode: true
log-player-locations: true

Debug mode will show: - Player IP addresses being looked up - Geolocation API responses - Prayer time calculations - Mode decisions for each player - Cache operations

Error Messages

Message Meaning
"You don't have permission" Player lacks required permission
No location detected Player on local network or geolocation failed
"Prayer time check skipped - no players" No player locations stored yet
"All geolocation services failed" Network issue or APIs unavailable

Privacy

  • FaithBreak only stores player mode preferences (Kick/Reminder/Opt-Out)
  • IP addresses are used for geolocation but not stored permanently
  • Location data is cached for 24 hours to reduce API calls
  • Player privacy is respected per log-player-locations config

Version History

v1.4.0 (Current)

  • Added comprehensive language support system
  • Improved IP geolocation with multiple fallback services
  • Added clickable links to kick messages
  • Enhanced debug mode with detailed logging

v1.3.x

  • Added player mode system (Kick/Reminder/Opt-Out)
  • Added /non-muslim command for opting out
  • Improved location caching

v1.2.x

  • Initial release with basic prayer time kicks