Skip to content

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