EasyBan

simple commands to manage bans, kicks, and mutes on your server.

Description:

EasyBan is a simple Minecraft plugin that helps you manage punishments on your server quickly.

🧰 Commands:

(version 1.6)

• /eb ban player <nickname> <reason> — permanently ban a player
• /eb ban ip <nickname|IP> <reason> — permanently ban an IP address (or the IP of a player)
• /eb tempban player <nickname> <time> <reason> — temporarily ban a player
• /eb tempban ip <nickname|IP> <time> <reason> — temporarily ban an IP address
• /eb delban player <nickname> — unban a player (exempts player if their IP is banned)
• /eb delban ip <nickname|IP> — unban an IP address
• /eb kick <nickname> <reason> — kick a player
• /eb mute player <nickname> <reason> — mute a player
• /eb mute ip <nickname|IP> <reason> — mute an IP address
• /eb tempmute player <nickname> <time> <reason> — temporarily mute a player
• /eb tempmute ip <nickname|IP> <time> <reason> — temporarily mute an IP address
• /eb delmute player <nickname> — unmute a player
• /eb delmute ip <nickname|IP> — unmute an IP address
• /eb notbreak give <nickname> <reason> — restrict a player from breaking blocks

* /eb notbreak remove <nickname> — allow a player to break blocks again

• Time Format (<time>): Specified as a single word combining number and unit. Examples: 30s (30 seconds), 10m (10 minutes), 2h (2 hours), 1d (1 day), 2w (2 weeks).
• Server Target (server:<server>): You can optionally add server:<server_name> at the end of any punishment or unpunishment command to target a specific server (e.g., server:survival). Write server:all to apply the action network-wide across all connected servers (and Velocity). You don't need to use this if you don't use MySQL or want the action to apply only to the current server.
• IP Exception (not:<nickname>): You can optionally add not:<nickname> at the end of any IP punishment command (ban ip, tempban ip, mute ip, tempmute ip). This means the punishment will apply to everyone on that IP except for the specified player.

New version 1.6!

Remaked command syntax. Added New EasyBan version, EasyBan-Lite! <details> <summary>Сonfig:</summary>

#  ---------------------------------------------------- #
#                    EasyBan Configuration               #
#  ---------------------------------------------------- #

#  Name of this specific server (used for MySQL syncing)
server-name: "survival"

#  Should the plugin check GitHub for new updates on startup?
checkupdates: true

storage:
  #  Type can be "local" (uses data.yml) or "mysql" (cross-server sync)
  type: "local"

  # How often the plugin checks the database for new bans (in seconds)
  sync-interval: 4

  mysql:
    host: "localhost"
    port: 3306
    database: "easyban"
    username: "root"
    password: ""
    table-prefix: "eb_" # Optional. Leave blank for no prefix

</details>

<details> <summary>Messages.yml:</summary>

# ---------------------------------------------------- #
#                   EasyBan Messages                   #
#  Supports MiniMessage (e.g. <red>, <#FF5555>, <bold>)#
# ---------------------------------------------------- #

prefix: "<dark_gray>[<aqua>EasyBan</aqua>]</dark_gray> "
no-permission: "<red>You do not have permission to use this command!</red>"
player-only: "<red>This command can only be used by players.</red>"
invalid-usage: "<red>Usage: %usage%</red>"
player-not-found: "<red>Player not found or invalid IP.</red>"
invalid-duration: "<red>Invalid duration format! Example: 10m, 2h, 1d, 1w.</red>"

banned-layout: "<red><bold>YOU ARE BANNED!</bold></red><newline><newline><gray>Reason:</gray> <white>%reason%</white><newline><gray>Banned by:</gray> <white>%admin%</white><newline><gray>Server:</gray> <white>%server%</white><newline><gray>Expires:</gray> <white>%time%</white>"
muted-message: "<red>You are muted on server <yellow>%server%</yellow>! Reason: %reason%</red>"
ipmuted-message: "<red>Your IP is muted on server <yellow>%server%</yellow>! Reason: %reason%</red>"
cant-break-message: "<red>You are restricted from breaking blocks on server <yellow>%server%</yellow>! Reason: %reason%</red>"

ban-success: "<green>Player/IP <white>%player%</white> has been banned on <yellow>%server%</yellow>.</green>"
unban-success: "<green>Player <white>%player%</white> has been unbanned.</green>"
kick-success: "<green>Player <white>%player%</white> has been kicked.</green>"
mute-success: "<green>Player/IP <white>%player%</white> has been muted on <yellow>%server%</yellow>.</green>"
unmute-success: "<green>Player <white>%player%</white> has been unmuted.</green>"
ipmute-success: "<green>IP <white>%ip%</white> has been muted on <yellow>%server%</yellow>.</green>"
unban-ip-success: "<green>IP <white>%ip%</white> has been unbanned.</green>"
unmute-ip-success: "<green>IP <white>%ip%</white> has been unmuted.</green>"
donotbreak-success: "<green>Player <white>%player%</white> has been blocked from breaking blocks on <yellow>%server%</yellow>.</green>"
deldonotbreak-success: "<green>Player <white>%player%</white> can now break blocks again.</green>"

</details>

<details> <summary>Velocity Config</summary>

storage:
  sync-interval: 4
  mysql:
    host: "localhost"
    port: 3306
    database: "easyban"
    username: "root"
    password: ""
    table-prefix: "eb_"

</details>

<details> <summary>EasyBan-Lite Config</summary>

# ---------------------------------------------------- #
#               EasyBan-lite Configuration             #
# ---------------------------------------------------- #

# Should the plugin check GitHub for new updates on startup?
checkupdates: true

</details>

*The MySQL is working on NON SSL mode!

✨ Features:

• Easy to use commands
• Supports temporary and permanent bans
• Kick and mute players quickly
• Works on small and large servers

🖥️ Requirements:

• Minecraft 1.21+

❗info

If you reinstall or update the plugin, your previous bans will still work. However, it is always recommended to test it, as it depends on whether you have MySQL connected or not.

Plugin was NOT testet on Folia

In version 1.6 can be bugs, if you find one please write in Discord Chanel.