CheckNameHistory 3.1.0

Using Mojang's Official API! Check history of name changes! Use it to update Lockette/Deadbolt!

  1. vk2gpz
    Using Mojang's official API! This is a extremely simple plugin that allows you to check the history of name changes.

    As of version 2.0.0, when a player login to a server, this plugin force check his/her name history against Mojang's server and saves the history in the local cache. This local cache can be used by other plugin using this plugin's public API to get name histories.


    Lockette / Deadbolt:
    You can use this plugin to update old names on the lockette and deadbolt signs. Players just need to Right-Click the sign with their name on it.

    • /cnh | /cnh help : displays the help menu
    • /cnh <latest_name> [-c] : displayers the history of name changes. With the option '-c', this command will look up name history from the local cache.
      NOTE: the name needs to be the latest name.
    • /cnh reload : reloads the config.yml file.
    Permission Node:
    • checknamehistory.admin : allows you to use /cnh <name> command
    • checknamehistory.reload : allows you to use /cnh reload command
    You can configure how name history is displayed in config.yml:
    • %player% : player name
    • %uuid% : player's uuid
    • %name% : player's previous name
    • %date% : player's latest name change date/time
    Code (Text):

    # This is a template config file
    # define your parameter and its value like:
      ErrorMsg : "&c [CheckNameHistory] : Some error occured."
      NoPlayerMsg: "&c[CheckNameHistory] The specified player does not exist on this server."
      NoChangeMsg: "&c[CheckNameHistory] This player (&e%player%&c) has not changed his name in the past."

    TitleMsg: "=== &e[&6Name Change History for &e%player%] &r==="
    UUIDMsg: "&6UUID: &e%uuid%"
    FirstNameMsg: "&b%name%"
    NameMsg: "&b%name% changed at %date%"
    Order: descending #ascending


    Just drop CheckNameHistory.jar in the plugins folder.

    For Developers:
    You can retrieve a list of player's previous names using CheckNameHistory's public method. The oldest name will be stored at the beginning of the list and the latest name is stored at the end of the list. There are two public APIs:
    • Code (Text):
      getPreviousNames(String name, boolean forceCheck)
      : returns the list of names in a list.
    • Code (Text):
      getPreviousNamesWithDates(String name, boolean forceCheck)
      : return the map of Date/Name pair.
    If you pass
    Code (Text):
    forceCheck = true
    , this method will contact Mojang to get the name history. If you pass
    Code (Text):
    forceCheck = false
    , this method will get the name history from the local cache.

    Code (Text):

    import com.vk2gpz.checknamehistory.CheckNameHistory;
             Player player = xxxxxx;
             List<String> previousNames = CheckNameHistory.getPreviousNames(player.getName(), false);
             if (previousNames != null && previousNames.size() > 0) {
                 // do your process.
            Map<Date, String> previousNamesWithDates = CheckNameHistory.getPreviousNamesWithDates(player.getName(), false);
            if (previousNamesWithDates != null && previousNamesWithDates.size() > 0) {
                // do your process.
    It would be greatly appreciated for your donation to continue providing support for this plugin.
    Ethernet22 and phil14052 like this.

Recent Reviews

  1. Jinxed
    Version: 3.1.0
    Thank you.
    Useful tool, works powerlessly.
  2. BirminghamBoy
    Version: 3.0.0
    This plugin scares off all my players...
    I love it :3

  3. Chevels
    Version: 2.0.2
    In first, thank you for this great plugin :) I use it for several months and it is very usefull! But I've a request if it's possible:
    can you add a function to automatically display previous name(s) of a member when he connects to the server? It will be very usefull for the community because this will inform everyone when a member changes his nickname.
    The ideal would be to enable / disable this feature in the configuration.

    It would be really great if you could do this!

    ps: of course I'm willing to pay for it.
  4. jdogduffy
    Version: 1.0.8
    Great plugin - works 100%
  5. rock2ya
    Version: 1.0.8
    really helpful - another improvement would be if it would shoe the old names when someone logs onto the server
  6. James76931
    Version: 1.0.6
  7. Zeryther
    Version: 1.0.6
    Really awesome! I love it that it has an API. I was trying to code this, but didn't work. Thanks for creating this!
  8. mgone2010
    Version: 1.0.6
    Work well, thanks for the API ;)
  9. Bron
    Version: 1.0.6
    Works great!
  10. Stealth
    Version: 1.0.4
    Yet another awesome plugin!