AdminNotes allows admins to keep notes on players.


  • Create notes on players.
  • List and search notes by player, writer or keyword.
  • Toggle notify flag on individual notes to notify admins upon player's login.
  • Auto notes, automatically write notes upon commands used (mute, kick, ban, ect).


  • Java 6+


  • MySQL
  • A permissions plugin.


  • Add the AdminNotes.jar to your server.
  • Start the server.
  • Add AdminNotes' permissions to your permission plugin.
  • Enjoy


  • /notes: List commands.
  • /notes create: Create a note.
  • /notes list: List all notes.
  • /notes info: Show writer, date and notify info on a note.
  • /notes notify: Toggle notify flag, when that player logs in admins are notified of the note.
  • /notes search: Search notes. p:playerName, w:writerName, k:keyword
  • /notes remove: Remove a note.


  • adminnotes.mod: Grants the following permissions
    • adminnotes.list: List notes
    • adminnotes.create-notified: Receive notification upon a note creation.
    • Get info on a note.
    • adminnotes.login-notified: Receive notification upon noted player login.
    • Search notes.
  • adminnotes.admin
    • adminnotes.mod: Receive the mod permissions.
    • adminnotes.create: Create a note.
    • adminnotes.remove: Remove a note.
    • adminnotes.notify: Toggle notify flag on a note.
  • adminnotes.autonote.*: Grant all autonotes listed in the auto-notes.yml file.
    • Grant permission to the xyz auto note.



  • properties
    • chat-prefix: Chat prefix
    • db-type: SQLite or MYSQL
    • permission-default: Permission default setting. op/not op/true/false.
    • notify-by-default: Set notes to notify on login by default.
    • notes-per-page: How many notes per page to show in the list command.
    • date-format: Date format.
    • check-new-version: Check for a new version on startup.
    • async-db-queries: Run database queries in a separate thread, reduces lag when accessing the DB.
    • confirm-player-joined: Confirm a player has been on your server before creating note (in case of typos)
    • auto-note-permission: Require a permission node to create auto notes.
    • use-metrics: Tell that you're running the plugin, helps the developer know how popular it is.
  • mysql: typical mysql login info.


  • commands: Watch for these commands to be used.
    • title (needs to be unique)
      • regex: Regex string to locate in commands used.
      • note: Note string to be created, $number is the order number the regex was looking for. <commander> and <location> replaced with player issuing the command and their location.
      • player: The order number of the player name to create a note on.
      • notify: (Optional) force notify flag on this note, if missing falls back to notify-by-default setting.



This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to

  • A unique identifier
  • The server's version of Java
  • Whether the server is in offline or online mode
  • The plugin's version
  • The server's version
  • The OS version/name and architecture
  • The core count for the CPU
  • The number of players online
  • The Metrics version

Read more here. This functionality can be disabled in the NPR config file.

To do

  • Localize strings

Source code's available here.
Bitcoin donate.

Have an issue or suggestion? Post a ticket.

About This Project



Recent Files