1. Docs
  2. /
  3. BanManager
  4. /
  5. Configuration
  6. /
  7. messages.yml

messages.yml

Defines BanManager's messages throughout the plugin.

Messages support JSON and Minecraft colour codes using the & delimiter. Use \n for new lines. Text wrapped inside square brackets i.e. [player] are tokens which will be replaced with their corresponding value. Set values to an empty string, i.e. '' if you do not wish the message to display.

PlatformLocation
CraftBukkit/Spigot/Paper/plugins/BanManager/messages.yml
BungeeCord/plugins/BanManager/messages.yml
Sponge/config/banmanager/messages.yml
Velocity/plugins/BanManager/messages.yml
duplicateIP

Sent to players with the bm.notify.duplicateips permission when the same IP address of a banned player joins.

TokenExampleDescription
playerconfuserPlayer name
playersJamsJar, Issy2322, SavannahFA list of comma separated player names

Example

&cWarning: [player] has the same IP as the following banned players:\n&6[players]
Minecraft hill

Warning: confuser has the same IP as the following banned players:
JamsJar, Issy2322, SavannahF


duplicateIPAlts

Sent to players with the bm.notify.alts permission when a player joins with an IP address associated to other players.

TokenExampleDescription
playerconfuserPlayer name
playersJamsJar, Issy2322, SavannahFA list of comma separated player names

Example

&cWarning: [player] has the same IP as the following players:\n&6[players]
Minecraft hill

Warning: confuser has the same IP as the following players:
JamsJar, Issy2322, SavannahF


configReloaded

Sent when the config is reloaded via /bmreload.

Example

&aConfiguration reloaded successfully!
Minecraft hill

Configuration reloaded successfully!


  • deniedNotify
    • player
      Sent to players with the bm.notify.denied.player permission when a banned player is denied from joining the server.
      TokenExampleDescription
      actorJamsJarPlayer name who issued punishment
      playerconfuserPlayer name
      reasonHackingThe cause of the punishment

      Example

      &cWarning: [player] attempted to join the server but was denied due to &4[reason]
      Minecraft hill

      Warning: confuser attempted to join the server but was denied due to Hacking

    • ip
      Sent to players with the bm.notify.denied.ip permission when a banned IP address is denied from joining the server.
      TokenExampleDescription
      actorJamsJarPlayer name who issued punishment
      ip127.0.0.1The punished IP address, IPv4 or IPv6
      reasonHackingThe cause of the punishment

      Example

      &cWarning: [ip] attempted to join the server but was denied due to &4[reason]
      Minecraft hill

      Warning: 127.0.0.1 attempted to join the server but was denied due to Hacking


deniedMaxIp

Server join deny message when maxOnlinePerIp limit reached.

Example

&cToo many players with your ip address online

Disconnected by Server

Too many players with your ip address online

Back to server list


deniedMultiaccounts

Server join deny message when maxMultiaccountsRecently limit reached.

Example

&cToo many players with your ip address logged in recently

Disconnected by Server

Too many players with your ip address logged in recently

Back to server list


deniedCountry

Server join deny message when player connecting from a country not on the countries list.

TokenExampleDescription
countryUnited KingdomName of country
countryIsoGBISO code of country

Example

&cYou may not connect from your region

Disconnected by Server

You may not connect from your region

Back to server list


  • time
    A list of components to display a length of time, e.g. temporary banning a player for 1y2m3w4d5m is displayed as 1 year 2 months 3 weeks 4 days 5 minutes
    • now
    • year
    • years
    • month
    • months
    • week
    • weeks
    • day
    • days
    • hour
    • hours
    • minute
    • minutes
    • second
    • seconds
    • never
      Displayed when a punishment is permanent and never expires
    • error
      • invalid
        Displayed when entering an incorrect duration, e.g. /tempban confuser 6ha Hacking

        Example

        &cYour time length is invalid
        Minecraft hill

        Your time length is invalid


none

Displayed when no alts for a player are found via /alts command.


  • sender
    A list of generic messages used by most commands for common scenarios.
    • error
      • notFound
        Displayed when attempting to perform a command on a player which cannot be found in BanManager's database
        TokenExampleDescription
        playerconfuserPlayer name

        Example

        &c[player] not found, are you sure they exist?
        Minecraft hill

        confuser not found, are you sure they exist?

      • offline
        Displayed when attempting to perform a command which requires a player to be online, e.g. /kick <player> <reason>
        TokenExampleDescription
        playerconfuserPlayer name

        Example

        &c[player] is offline
        Minecraft hill

        confuser is offline

      • noSelf
        Displayed when attempting to perform a command on yourself, e.g. banning yourself

        Example

        &cYou cannot perform that action on yourself!
        Minecraft hill

        You cannot perform that action on yourself!

      • exception
        Displayed when attempting an unknown error occurs, check your server console & logs for further information.

        Example

        &cAn error occured whilst attempting to perform this command. Please check the console for further details.
        Minecraft hill

        An error occured whilst attempting to perform this command. Please check the console for further details.

      • invalidIp
        Displayed when attempting to perform a command with an incorrectly formatted IP address, e.g. /banip 127.0.1
        TokenExampleDescription
        ip127.0.0.1The punished IP address, IPv4 or IPv6

        Example

        &cInvalid IP address, expecting w.x.y.z format
        Minecraft hill

        Invalid IP address, expecting w.x.y.z format

      • ipNotSupported
        Displayed when attempting to perform a command which does not support IP addresses, e.g. /bminfo 127.0.0.1

        Example

        &cFetching information by IP address is currently unsupported.
        Minecraft hill

        Fetching information by IP address is currently unsupported.

      • offlinePermission
        Displayed when attempting to perform a command on an offline player without the neccessary offline permission, e.g. bm.command.ban.offline

        Example

        &cYou are not allowed to perform this action on an offline player
        Minecraft hill

        You are not allowed to perform this action on an offline player

      • exempt
        Displayed when attempting to perform a command on a player who is exempt
        TokenExampleDescription
        playerconfuserPlayer name

        Example

        &c[player] is exempt from that action
        Minecraft hill

        confuser is exempt from that action

      • noPermission
        Displayed when attempting to perform a command without the neccessary permissions, such as attempting to use a command flag e.g. /ban -silent <player> <reason>
        TokenExampleDescription
        playerconfuserPlayer name

        Example

        &cYou do not have permission to perform that action
        Minecraft hill

        You do not have permission to perform that action

      • invalidReason
        Displayed when attempting to use a reason shortcut which does not exist, e.g. /ban confuser #doesnotexist, requires enabling blockInvalidReasons
        TokenExampleDescription
        reasonHackingThe cause of the punishment

        Example

        &c[reason] is no valid reason.
        Minecraft hill

        Hacking is no valid reason.


  • alts
    Messages used by the /alts command
    • First line sent when using the /alts <player || ip> command
      TokenExampleDescription
      ip127.0.0.1The punished IP address, IPv4 or IPv6

      Example

      Possible alts found:
      Minecraft hill

      Possible alts found:


  • export
    Messages used by the /bmexport command
    • error
      • inProgress
        Displayed when an export is already in progress

        Example

        &cAn export is already in progress, please wait
        Minecraft hill

        An export is already in progress, please wait

    • player
      Messages used by /bmexport players
      • started
        Displayed when an export begins

        Example

        &aPlayer ban export started
        Minecraft hill

        Player ban export started

      • finished
        Displayed when an export successfully completes
        TokenExampleDescription
        filebanned-players-2021-06-01_12-32-10.jsonLocation of export

        Example

        &aPlayer ban export finished, file [file] created
        Minecraft hill

        Player ban export finished, file banned-players-2021-06-01_12-32-10.json created

    • ip
      Messages used by /bmexport ips
      • started
        Displayed when an export begins

        Example

        &aIP ban export started
        Minecraft hill

        IP ban export started

      • finished
        Displayed when an export successfully completes
        TokenExampleDescription
        filebanned-ips-2021-06-01_12-32-10.jsonLocation of export

        Example

        &aIP ban export finished, file [file] created
        Minecraft hill

        IP ban export finished, file banned-ips-2021-06-01_12-32-10.json created


  • import
    Messages used by the /bmimport command
    • error
      • inProgress
        Displayed when an import is already in progress

        Example

        &cAn import is already in progress, please wait
        Minecraft hill

        An import is already in progress, please wait

    • player
      Messages used by /bmimport players
      • started
        Displayed when an import begins

        Example

        &aPlayer ban import started
        Minecraft hill

        Player ban import started

      • finished
        Displayed when an import successfully completes

        Example

        &aPlayer ban import finished
        Minecraft hill

        Player ban import finished

    • ip
      Messages used by /bmimport ips
      • started
        Displayed when an import begins

        Example

        &aIP ban import started
        Minecraft hill

        IP ban import started

      • finished
        Displayed when an import successfully completes

        Example

        &aIP ban import finished
        Minecraft hill

        IP ban import finished

    • advancedban
      Messages used by /bmimport advancedban
      • started
        Displayed when an import begins

        Example

        &aAdvancedBan import started
        Minecraft hill

        AdvancedBan import started

      • finished
        Displayed when an import successfully completes

        Example

        &aAdvancedBan import finished
        Minecraft hill

        AdvancedBan import finished

    • h2
      Messages used by /bmimport h2
      • started
        Displayed when an import begins

        Example

        &aH2 import started
        Minecraft hill

        H2 import started

      • finished
        Displayed when an import successfully completes

        Example

        &aH2 import finished, please restart the server
        Minecraft hill

        H2 import finished, please restart the server


  • info
    Messages used by the /bminfo command
    • error
      • indexRequired
        Displayed when multiple players with the same name are found
        TokenExampleDescription
        nameconfuserName searched
        size3Number of players found with same name

        Example

        &cMultiple players named [name], found, please select a player by providing an index between 1 and [size], e.g. /bminfo [name] 1
        Minecraft hill

        Multiple players named confuser, found, please select a player by providing an index between 1 and 3, e.g. /bminfo [name] 1

      • invalidIndex
        Displayed when an invalid index number is provided, e.g. /bminfo confuser asb
        TokenExampleDescription
        ip127.0.0.1The punished IP address, IPv4 or IPv6

        Example

        &cInvalid player option used
        Minecraft hill

        Invalid player option used

      • index
        Displays a list of players to choose from
        TokenExampleDescription
        index0Option to choose
        nameconfuserName searched
        uuidae51c849-3f2a-4a37-986d-55ed5b02307fUUID of player

        Example

        &7#[index] - &6[name] - &4[uuid]
        Minecraft hill

        #0 - confuser - ae51c849-3f2a-4a37-986d-55ed5b02307f

    • stats
      • player
        Displays the sum of player punishments, separated by type
        TokenExampleDescription
        playerconfuserPlayer name
        playerIdae51c849-3f2a-4a37-986d-55ed5b02307fUUID of player
        bans2Total number of bans
        mutes2Total number of mutes
        kicks2Total number of kicks
        warns2Total number of warnings
        warnPoints2Total amount of warning points
        notes2Total number of notes

        Example

        &6[player] has been banned [bans] times, muted [mutes] times, kicked [kicks] times and warned [warns] times ([warnPoints] Points) and has [notes] notes
        Minecraft hill

        confuser has been banned 2 times, muted 2 times, kicked 2 times and warned 2 times (2 Points) and has 2 notes

      • ip
        Displays the sum of IP punishments, separated by type
        TokenExampleDescription
        bans2Total number of bans

        Example

        &6This ip has been banned [bans] times
        Minecraft hill

        This ip has been banned 2 times

    • connection
      Displays the player's last connection
      TokenExampleDescription
      playerconfuserPlayer name
      ip127.0.0.1The punished IP address, IPv4 or IPv6
      lastSeen02-06-2021 13:42:54Date and time player last connected in dd-MM-yyyy HH:mm:ss format

      Example

      &6Their last connection was with [ip] on [lastSeen]
      Minecraft hill

      Their last connection was with 127.0.0.1 on 02-06-2021 13:42:54

    • geoip
      Displays the player's geolocation information, requires geoip to be enabled
      TokenExampleDescription
      countryUnited KingdomName of country
      countryIsoGBISO code of country
      cityLondonName of city

      Example

      Country: [country] City: [city]
      Minecraft hill

      Country: United Kingdom City: London

    • ban
      • permanent
        Displays the player's current permanent ban information
        TokenExampleDescription
        id1Numerical identifier (ID)
        playerconfuserPlayer name
        actorJamsJarPlayer name who issued punishment
        reasonHackingThe cause of the punishment
        created02-06-2021 13:42:54Date and time punishment issued

        Example

        &6Currently banned for &4[reason]&6 by [actor] at [created]
        Minecraft hill

        Currently banned for Hacking by JamsJar at 02-06-2021 13:42:54

      • temporary
        Displays the player's current temporary ban information
        TokenExampleDescription
        id1Numerical identifier (ID)
        playerconfuserPlayer name
        actorJamsJarPlayer name who issued punishment
        reasonHackingThe cause of the punishment
        created02-06-2021 13:42:54Date and time punishment issued
        expires02-06-2021 13:42:54Date and time punishment expires

        Example

        &6Currently banned for &4[reason]&6 by [actor] at [created] which expires in [expires]
        Minecraft hill

        Currently banned for Hacking by JamsJar at 02-06-2021 13:42:54 which expires in 02-06-2021 13:42:54

      • dateTimeFormat
        Defines the format of when the ban was issued

        Example

        dd-MM-yyyy HH:mm:ss
    • ipban
      • permanent
        Displays an associated permanent IP ban
        TokenExampleDescription
        id1Numerical identifier (ID)
        actorJamsJarPlayer name who issued punishment
        reasonHackingThe cause of the punishment
        created02-06-2021 13:42:54Date and time punishment issued

        Example

        &6Currently banned for &4[reason]&6 by [actor] at [created]
        Minecraft hill

        Currently banned for Hacking by JamsJar at 02-06-2021 13:42:54

      • temporary
        Displays an associated temporary IP ban
        TokenExampleDescription
        id1Numerical identifier (ID)
        actorJamsJarPlayer name who issued punishment
        reasonHackingThe cause of the punishment
        created02-06-2021 13:42:54Date and time punishment issued
        expires02-06-2021 13:42:54Date and time punishment expires

        Example

        &6Currently banned for &4[reason]&6 by [actor] at [created] which expires in [expires]
        Minecraft hill

        Currently banned for Hacking by JamsJar at 02-06-2021 13:42:54 which expires in 02-06-2021 13:42:54

      • dateTimeFormat
        Defines the format of when the ban was issued

        Example

        dd-MM-yyyy HH:mm:ss
    • mute
      • permanent
        Displays the player's current permanent mute information
        TokenExampleDescription
        id1Numerical identifier (ID)
        playerconfuserPlayer name
        actorJamsJarPlayer name who issued punishment
        reasonHackingThe cause of the punishment
        created02-06-2021 13:42:54Date and time punishment issued

        Example

        &6Currently muted for &4[reason]&6 by [actor] at [created]
        Minecraft hill

        Currently muted for Hacking by JamsJar at 02-06-2021 13:42:54

      • temporary
        Displays the player's current temporary mute information
        TokenExampleDescription
        id1Numerical identifier (ID)
        playerconfuserPlayer name
        actorJamsJarPlayer name who issued punishment
        reasonHackingThe cause of the punishment
        created02-06-2021 13:42:54Date and time punishment issued
        expires02-06-2021 13:42:54Date and time punishment expires

        Example

        &6Currently muted for &4[reason]&6 by [actor] at [created] which expires in [expires]
        Minecraft hill

        Currently muted for Hacking by JamsJar at 02-06-2021 13:42:54 which expires in 02-06-2021 13:42:54

      • dateTimeFormat
        See Java's DateTimeFormatter for a list of available symbols.

        Example

        dd-MM-yyyy HH:mm:ss
    • website
      • player
        Displays a link to view the player's profile
        TokenExampleDescription
        playerconfuserPlayer name
        playerIdae51c849-3f2a-4a37-986d-55ed5b02307fUUID of player

        Example

        http://yourdomain.com/index.php?action=viewplayer&player=[player]&server=0
        Minecraft hill

        http://yourdomain.com/index.php?action=viewplayer&player=confuser&server=0

    • history
      Displays records for a player via /bminfo confuser -bans -mutes, requires permissions bm.command.bminfo.history.[type] depending on record types.
      • row
        TokenExampleDescription
        id1Numerical identifier (ID)
        typeBanThe record type
        reasonHackingThe cause of the punishment
        actorJamsJarPlayer name who issued punishment
        created02-06-2021 13:42:54Date and time punishment issued
        meta5Additional information pertaining to the record e.g. warning points

        Example

        &7#[id] &a[&f[type]&a] &6[actor]&f [meta] [reason] - &e[created]
        Minecraft hill

        #1 [Ban] JamsJar 5 Hacking - 02-06-2021 13:42:54

      • noResults
        Displayed when no records found

        Example

        &cNo results found
        Minecraft hill

        No results found

      • dateTimeFormat
        See Java's DateTimeFormatter for a list of available symbols.

        Example

        dd-MM-yyyy HH:mm:ss
    • ips
      Shows join and leave times of player via /bminfo confuser -ips, requires permission bm.command.bminfo.history.ips and requires logIps to be enabled.
      • row
        TokenExampleDescription
        ip127.0.0.1The punished IP address, IPv4 or IPv6
        join02-06-2021 13:42:54Date and time player joined the server
        leave02-06-2021 13:42:54Date and time player left the server

        Example

        &e[ip] - &6[join] - [leave]
        Minecraft hill

        127.0.0.1 - 02-06-2021 13:42:54 - 02-06-2021 13:42:54

      • dateTimeFormat
        See Java's DateTimeFormatter for a list of available symbols.

        Example

        dd-MM-yyyy HH:mm:ss

About

  • by James Mortemore © 2012 - 2024