LiteBans icon

LiteBans -----

A complete, modern, cross-server banning solution (Spigot, Folia, Fabric, Bungee, Velocity).




LiteBans is a cross-server punishment management system with many advanced customizable features to enhance your moderation experience.

All punishments made through LiteBans will take effect globally across all servers linked to the same database.
Although LiteBans is designed to effectively synchronize between hundreds of servers, it can still work alone on a single server without a MySQL database.

LiteBans can run natively under Spigot, Folia, Fabric, BungeeCord, and Velocity, offering the same features on all platforms.

Features
  • Designed from the ground up with UUID support in mind. All punishments are UUID-based.
  • Fully customizable kick screen for banned players, multiple lines and colours can be used, as well as ban information variables – duration until ban expires, reason, staff member who placed the ban, server which ban was placed on, time since ban was placed, original ban date & duration, and many more.
  • Template system allows you to make fully customizable punishment ladders. Each time you punish someone using a template, the punishments will scale up with repeat offences. Each ban template can be assigned with a custom kick screen message!
  • Custom warning templates are supported, allowing you to define categories for warnings that each have their own set of triggered punishment commands which run after players are warned a specific number of times.
  • Server scopes are supported, granting you the ability to place per-server punishments and global punishments.
  • Discord Webhook support - to send customizable embed messages to your Discord server! Easy to configure.
  • All messages are customizable in messages.yml. There are many useful variables available to place in any configurable message that involves a ban, mute, or warning. Hover-text and hex colours supported.
  • You can view punishment history for players (/history) and punishments issued by staff members (/staffhistory).
  • Several database types are supported, including MySQL, MariaDB, PostgreSQL, and H2. H2 is used by default, meaning that MySQL is not needed to use LiteBans with a single-server setup.
  • Linked account detection and banning - when a player with a banned account on the same IP joins, all players with the right permissions will be notified. These accounts can also be banned automatically.
  • Multi-instance synchronization system allows global punishments and broadcasts to instantly take effect across all servers connected to the same database, even if the plugin is not installed under BungeeCord.
  • Staff members can be "rolled back" – all punishments which they've issued can be removed at any time with a single command. Staff abuse has never been easier to deal with.
  • Bans can be imported from vanilla (including Essentials), and 7 popular plugins, including MaxBans, BanManager, AdvancedBan, and BungeeAdminTools.
  • Users who have been IP-banned or GeoIP-blocked can be permitted using the "/litebans allow" command, which excludes their account from the IP ban without removing the ban entirely.
  • Offline players can receive warnings; they will see all of their new warnings when they join. This works across servers.
  • Players cannot overwrite punishments unless they have permission.
  • Lightweight, multithreaded, and designed for performance. LiteBans uses a minimal amount of memory and does not block the main server thread with any database queries after startup.
Cross-Server Synchronization
One of the best features of LiteBans for networks is its cross-server synchronization system.

For example:

Server A, Server B and Server C are all running LiteBans, connected to the same MySQL database.

If a player who is on Server A is muted on Server B, it will immediately take effect on Server A, the player will be muted, and all players on Server A, B and C will see the broadcast indicating that the player was muted if they have permission and broadcast synchronization is enabled. If the player leaves Server A and joins Server B or Server C, they will still be muted.

Web Interface
The web interface lists all bans, mutes, warnings, and kicks.
It can be used to view all punishments for specific players or by staff, and check when those punishments will expire.
* Free website is not included, you will require your own website hosting.

litebans-php-1.png

litebans-php-2.png

Installation guide: https://gitlab.com/ruany/litebans-php/-/wikis/Installation


JSON Support
LiteBans allows you to define custom hover text in all messages, including broadcasts.
Only players with permission ( litebans.json.hover_text) will see the hover text.
All variables available to use in messages.yml can also be included in hover text, along with colours and newlines.
LiteBans_HoverText.png
Example:
Code (Text):
broadcast_ban: '&e$bannedPlayer &chas been banned. {hoverText: &aHover text here!}'

Template System
LiteBans has a powerful template system. Templates can be applied to bans, mutes, warnings, and kicks.

Each template has a configurable ladder, so, for example, you can have a template which bans a player for 2 weeks the first time you apply that template, one month when they are banned for the second time, and three months when they are banned for the third time.
That's the tip of the iceberg. See Templates on the wiki for the full documentation and examples!


Commands

All commands and flags are documented on the wiki - click here to view them.

Permissions
The full permissions list can be viewed here.

Configuration
All options in the configuration work equally on all versions of the plugin (Spigot/Fabric/Bungee/Velocity) unless explicitly otherwise stated.

Plugin configuration (config.yml):
The default config.yml can be viewed here.


Custom messages (messages.yml):
The default messages.yml can be viewed here.
All variables are now documented in messages.yml and can be viewed above.

Importing
A full guide with information, instructions, and examples can be viewed here:
https://gitlab.com/ruany/LiteBans/-/wikis/Importing

Images
you-are-banned.png
2015-02-12_14.31.50__.png

Requirements
For MySQL support in the plugin, a working MySQL database is required.

If you're running a single plugin instance and don't need the web interface, you do not need a MySQL server and the plugin will already work immediately without configuration after being installed.

An active Internet connection is required, but only for the first time the plugin is started. The dependencies -- which are only downloaded once per update, and can be downloaded separately -- will work offline after being stored in the LiteBans data folder.

Install
LiteBans can be installed in several ways. It can run on a single Spigot server or Fabric server, multiple Spigot/Fabric servers linked to the same MySQL database, or it can be installed directly on BungeeCord or Velocity.

API

https://gitlab.com/ruany/LiteBansAPI/wikis/home

Terms of Service
  1. You are allowed to use the plugin on multiple servers, provided that all of these servers belong to you.
  2. You are allowed to freely use and modify the web interface, you can also remove or modify the copyright message in header.php.
  3. You may not redistribute or re-sell the plugin; doing so will result in your access to the plugin and future updates being revoked permanently.
  4. You may not file a dispute or chargeback via PayPal or any payment processor; doing so will result in your access to the plugin and future updates being revoked permanently.
Refund policy

Refunds will be granted for any reason within 30 days of purchase, unless the Terms of Service have been violated.

Send me a PM if you wish to request a refund. Also, please contact me when purchasing after being previously refunded, to prevent interruptions in service.

Tags: LiteBans spigot plugin, LiteBans bungee plugin, LiteBans bungeecord proxy plugin, LiteBans Velocity proxy, LiteBans premium plugin, cross server sync, spigot cross server bans, bungee cross server bans, cross-server punishments, multi server banning, cross-network punishments, punish, ban synchronization plugin mysql, ban sync mysql spigot, bungee network banning plugin, ban sync mysql bungee, mute synchronization plugin mysql, ban database plugin, punishment database plugin, uuid banning plugin, ip banning plugin, uuid punish plugin, custom ban message plugin, custom kick message plugin, spigot alts plugin, staff rollback plugin, liteban, litebans, lightbans, light bans, lite bans, lite ban, litebans web interface, litebans website, litebans access, litebans download, litebans buy, litebans purchase, litebans spigot, litebans permissions, litebans servers, custom punish plugin, customizable punish plugin, global banning plugin, ban history spigot plugin, ban plugin, mute history, litebans messages, litebans 1.8, litebans 1.20, litebans 1.21

Regarding reviews:
Read the FAQ before posting a review or reporting problems with the plugin!
Report issues via Discord, discussion thread, or the issue tracker.
Resource Information
Author:
----------
Total Downloads: 18,559
First Release: Feb 5, 2015
Last Update: Apr 9, 2025
Category: ---------------
All-Time Rating:
705 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings