---

What is BSoftware Bans?

BSoftware Bans is a modern, feature-rich ban management plugin designed for Minecraft servers of all sizes. Whether you're running a small community server or a large network, our plugin provides powerful tools to maintain a safe and welcoming environment.

With support for both permanent and temporary bans, integrated network-wide ban checking, and an intuitive command interface, managing player conduct has never been easier.

---

✨ Key Features

• Permanent Bans - Ban troublemakers indefinitely with detailed ban reasons
• Temporary Bans - Issue time-based bans with flexible durations (days, hours, minutes, seconds)
• Network Ban Synchronization - Optionally sync bans across multiple servers via central API
• Lightning Fast - All database operations run asynchronously for zero server lag
• Fully Customizable - Personalize all messages and settings via simple YAML configuration
• Secure & Reliable - SQLite database ensures data integrity and quick access
• Zero Configuration - Works perfectly out of the box, customize as needed
• Automatic Cleanup - Expired temporary bans are automatically removed every 5 minutes
• Detailed Logging - Track all ban-related events in your server logs

---

Commands

Duration Examples for Temporary Bans:

• Code (Text):

  /tempban Cheater 24h Hacking
• Code (Text):

  /tempban SpamBot 1h Spam
• Code (Text):

  /tempban Troll 3d Harassment
• Code (Text):

  /tempban Griefer 30m Warning
• Code (Text):

  /tempban BadBehavior 1d2h30m Multiple violations

Time formats: d (days), h (hours), m (minutes), s (seconds)

---

Requirements

• Minecraft Server 1.21+ (Spigot/Paper)
• Java 21 or higher

---

Installation

1. Download the plugin JAR file
2. Place it in your server's plugins/ folder
3. Start your server (configuration files are generated automatically)
4. [Optional] Create an API key at https://api.bsoftware.xyz/ for network-wide ban synchronization
5. Configure the plugin in plugins/BSoftware_Bans/config.yml if desired
6. Restart your server

---

⚙️ Configuration

The plugin generates a fully commented config.yml on first run with these customizable options:

• All ban messages (with color codes and placeholders)
• Server name for network identification
• API integration (optional - for network-wide bans)
• Database settings
• Permission settings

Example message with placeholders:
---

Why Choose BSoftware Bans?

Feature	Included
Permanent Bans	✅
Temporary Bans	✅
Auto-Expiring Bans	✅
Network Integration	✅
Customizable Messages	✅
Asynchronous Database	✅
Zero Lag	✅
Out-of-Box Ready	✅

---

Perfect For

• Community Servers
• Roleplay Servers
• Competitive Servers
• Server Networks
• Network Administrators

---

Security & Reliability

• SQLite Database - Fast, reliable local storage
• Error Handling - Graceful error recovery without server interruption
• Fail-Safe Design - API issues don't impact local ban functionality
• Asynchronous Operations - Zero impact on server performance
• Regular Backups - Easily backup your ban data

---

Tips & Best Practices

• Use temporary bans for minor infractions and give players a second chance
• Regularly backup your bans.db file
• Customize messages to reflect your community's values
• Always provide clear ban reasons for transparency
• Review ban policies periodically and adjust as needed

---

Support & Links

• Website: https://bsoftware.xyz
• API Portal: https://api.bsoftware.xyz/ (for optional network features)

---

Version Information

• Version: 0.1.0
• Release Date: March 23, 2026
• Minecraft: 1.21+
• Status: Stable Release

---