PlayerNotes is a simple staff tool for Minecraft servers that lets moderators record and check notes on players. Notes help staff keep track of warnings, behavior, and context over time, even when players are offline. The plugin includes commands to add, list, view, remove, and clear notes, along with full permission control. It supports both flat file storage for small servers and MySQL for bigger setups. Messages can be customized, MiniMessage formatting is supported, and PlaceholderAPI can show note info in chat or menus. Everything runs async to keep the server smooth, and the layout is clean so staff can use it without confusion.
Commands
Main Command: /note
Aliases: /notes, /pnote, /playernotes
Subcommands /note add <player> <note> - Add a note to a player
/note remove <player> <id> - Remove a note by ID
/note clear <player> - Clear all notes for a player
/note list <player> [page] - Show notes for a player
/note info <player> <id> - Show full info for one note
Permissions
PermissionWhat it doesDefault playernotes.add Add notes op
playernotes.remove Remove notes op
playernotes.clear Clear notes op
playernotes.list View notes op
playernotes.info View note info op
playernotes.reload Reload config op
PlaceholderAPI
Soft dependency
Placeholders PlaceholderMeaning %playernotes_count% Total notes for player
%playernotes_has_notes% true or false
%playernotes_latest_text% Latest note text
%playernotes_latest_actor% Who wrote latest note
%playernotes_latest_date% When latest note was added
%playernotes_latest_id% Latest note ID
%playernotes_oldest_text% Oldest note text
%playernotes_oldest_actor% Who wrote oldest note
%playernotes_oldest_date% When oldest note was added
%playernotes_note_<id>_text% Text of a note by ID
%playernotes_note_<id>_actor% Actor of that note
Message System
MiniMessage Support
Colors (names and hex)
Gradients
Rainbow text
Bold, italic, underline, strike, obfuscated
Hover and click events
Message placeholders PlaceholderMeaning {prefix} Plugin prefix
{player} Target player
{actor} Staff name
{note} Note text
{id} Note ID
{timestamp} When note was made
{page} Page number
{total_pages} Number of pages
{count} Total notes
{notes} Formatted notes list
Storage Options
Flat File
YAML
Folder per UUID
Good for small servers
MySQL
Works across network
Uses HikariCP
Async
Files
config.yml
Code (YAML):
storage: # Type of storage: "mysql" or "flatfile" type: flatfile
# MySQL settings (only used if type is mysql) mysql:
host: localhost
port: 3306
database: minecraft
username: root
password: password
# Optional connection parameters params: "?useSSL=false&autoReconnect=true"
# Flat file settings (only used if type is flatfile) flatfile: # Folder name under the plugin data folder folder: playerdata
# Display settings display: # Number of notes per page in /note list page-size: 10
# Date format for displaying timestamps # Available formats: ISO (2024-01-15T14:30:00), LOCAL (01/15/2024 02:30 PM), SIMPLE (2024-01-15 14:30) date-format: SIMPLE
# Validation settings validation: # Maximum length for note text max-text-length: 512
# Strip color codes from note text strip-colors: true
# Maximum number of players to cache cache-size: 50
messages.yml
Code (YAML):
[SIZE=6
][B
]PlayerNotes Messages Configuration
[/B
] [B
]All messages support MiniMessage formatting
[/B
][/SIZE
] # PlayerNotes Messages Configuration # All messages support MiniMessage formatting: https://docs.advntr.dev/minimessage/format.html # Placeholders: # {player} - Target player name # {uuid} - Target player UUID # {actor} - The person executing the action # {id} - Note ID # {count} - Number of notes # {page} - Current page number # {total_pages} - Total number of pages # {timestamp} - Formatted timestamp # {text} - Note text # {max_length} - Maximum text length
# General messages no-permission: "<red>You don't have permission to use this command." player-not-found: "<red>Player '<yellow>{player}</yellow>' not found." player-never-joined: "<red>Player '<yellow>{player}</yellow>' has never joined this server." invalid-number: "<red>Invalid number provided." storage-error: "<red>Failed to perform operation. Please try again later."
# Add command messages add:
usage: "<red>Usage: /note add <player> <text>" text-empty: "<red>Note text cannot be empty." text-too-long: "<red>Note text is too long. Maximum length is <yellow>{max_length}</yellow> characters." success: "<green>Note added to <yellow>{player}</yellow>."
# List command messages list:
usage: "<red>Usage: /note list <player> [page]" invalid-page: "<red>Invalid page number." no-self-permission: "<red>You don't have permission to view your own notes." empty: "<yellow>{player}</yellow> <gray>has no notes." header: "<gold><bold>=== Notes for {player} ===" uuid-line: "<gray>UUID: <white>{uuid}" total-line: "<gray>Total Notes: <white>{count} <gray>| <gray>Page: <white>{page}/{total_pages}" entry: "<yellow>[#{id}] <gray>{timestamp} <white>{actor}<gray>: <white>{text}" next-page: "<gray>Use <yellow>/note list {player} {page}</yellow> <gray>for the next page."
# Remove command messages remove:
usage: "<red>Usage: /note remove <player> <id>" invalid-id: "<red>Invalid note ID." success: "<green>Note <yellow>#{id}</yellow> removed from <yellow>{player}</yellow>." not-found: "<red>Note <yellow>#{id}</yellow> does not exist for <yellow>{player}</yellow>."
# Clear command messages clear:
usage: "<red>Usage: /note clear <player> confirm" confirm-prompt: "<red>Are you sure you want to clear all notes for <yellow>{player}</yellow>?" confirm-instruction: "<red>Use <yellow>/note clear {player} confirm</yellow> to proceed." success: "<green>Cleared <yellow>{count}</yellow> note(s) from <yellow>{player}</yellow>." empty: "<yellow>{player}</yellow> <gray>has no notes to clear."
# Info command messages info:
usage: "<red>Usage: /note info <player>" no-self-permission: "<red>You don't have permission to view your own notes." header: "<gold><bold>=== Note Info for {player} ===" uuid-line: "<gray>UUID: <white>{uuid}" total-line: "<gray>Total Notes: <white>{count}" latest-header: "<gray>Latest Note:" latest-entry: "<yellow>[#{id}] <gray>{timestamp} <white>{actor}<gray>: <white>{text}" view-all: "<gray>Use <yellow>/note list {player}</yellow> to view all notes."
# Help command messages help:
header: "<gold><bold>=== PlayerNotes Commands ===" entry: "<yellow>/note {usage} <gray>- <white>{description}" unknown-subcommand: "<red>Unknown subcommand. Use <yellow>/note</yellow> for a list of commands."