Dil-Bans 1.0.0

The most customizable baning/muting plugin

  1. xDilok
    Native Minecraft Version:
    1.16
    Tested Minecraft Versions:
    • 1.14
    • 1.15
    • 1.16
    This plugin requires Vault to function properly!
    You can download current version here: https://www.spigotmc.org/resources/vault.34315/

    Features:
    - Allows you to ban/tempban/banip/tempbanip/mute/tempmute players
    - When player is offline but has played on the server you can ban his IP by banning username (plugin will do it for you)
    - Custom ban/tempban/banip/tempbanip messages
    - Tempmute with custom countdown and final message as actionbar/subtitle/title
    - Sound on final and countdown to the end of mute
    - All messages to players and admins are customizable in messages file
    - Store all user's data in file and MySQL database and file
    - Can disallow banning/muting even offline players with special permission
    - Tested on 1.14 and above minecraft versions


    [​IMG]
    [​IMG]
    [​IMG]
    [​IMG]
    [​IMG]
    List of commands:
    By using '-s' argument and if you have dilbans.silent permmision you can disable broadcast for used command
    - /ban <PlayerName> (-s) <Reason> - Bans player
    - /tempban <PlayerName> <TimeNumber>:<TimeUnit> (-s) <Reason>- Temporarily bans player
    - /unban <PlayerName> (-s) - Unbans player
    - /banip <PlayerName/IP> (-s) <Reason> - Bans IP
    - /tempbanip <PlayerName/IP> <TimeNumber>:<TimeUnit> (-s) <Reason>- Temporarily bans IP
    - /unbanip <PlayerName> (-s) - Unbans IP
    - /mute <PlayerName> (-s) <Reason> - Mutes player
    - /tempmute <PlayerName> <TimeNumber>:<TimeUnit> (-s) <Reason> - Temporarily mutes player
    - /unmute <PlayerName> (-s) - Unmutes player
    - /kick <PlayerName> - Kicks player
    - /checkstatus <PlayerName> - Checks bans/mute status of player
    - /dilbans reload - Reloads config and message files
    - /dilbans help - Displays help message

    List of permissions:
    dilbans.* - gives all possible permissions of Dil-Bans plugin
    dilbans.ban - allows to use ban command
    dilbans.tempban - allows to use tempban command
    dilbans.noban - disallows admins to ban player with this permission
    dilbans.banip - allows to use banip command
    dilbans.tempbanip - allows to use tempbanip command
    dilbans.nobanip - disallows admins to ip ban player with this permission
    dilbans.unban - allows admins to use unban command
    dilbans.unbanip - allows admins to use unbanip command
    dilbans.silent - allows admins to ban/banip/mute in silent mode (broadcast will not be displayed)
    dilbans.checkstatus - allows admin to use checkstatus command
    dilbans.kick - allows to use kick command
    dilbans.mute - allows to use mute command
    dilbans.tempmute - allows to use tempmute command
    dilbans.unmute - allows to use unmute command
    dilbans.nomute - disallows admins to mute player with this permission
    dilbans.reload - allows admin to reload config and messages files

    Default config settings:
    #You can store bans documentation in file and mysql
    StoreInFile: true
    StoreInMySQL: false
    #Plugin will display message in console when the update is available
    CheckUpdates: true
    #Mysql connect settings
    MySQL:
    ip: 'localhost'
    port: 3306
    login: 'login'
    password: 'password'
    #Here you can set full name of units, which will be displayed in ban messages and broadcasts
    SecondsName: 'Second(s)'
    MinutesName: 'Minute(s)'
    HoursName: 'Hour(s)'
    DaysName: 'Day(s)'
    MonthsName: 'Month(s)'
    #Here you can set shortcuts of units, which will be used in commands
    SecondsShortcut: 's'
    MinutesShortcut: 'min'
    HoursShortcut: 'h'
    DaysShortcut: 'd'
    MonthShortcut: 'mo'
    #Here you can set date format which will be displayed in users.yml and in ban messages
    DateFormat: 'dd-MM-yyyy HH:mm:ss'
    #You can set the number of seconds to count down when a player has been temporarily muted
    MuteTimer: 10
    #You can set which messages player can see during count down to the end of mute
    ActionBarStatus: true
    TitleStatus: false
    SubtitleStatus: true
    #Sounds for count down to the end of mute
    SoundTimer:
    Status: true
    Sound: BLOCK_DISPENSER_LAUNCH
    Volume: 10
    SoundTimerFinish:
    Status: true
    Sound: ENTITY_FIREWORK_ROCKET_TWINKLE_FAR
    Volume: 10
    #Commands blocked when player is muted
    MuteBlockedCommands:
    - 'me'
    - 'say'
    - 'msg'
    #List of ips which noone can ban
    IPAntiBan:
    - '127.0.0.1'

    Default messages file:
    ### General ###
    #This message is displayed when admin use wrong time unit in command
    CorrectTimeUnit: '&cUse correct time unit!'
    #This message is displayed when plugin can not find the specified player
    NoPlayer: '&cWe can not find this player!'
    #This message is displayed when plugin can not find IP of the specified player
    NoPlayerIP: '&cWe can not find IP of this player!'
    #This message is displayed when a player tries to do something he has not got permission
    NoPermission: '&cYou can not do this!'
    #This message is displayed when admin ban someone who did not play on the server; It is only warning, it does not prevent banning or muting
    PlayerDidntPlay: '&cWARNING! This player has never played on this server!'
    #This message is displayed when player incorrectly uses the command
    CorrectCommand: '&cTry: %command%'

    ### Ban section ###

    #This appears after using checkban command and player is banned
    BanStatusTrue: '&c✔ Banned'
    #This appears after using checkban command and player is not banned
    BanStatusFalse: '&a✗ No ban'
    #This message is displayed when admin tries to ban himself
    CantBanYourself: '&cYou can not ban yourself!'
    #This message is displayed when admin tries to ban someone with permission 'dilbans.noban'
    CantBan: '&cYou can not ban this player!'
    #This message is displayed when admin tries to 'unban' player which is not banned
    PlayerNotBanned: '&cThis player is not banned!'
    #This message is displayed when admin tries to 'unbanip' player which is not banned
    PlayerNotIPBanned: '&cThis player is not IP banned!'
    #This message is displayed when admin issues 'unbanall' command
    UnbanAll: '&aEveryone has been unbanned!'
    #This message is displayed when admin tries to ban player who has been already banned; Available variables: %player% - nickname of player
    PlayerAlreadyBanned: '&cPlayer &e%player% &chas been already banned!'
    #This message is displayed when admin tries to ban player who has been already IP banned; Available variables: %player% - nickname of player/IP
    PlayerAlreadyIPBanned: '&cPlayer/IP &e%player% &chas been already IP banned!'
    #This message is displayed to admin who has banned player; Available variables: %player% - nickname of player, %banreason% - reason of the ban
    PlayerBanned: '&cYou have banned &e%player% &cfor &e%banreason%'
    #This message is displayed to admin who has unbanned player; Available variables: %player% - nickname of player
    PlayerUnbanned: '&aYou have unbanned &e%player%&a!'
    #This message is displayed to admin who has tempbanned player; Available variables: %player% - nickname of player, %banreason% - reason of the ban, %bantime% - duration of ban
    PlayerTempbanned: '&cYou have tempbanned &e%player% &cfor &e%bantime% &cfor &e%banreason%'
    #This message is displayed to admin who has IP tempbanned player; Available variables: %player% - nickname of player/IP, %banreason% - reason of the ban, %bantime% - duration of ban
    IPTempbanned: '&cYou have IP tempbanned &e%player% &cfor &e%bantime% &cfor &e%banreason%&'
    #This message is displayed to admin who has IP banned player; Available variables: %player% - nickname of player/IP, %banreason% - reason of the ban
    IPBanned: '&cYou have banned player/IP &e%player% &cfor &e%banreason%&'
    #This message is displayed to admin who has IP unbanned player; Available variables: %player% - nickname of player/IP
    IPUnbanned: '&aYou have unbanned player/IP &e%player%&a!'

    ### Mute section ###

    #This appears after using checkban command and player is muted
    MuteStatusTrue: '&c✔ Muted'
    #This appears after using checkban command and player is not muted
    MuteStatusFalse: '&a✗ Not muted'
    #This message is displayed when admin tries to mute himself
    CantMuteYourself: '&cYou can not mute yourself!'
    #This message is displayed when admin tries to mute someone with permission 'dilbans.nomute'
    CantMute: '&cYou can not mute this player!'
    #This message is displayed to player who has been muted; Available variables: %mutereason% - reason of mute
    MutePlayerMessage: '&cYou have been muted for &e%mutereason%'
    #This message is displayed when player has been unmuted or time of tempmute is up
    UnmutePlayerMessage: '&aYou have been unmuted!'
    #This message is displayed when admin tries to mute somone who has been already muted
    PlayerAlreadyMuted: '&cPlayer %player% is already muted!'
    #This message is displayed to muted player when he joins the server
    MutedPlayerJoinMessage: '&cYou are muted on this server!'
    #This message is displayed when admin issues 'unmute all' command
    UnmuteAll: '&aEveryone has been unmuted!'
    #This message is displayed when admin tries to 'unmute' player which is not muted
    PlayerNotMuted: '&cThis player is not muted!'
    #This message is displayed to player who has been tempmuted
    TempmutePlayerMessage: '&cYou have been tempmuted for &e%mutetime% &cfor &2%mutereason% &cby &e%muter%'
    #This message is displayed to admin who has muted player; Available variables: %player% - nickname of player, %mutereason% - reason of the mute
    PlayerMuted: '&cYou have muted &e%player% &cfor &e%mutereason%&c!'
    #This message is displayed to admin who has unmuted player; Available variables: %player% - nickname of player
    PlayerUnmuted: '&aYou have unmuted &e%player%&a!'
    #This message is displayed to admin who has tempmuted player; Available variables: %player% - nickname of player, %mutereason% - reason of the ban, %mutetime% - duration of mute
    PlayerTempmuted: '&cYou have tempmuted &e%player% &cfor &e%mutetime% &cfor &e%mutereason%&c!'

    #You can remove any title, subtitle or action bar message during countdown or finish by leaving blank ''
    #If you would like to remove the whole message you can do it in the config of the plugin
    #Available variables: %s% - number of remaining seconds to the end of the mute
    #This message is displayed on counting down the mute time as title
    MutedPlayerTitleMessage: '&aYou will be unmuted in &6&l%s%'
    #This message is displayed on counting down the mute time as subtitle
    MutedPlayerSubTitleMessage: '&aYou will be unmuted in &6&l%s%'
    #This message is displayed on counting down the mute time as action bar
    MutedPlayerActionBarMessage: '&aYou will be unmuted in &6&l%s%'
    #This message is displayed on finish the mute time as title
    UnmutedPlayerTitleMessage: '&aYou have been unmuted!'
    #This message is displayed on finish the mute time as subtitle
    UnmutedPlayerSubTitleMessage: '&aYou have been unmuted!'
    #This message is displayed on finish the mute time as action bar
    UnmutedPlayerActionBarMessage: '&aYou have been unmuted!'

    ### Kick section ###

    #This message is displayed when admin tries to kick someone with permission 'dilbans.nokick'
    CantKick: '&cYou can not kick this player!'
    #This message is displayed when admin tries to kick himself
    CantKickYourself: '&cYou can not kick yourself!'
    #This message is displayed to admin who has kicked player; Available variables: %player% - nickname of player, %kickreason% - reason of the kick
    PlayerKicked: '&cYou have kicked &e%player% &cfor &e%kickreason%&c!'

    #This message is displayed when admin uses /checkstatus command
    #Available variables: %playername% - nickname of player, %uuid% - uuid of player, %playerip% - ip of player
    #%banstatus% - is player banned, %bandate% - date of ban, %banreason% - reason of the ban, %banremaining% - remaining time of ban (tempban/pernament)
    #%banipstatus% - is player ip banned, %banipdate% - date of ip ban, %banipreason% - reason of the ip ban, %banipremaining% - remaining time of ip ban (tempbanip/pernament)
    #%mutestatus% - is player muted, %muteremaining% - remaining time of mute (tempmute/pernament), %mutereason% - reason of the mute
    CheckStatus:
    - '&6=============================================='
    - '&aNickname: %playername%'
    - '&bUUID: %uuid%'
    - '&eIP: %playerip%'
    - '&eBan status: %banstatus%'
    - '&cBan reason: %banreason%'
    - '&eRemaining ban time: %banremaining%'
    - '&cBan date: %bandate%'
    - '&eBan IP status %banipstatus%'
    - '&cBan IP reason: %banipreason%'
    - '&eRemaining ban IP time: %banipremaining%'
    - '&cBan IP date: %banipdate%'
    - '&eMute status: %mutestatus%'
    - '&cMute reason: %mutereason%'
    - '&eRemaining mute time: %muteremaining%'
    - '&6=============================================='
    #This message is displayed when banned/tempbanned player tries to join to the server
    #Available variables:
    #%bandate% - date of ban, %bannedby% - nickname of admin who banned this player, %banreason% - reason of the ban, %banremaining% - remaining time of ban (tempban/pernament)
    UserBannedMessage:
    - '&6=============================================='
    - '&cYou have been banned on this server'
    - '&eBan date: %bandate%'
    - '&eBanned by: %bannedby%'
    - '&eBan reason: %banreason%'
    - '&eRemaining time: %banremaining%'
    - '&6=============================================='
    #This message is displayed when bannedip/tempbannedip player tries to join to the server
    #Available variables:
    #%bandate% - date of IP ban, %bannedby% - nickname of admin who IP banned this player, %banreason% - reason of the IP ban, %banremaining% - remaining time of IP ban (tempbanip/pernament)
    UserBannedIPMessage:
    - '&6=============================================='
    - '&cYou have been IP banned on this server'
    - '&eBan date: %bandate%'
    - '&eBanned by: %bannedby%'
    - '&eBan reason: %banreason%'
    - '&eRemaining time: %banremaining%'
    - '&6=============================================='
    #This message is displayed when player was kicked from the server
    #Available variables:
    #%kickedby% - nickname of admin who kicked this player, %kickreason% - reason of the kick
    UserKickedMessage:
    - '&6=============================================='
    - '&cYou have been kicked from this server'
    - '&eKicked by: %kickedby%'
    - '&eKick reason: %kickreason%'
    - '&6=============================================='

    #This message is displayed when admin uses '/dilbans help' command
    HelpCommand:
    - '&6============ &a+- &c&lDil-Bans Help &a-+ &6============'
    - '&e/ban &b- &2Command to ban player'
    - '&e/tempban &b- &2Command to temporarily ban player'
    - '&e/unban &b- &2Command to unban player'
    - '&e/banip &b- &2Command to ban IP'
    - '&e/tempbanip &b- &2Command to temporarily ban IP'
    - '&e/unbanip &b- &2Command to unban IP'
    - '&e/mute &b- &2Command to mute player'
    - '&e/tempmute &b- &2Command to temporarily mute player'
    - '&e/unmute &b- &2Command to unmute player'
    - '&e/kick &b- &2Command to kick player'
    - '&e/checkstatus &b- &2Command to check bans/mute status of player'
    - '&e/dilbans reload &b- &2Command to reload config and message files'
    - '&e/dilbans help &b- &2Displays this message'
    - '&6============================================'

    #You can disable any broadcast message by changing status from 'true' to 'false'
    #This message is broadcasted when admin ban player
    #Available variables: %bannedplayer% - nickname of the player, %banner% - nickname of the banning admin, %banreason% - reason of the ban
    BroadcastBanMessage:
    Status: true
    Message: '&cPlayer &e%bannedplayer% &chas been banned by &e%banner% &cfor &b%banreason%'
    #This message is broadcasted when admin unban player
    #Available variables: %bannedplayer% - nickname of the player, %unbanner% - nickname of the banning admin
    BroadcastUnbanMessage:
    Status: true
    Message: '&aPlayer &e%bannedplayer% &ahas been unbanned by &e%unbanner%&a!'
    #This message is broadcasted when admin tempban player
    #Available variables: %bannedplayer% - nickname of the player, %banner% - nickname of the banning admin, %banreason% - reason of the ban, %bantime% - duration of the ban
    BroadcastTempbanMessage:
    Status: true
    Message: '&cPlayer &e%bannedplayer% &chas been banned by &e%banner% &cfor &b%banreason% &cfor &e%bantime%'
    #This message is broadcasted when admin IP ban player
    #Available variables: %mutedplayer% - nickname of the player, %muter% - nickname of the muting admin, %mutereason% - reason of the mute
    BroadcastMuteMessage:
    Status: true
    Message: '&cPlayer &4%mutedplayer% &chas been muted by &e%muter% &cfor &b%mutereason%'
    #This message is broadcasted when admin tempmute player
    #Available variables: %mutedplayer% - nickname of the player, %muter% - nickname of the muting admin, %mutereason% - reason of the ban, %mutetime% - duration of the ban
    BroadcastTempmuteMessage:
    Status: true
    Message: '&cPlayer &e%mutedplayer% &chas been muted for %mutetime% for &2%mutereason% &cby &e%muter%'
    #This message is broadcasted when admin unmute player
    #Available variables: %mutedplayer% - nickname of the player, %unmuter% - nickname of the unmuting admin
    BroadcastUnmuteMessage:
    Status: true
    Message: '&aPlayer &b%mutedplayer% &ahas been unmuted by &e%unmuter%&a!'
    #This message is broadcasted when admin IP ban player
    #Available variables: %bannedplayer% - nickname of the player/IP, %banner% - nickname of the banning admin, %banreason% - reason of the ban
    BroadcastBanIPMessage:
    Status: true
    Message: '&cPlayer &e%bannedplayer% &chas been IP banned by &e%banner% &cfor &b%banreason%'
    #This message is broadcasted when admin IP unban player
    #Available variables: %bannedplayer% - nickname of the player/IP, %unbanner% - nickname of the unbanning admin
    BroadcastUnbanIPMessage:
    Status: true
    Message: '&aPlayer &e%bannedplayer% &ahas been IP unbanned by &e%unbanner%&a!'
    #This message is broadcasted when admin IP tempban player
    #Available variables: %bannedplayer% - nickname of the player/IP, %banner% - nickname of the banning admin, %banreason% - reason of the ban, %bantime% - duration of the ban
    BroadcastTempbanIPMessage:
    Status: true
    Message: '&cPlayer &e%bannedplayer% &chas been banned by &e%banner% &cfor &b%banreason% &cfor &e%bantime%'

    ### Others section ###
    #You can not use colors in here
    DefaultBanMessage: 'Admin is always right!'
    DefaultKickMessage: 'Admin is always right!'
    DefaultMuteMesssage: 'Admin is always right!'
    DefaultNoBanMessage: 'No ban'
    DefaultNoMuteMessage: 'Not muted'
    Pernament: 'Pernament'
    Console: 'Console'
    PH-PlayerName: '<PlayerName>'
    PH-PlayerNameIP: <PlayerName/IP>
    PH-TimeUnit: '<TimeUnit>'
    PH-TimeNumber: '<TimeNumber>'
    PH-Reason: '<Reason>'

Recent Updates

  1. Update link for updater