LibertyBans 1.0.1

Obedience is liberating

  1. A248
    Native Minecraft Version:
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    • 1.17
    • 1.18
    Source Code:
    4drian3d, ahdg6, BeastyBoo, BlueTree242, D3adhkwen, Fabian Adrian, FranMC23, Gamer153, gepron1x, IceWaffles, Simon (KoxSosen), zendrique
    Languages Supported:
    Chinese (Simplified), Chinese (Traditional), French, German, Hungarian, Norwegian, Russian, Spanish
    LibertyBans is the brand new, extraordinary and brilliant weapon of punishment administration.

    [​IMG] [​IMG]


    The existing punishment plugins all have their flaws. Either they are plagued with bugs and concurrency issues, or they are closed-source and pay-walled, or both.

    None of the existing punishment plugins have a test framework which can compare to LibertyBans' extensive automated testing. This means that many bugs are caught automatically and never make it into stable releases.

    LibertyBans features a full-suite of punishment-related tools. It is a general-purpose punishment plugin with a focus on effective design, quality of experience, and unbeatable code quality.

    LibertyBans is the best designed plugin to punish players. It can efficiently scale to large networks and operate on single servers with minimal resources.

    • Add and remove punishments:
      • /ban, /ipban, /unban, /unbanip - bans or unbans a player or IP address
      • /mute, /ipmute, /unmute, /unmuteip - mutes or unmutes a player or IP address
      • /warn, /ipwarn, /unwarn, /unwarnip - warns or unwarns a player or IP address
      • /kick, /ipkick - kicks a player or IP address
    • Temporary versions of bans, mutes, and warns
    • All player data is stored using UUIDs.
    • List punishments:
      • /banlist - shows all bans
      • /mutelist - shows all mutes
      • /history - shows all punishments for a player
      • /warns - shows all warns for a player
      • /blame - shows all the punishments a staff member has enacted
    • Multiple means to block alt accounts:
      • Automatic enforcement to block alt accounts. By default, when using IP-bans, alts are automatically banned from joining if the main account is banned. This behavior is configurable, and you can even increase the strictness of alt-checking.
      • Manual /alts command - shows suspected alt accounts for a player.
      • Alts notification on join - tells staff members when a player whose suspected alt is banned or muted.
    • Options and behavior are fully configurable. You can even tweak your connection pool and statement cache settings to fine-tune performance.
    • The plugin is carefully designed to be performant and lightweight. It uses an efficient SQL schema which stores the raw bytes of UUIDs and IP addresses, rather than storing them as strings/text.
    • Full multi-proxy and multi-instance support. You can place LibertyBans on the proxy if you use a single proxy, or on multiple backend servers.
    Commands, Permissions, Configuration

    Everything is explained on the wiki:

    Wiki Link

    The wiki has a lot of information, including about the configuration.

    • The configuration files are extensively commented and the options are explained in detail.
    • If you update LibertyBans, your old configuration will be updated automatically if there are new options.


    • /libertybans usage
    to show all commands. When typing this into your console, leave off the slash.

    When creating temporary punishments, the same command is used for permanent punishments. Simply add the time after the username:
    • /ban Player1 30d This is a temporary ban
    For an extended guide, see this wiki page.

    • Effective and lightweight. No complicated installation and avoids unnecessary features.
    • Option to use local file-based database (HyperSQL), or remote database (MariaDB, MySQL, PostgreSQL).
    • Enhanced database-oriented performance emphasising calculations in SQL. Low memory usage because punishments are stored almost completely in the database. Data is stored in minimal form as raw bytes instead of strings.
    • Best practices for asynchronous calculations are followed. The performance cost of context switching is understood and avoided; the plugin does not blindly fire async tasks.
    • Designed for high availability and concurrency. Minimal locking is employed while keeping state consistent; this is mostly realized through the fact that most plugin state is maintained in the database itself.
    • Well-structured API providing a framework for other plugins to work with.

    • Java 11
    Supported platforms:
    • Bukkit / Spigot / Paper
    • BungeeCord / Waterfall
    • Velocity
    Compatibility with Geyser/Floodgate usernames.


    LibertyBans will work out-of-the-box for most users.
    • When using a single proxy, it is recommended, but not required, to install LibertyBans on the proxy itself.
    • LibertyBans can also be installed on the backend servers if you are willing to configure multi-instance synchronization.
    For installing on the backend servers and synchronizing punishments, see the wiki for additional information.

    External Connections
    When the plugin first starts, it downloads its API and internal dependencies. This is normal, and can take a couple of seconds the first time. Afterward, the plugin should start faster. The method used to download dependencies is just as secure as if the dependencies were shaded – the expected hashes of the dependencies are hard-coded, so if the downloaded dependency's hash differs, it is not saved to the filesystem.

    Fun Facts
    • LibertyBans was first released on 4 July 2020.
    • Updates are typicallly released on major holidays or days of significance, sometimes shortly after:
      • 0.8.0 was released 11 September 2021.
      • 0.8.1 was released 28 November 2021, 3 days after Thanksgiving.
      • 1.0.0 was released 3 January 2022, 2 days after New Year's.
      • 1.0.1 was released 16 February 2022, 2 days after Valentine's Day.

    Development Builds

    Reporting Bugs
    Please use Github issues:

Recent Reviews

  1. Honnisha
    Version: 1.0.1
    Thank you for your work! Very good functional for alt accounts. Very convenient plugin after AdvancedBans(good plugin too, dont get me wrong). I love how plugin logged ip every connection!
  2. ElectricAirplane
    Version: 1.0.1
    The best bans plugin... why would you use litebans over this? Works perfectly with every feature you might want.
  3. ahdg
    Version: 1.0.0
    A year later, It's still the best punishment plugin. ~
  4. ThisUserWasFree
    Version: 1.0.0
    This plugin in the best, it works perfectly with every feature you could want and the dev is amazing!
  5. DougDevelopz
    Version: 1.0.0
    This ban plugin deserves more recognition than anything in the world as the setup is readable, and very clean to begin with. Download this over LiteBans anytime! 11/10!
  6. craciu25_yt
    Version: 0.8.1
    Litebans ni se acerca. Simplemente maravilloso.
  7. lokka30
    Version: 0.8.1
    A248 has designed LibertyBans spectacularly. It includes the features that most servers require - and considering it hasn't even reached version 1 yet, I'm grateful the plugin is in such a good form. It's even free and open source with multiple translations, documentation, integration through proxies, and a support discord. Even taking the step to ensure the external files downloaded are hash-checked for security... just all round legendary development. Would love to see more resources from this author.
  8. zDoeProgram
    Version: 0.8.0
    Great plugin and an incredible developer! Truly the be-all, end-all of discipline!
  9. ElectricAirplane
    Version: 0.7.6
    Good for a new plugin! There is some stuff it could add in comparison to something like LiteBans, but still pretty decent.
  10. craft1234
    Version: 0.7.6
    No hablo ingles pero este plugin me ha servido demaciado a sacar tramposos de mi server. Liviano rapido y muy editable. El plugin perfecto para sanciones