Skip to content

Releases: TitanEch0/BSoftware_Bans_public

Release list

v0.1.3

v0.1.3 Latest
Latest

Choose a tag to compare

View all tags
@TitanEch0 TitanEch0 released this 25 Mar 23:36
v0.1.3
a1c4dba
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Release Notes - Version 0.1.3

Release Date: March 26, 2026

🎉 Initial Release

Welcome to BSoftware Bans v0.1.3 - the comprehensive moderation management system for your Minecraft server!

✨ New Features

Core Moderation System

  • ✅ Permanent Bans - Ban players indefinitely with customizable reasons
  • ✅ Temporary Bans - Ban players for a specific duration with flexible time formats (days, hours, minutes, seconds)
  • ✅ IP Bans - Block specific IP addresses from joining the server/network
  • ✅ Mutes - Prevent players from chatting, either temporarily or permanently
  • ✅ Kicks - Instantly remove players from the server with a custom reason
  • ✅ Unban/Unmute - Easily revoke bans and mutes

Database & Performance

  • ✅ Local SQLite Database - Fast, reliable local storage for all bans, IP bans, and mutes
  • ✅ Asynchronous Operations - All database and API operations run off the main thread to prevent server lag
  • ✅ Automatic Cleanup - Periodic cleanup task removes expired temporary bans and mutes every 5 minutes

API Integration (Optional)

  • ✅ Central REST API Support - Optional integration with a central ban/IP-ban database
  • ✅ Global Ban/IP-Ban Checking - Verify against global lists to maintain network-wide security
  • ✅ Ban/IP-Ban Reporting - Automatically report local bans and IP-bans to the central system
  • ✅ Fail-Safe Design - Graceful degradation if the API is unavailable, ensuring local functionality remains intact

Player Management

  • ✅ Login Event Handling - Comprehensive ban/IP-ban verification on player login
  • ✅ Chat Event Handling - Mute verification on player chat
  • ✅ Customizable Messages - Full control over all in-game messages with placeholder support for reasons, times, players, and IPs
  • ✅ UUID-Based System - Uses player UUIDs for reliable identification

Admin Features

  • ✅ Comprehensive Commands - /ban, /tempban, /unban, /ipban, /kick, /mute, /unmute
  • ✅ Permission System - Fine-grained control with individual permissions per command
  • ✅ Configuration System - Easy-to-use YAML configuration files for all settings

📋 Commands

Command Permission Description
/ban <player> <reason> bans.ban Ban a player permanently
/tempban <player> <duration> <reason> bans.tempban Ban a player temporarily
/unban <player> bans.unban Remove a player from ban list
/ipban <ip> <reason> bans.ipban Ban a specific IP address
/kick <player> <reason> bans.kick Kick a player from the server
`/mute <duration perm> ` bans.mute
/unmute <player> bans.unmute Unmute a player

📊 Database Structure

Tables (Local SQLite: plugins/BSoftware_Bans/bans.db)

  • local_bans - Stores permanent UUID bans
  • local_ip_bans - Stores permanent IP bans
  • temp_bans - Stores temporary UUID bans with duration tracking
  • mutes - Stores temporary and permanent mutes with duration tracking

🔧 Configuration

Default Settings:

  • Server name: server-01
  • Central API: Enabled
  • Global ban/IP-ban checking: Enabled
  • Ban/IP-ban reporting: Enabled
  • API URL: https://api.bsoftware.xyz./api/bans
  • API Key: (Empty by default, configure your actual API key)

Customizable Messages:

  • All moderation messages (ban, tempban, ipban, mute, kick, unban, unmute)
  • Error messages (no permission, player not found, invalid duration/IP)
  • Placeholders: %player%, %reason%, %time%, %duration%, %ip%

📦 Technical Details

Requirements:

  • Minecraft Server 1.21+ (Spigot/Paper compatible)
  • Java 21+
  • Maven (for building)

Dependencies:

  • Spigot/Paper API 1.21+
  • SQLite JDBC
  • Google Gson
  • JetBrains Annotations

🐛 Known Issues

  • None reported for initial release

⚠️ Important Notes

Security

  • Keep your API key private and secure
  • Regularly backup the bans.db file
  • Monitor the logs for any suspicious activity

Performance

  • All database and API operations are asynchronous, ensuring minimal impact on server performance.
  • The cleanup task runs asynchronously and has minimal performance impact.

Compatibility

  • Fully compatible with Paper servers.
  • Supports Spigot servers running API version 1.21+.
  • Designed to work alongside other plugins, but exclusive use for moderation is recommended to avoid conflicts.

🚀 Installation Instructions

  1. Download the plugin JAR file.
  2. Place it in your server's plugins/ folder.
  3. Start the server - configuration files (config.yml) and the local database (bans.db) will be generated automatically.
  4. Configure API (Optional but Recommended):
    • Obtain your API URL and API Key from your central ban system (e.g., https://api.bsoftware.xyz/).
    • Edit plugins/BSoftware_Bans/config.yml and update database.central.api_key.
  5. Customize Messages: Adjust any messages in config.yml to fit your server's style.
  6. Restart your server to apply all configuration changes.

First Steps

  • Set your server_name in config.yml.
  • Grant appropriate permissions to administrators/moderators.

📝 Changelog

Version 0.1.3 (Initial Release - March 26, 2026)

Added:

  • Comprehensive permanent and temporary ban system.
  • IP ban system.
  • Mute system (temporary and permanent).
  • Kick command.
  • Central REST API integration for global bans and IP bans.
  • Local SQLite database for all moderation data.
  • Full suite of admin commands: /ban, /tempban, /unban, /ipban, /kick, /mute, /unmute.
  • Asynchronous database and API operations for performance.
  • Automatic cleanup of expired temporary bans and mutes.
  • Comprehensive login and chat event handling for moderation enforcement.
  • Fully customizable messages with placeholders.
  • Fine-grained permission system.
  • Complete documentation (README.md, Release.md, SpigotMC_Description.txt).

🤝 Support & Feedback

For issues, suggestions, or feedback:

  • Website: https://bsoftware.xyz
  • Documentation: See README.md for detailed information
  • Configuration Help: Refer to the default config.yml

📜 Version Information

  • Version: 0.1.3
  • Release Date: March 26, 2026
  • Plugin Name: BSoftware_Bans
  • Developer: BSoftware Team
  • API Version: 1.21+
  • Status: Stable Release

🎯 Future Roadmap

Planned features for upcoming releases:

  • Ban appeals system.
  • Admin logging and audit trails.
  • Integration with Discord webhooks.
  • Web dashboard for ban management (if not using the central API's panel).
  • Ban statistics and analytics.
  • Import/export functionality.

Thank you for using BSoftware Bans! We hope it helps keep your server safe and secure. 🎮

For the latest updates and information, visit: https://bsoftware.xyz

Assets 4
Loading

v0.1.0

v0.1.0

Choose a tag to compare

View all tags
@TitanEch0 TitanEch0 released this 23 Mar 02:29
v0.1.0
e24d0f6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Release Notes - Version 0.1.0

Release Date: March 23, 2026

🎉 Initial Release

Welcome to BSoftware Bans v0.1.0 - the comprehensive ban management system for your Minecraft server!

✨ New Features

Core Ban System

  • ✅ Permanent Bans - Ban players indefinitely with customizable reasons
  • ✅ Temporary Bans - Ban players for a specific duration with flexible time formats (days, hours, minutes, seconds)
  • ✅ Ban Management - Unban players with a single command
  • ✅ Local SQLite Database - Fast, reliable local ban storage with automatic database initialization

Temporary Ban System

  • ✅ Flexible Duration Format - Support for combined duration specifications (e.g., 1d2h30m)
  • ✅ Automatic Cleanup - Periodic cleanup task removes expired bans every 5 minutes
  • ✅ Remaining Time Display - Players see their remaining ban time when trying to join
  • ✅ Asynchronous Operations - All database operations run asynchronously to avoid server lag

API Integration

  • ✅ Central API Support - Optional integration with central ban database
  • ✅ Global Ban Checking - Check against global ban list to maintain network security
  • ✅ Ban Reporting - Automatically report local bans to central system
  • ✅ Fail-Safe Design - Graceful degradation if API is unavailable

Player Management

  • ✅ Login Event Handling - Comprehensive ban verification on player login
  • ✅ Kick Messages - Customizable ban messages with reason and expiration time
  • ✅ UUID-Based System - Uses player UUIDs for reliable identification

Admin Features

  • ✅ Three Core Commands - /ban, /tempban, /unban
  • ✅ Permission System - Fine-grained control with individual permissions per command
  • ✅ Configuration System - Easy-to-use YAML configuration files
  • ✅ Customizable Messages - Full control over all in-game messages with placeholder support

📋 Commands

Command Permission Description
/ban <player> <reason> bans.ban Ban a player permanently
/tempban <player> <duration> <reason> bans.tempban Ban a player temporarily
/unban <player> bans.unban Remove a player from ban list

📊 Database Structure

Tables

  • local_bans - Stores permanent bans with reason, banner name, and timestamp
  • temp_bans - Stores temporary bans with duration tracking in milliseconds

Data Storage

  • SQLite database: plugins/BSoftware_Bans/bans.db
  • Configuration: plugins/BSoftware_Bans/config.yml

🔧 Configuration

Default Settings:

  • Server name: server-01
  • Central API: Enabled
  • Global ban checking: Enabled
  • Ban reporting: Enabled

Customizable Messages:

  • Ban success/failure messages
  • Temporary ban messages with remaining time
  • Permission denied messages
  • Player not found messages

📦 Technical Details

Requirements:

  • Minecraft Server 1.21+ (Spigot/Paper compatible)
  • Java 21+
  • Maven (for building)

Dependencies:

  • Spigot/Paper API 1.21+
  • SQLite JDBC
  • Google Gson
  • JetBrains Annotations

Size: ~50KB JAR file

🐛 Known Issues

  • None reported for initial release

⚠️ Important Notes

Security

  • Keep your API key private and secure
  • Regularly backup the bans.db file
  • Monitor the logs for any suspicious activity

Performance

  • Large ban lists (1000+ entries) may increase login verification time
  • The cleanup task runs asynchronously and has minimal performance impact
  • Consider periodic database optimization for production servers with high traffic

Compatibility

  • Fully compatible with Paper servers
  • Supports Spigot servers running API version 1.21+
  • No conflicts with other ban plugins (exclusive use recommended)

🚀 Installation Instructions

  1. Download the plugin JAR file
  2. Place it in your server's plugins/ folder
  3. Start the server - configuration will be generated automatically
  4. [Optional] Create API Key:
  5. Configure the config.yml file and add your API key (optional)
  6. Restart the server to apply configuration changes

First Steps

  • Set your server_name in config.yml
  • [Optional] Get an API Key:
    • Visit https://api.bsoftware.xyz/
    • Create a new API key to enable network-wide ban synchronization
    • Add the key to config.yml under database.central.api_key
  • Customize ban messages if desired
  • Grant permissions to administrators/moderators

📝 Changelog

Version 0.1.0 (Initial Release - March 23, 2026)

Added:

  • Permanent ban system with SQLite storage
  • Temporary ban system with automatic expiration
  • Central API integration for global ban management
  • Three core admin commands: /ban, /tempban, /unban
  • Automatic cleanup task for expired bans
  • Comprehensive ban verification on player login
  • Customizable configuration system
  • Full message customization support
  • Permission system with three permission nodes
  • Asynchronous database operations
  • Detailed logging of ban-related events
  • Complete README documentation

Documentation:

  • Comprehensive README.md with installation and usage guide
  • This Release.md with feature overview
  • Inline code documentation and comments
  • Configuration examples

🤝 Support & Feedback

For issues, suggestions, or feedback:

  • Website: https://bsoftware.xyz
  • Documentation: See README.md for detailed information
  • Configuration Help: Refer to the default config.yml

📜 Version Information

  • Version: 0.1.0
  • Release Date: March 23, 2026
  • Plugin Name: BSoftware_Bans
  • Developer: BSoftware Team
  • API Version: 1.21+
  • Status: Stable Release

🎯 Future Roadmap

Planned features for upcoming releases:

  • Ban appeals system
  • Admin logging and audit trails
  • Duration-based automatic unbans
  • Integration with Discord webhooks
  • Web dashboard for ban management
  • Ban statistics and analytics
  • Import/export functionality

Thank you for using BSoftware Bans! We hope it helps keep your server safe and secure. 🎮

For the latest updates and information, visit: https://bsoftware.xyz

Loading