{"id":122787,"date":"2026-06-07T08:18:15","date_gmt":"2026-06-07T05:18:15","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/"},"modified":"2026-06-07T08:18:15","modified_gmt":"2026-06-07T05:18:15","slug":"playernotes","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/","title":{"rendered":"PlayerNotes"},"content":{"rendered":"

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.<\/p>\n

![Example](https:\/\/cdn.modrinth.com\/data\/cached_images\/be054af52b8940372a4bf6bc0424f75897bde90f.png)<\/p>\n

## Commands<\/p>\n

\nSpoiler<\/summary>\n

**Main Command:**
\n`\/note`
\n**Aliases:** `\/notes`, `\/pnote`, `\/playernotes`<\/p>\n

### Subcommands
\n`\/note add `
\nAdd a note to a player<\/p>\n

`\/note remove `
\n Remove a note by ID<\/p>\n

`\/note clear `
\nClear all notes for a player<\/p>\n

`\/note list [page]`
\nShow notes for a player<\/p>\n

`\/note info `
\nShow full info for one note<\/p>\n<\/details>\n

## Permissions<\/p>\n

\nSpoiler<\/summary>\n

| Permission | What it does | Default |
\n|—|—|—|
\n| `playernotes.add` | Add notes | op |
\n| `playernotes.remove` | Remove notes | op |
\n| `playernotes.clear` | Clear notes | op |
\n| `playernotes.list` | View notes | op |
\n| `playernotes.info` | View note info | op |
\n| `playernotes.reload` | Reload config | op |<\/p>\n<\/details>\n

## PlaceholderAPI<\/p>\n

\nSpoiler<\/summary>\n

**Soft dependency**<\/p>\n

### Placeholders
\n| Placeholder | Meaning |
\n|—|—|
\n| `%playernotes_count%` | Total notes for player |
\n| `%playernotes_has_notes%` | true or false |
\n| `%playernotes_latest_text%` | Latest note text |
\n| `%playernotes_latest_actor%` | Who wrote latest note |
\n| `%playernotes_latest_date%` | When latest note was added |
\n| `%playernotes_latest_id%` | Latest note ID |
\n| `%playernotes_oldest_text%` | Oldest note text |
\n| `%playernotes_oldest_actor%` | Who wrote oldest note |
\n| `%playernotes_oldest_date%` | When oldest note was added |
\n| `%playernotes_note__text%` | Text of a note by ID |
\n| `%playernotes_note__actor%` | Actor of that note |<\/p>\n<\/details>\n

## Message System<\/p>\n

\nSpoiler<\/summary>\n

### MiniMessage Support
\n– Colors (names and hex)
\n– Gradients
\n– Rainbow text
\n– Bold, italic, underline, strike, obfuscated
\n– Hover and click events<\/p>\n

### Message placeholders
\n| Placeholder | Meaning |
\n|—|—|
\n| `{prefix}` | Plugin prefix |
\n| `{player}` | Target player |
\n| `{actor}` | Staff name |
\n| `{note}` | Note text |
\n| `{id}` | Note ID |
\n| `{timestamp}` | When note was made |
\n| `{page}` | Page number |
\n| `{total_pages}` | Number of pages |
\n| `{count}` | Total notes |
\n| `{notes}` | Formatted notes list |<\/p>\n<\/details>\n

## Storage Options<\/p>\n

\nSpoiler<\/summary>\n

### Flat File
\n– YAML
\n– Folder per UUID
\n– Good for small servers<\/p>\n

### MySQL
\n– Works across network
\n– Uses HikariCP
\n– Async<\/p>\n<\/details>\n

## Files<\/p>\n

\nSpoiler<\/summary>\n

### config.yml<\/p>\n

\nSpoiler<\/summary>\n

“`yaml
\n# PlayerNotes Configuration<\/p>\n

# Storage configuration
\nstorage:
\n # Type of storage: “mysql” or “flatfile”
\n type: flatfile<\/p>\n

# MySQL settings (only used if type is mysql)
\n mysql:
\n host: localhost
\n port: 3306
\n database: minecraft
\n username: root
\n password: password
\n # Optional connection parameters
\n params: “?useSSL=false&autoReconnect=true”<\/p>\n

# Flat file settings (only used if type is flatfile)
\n flatfile:
\n # Folder name under the plugin data folder
\n folder: playerdata<\/p>\n

# Display settings
\ndisplay:
\n # Number of notes per page in \/note list
\n page-size: 10<\/p>\n

# Date format for displaying timestamps
\n # Available formats: ISO (2024-01-15T14:30:00), LOCAL (01\/15\/2024 02:30 PM), SIMPLE (2024-01-15 14:30)
\n date-format: SIMPLE<\/p>\n

# Validation settings
\nvalidation:
\n # Maximum length for note text
\n max-text-length: 512<\/p>\n

# Strip color codes from note text
\n strip-colors: true<\/p>\n

# Performance settings
\nperformance:
\n # Enable simple caching for recent note lists
\n enable-cache: true<\/p>\n

# Cache time-to-live in seconds
\n cache-ttl: 60<\/p>\n

# Maximum number of players to cache
\n cache-size: 50<\/p>\n

“`<\/p>\n<\/details>\n

### messages.yml<\/p>\n

\nSpoiler<\/summary>\n

“`yaml
\n# PlayerNotes Messages Configuration
\n# All messages support MiniMessage formatting: https:\/\/docs.advntr.dev\/minimessage\/format.html
\n# Placeholders:
\n# {player} – Target player name
\n# {uuid} – Target player UUID
\n# {actor} – The person executing the action
\n# {id} – Note ID
\n# {count} – Number of notes
\n# {page} – Current page number
\n# {total_pages} – Total number of pages
\n# {timestamp} – Formatted timestamp
\n# {text} – Note text
\n# {max_length} – Maximum text length<\/p>\n

# General messages
\nno-permission: “You don’t have permission to use this command.”
\nplayer-not-found: “Player ‘{player}<\/yellow>‘ not found.”
\nplayer-never-joined: “Player ‘{player}<\/yellow>‘ has never joined this server.”
\ninvalid-number: “Invalid number provided.”
\nstorage-error: “Failed to perform operation. Please try again later.”<\/p>\n

# Add command messages
\nadd:
\n usage: “Usage: \/note add ”
\n text-empty: “Note text cannot be empty.”
\n text-too-long: “Note text is too long. Maximum length is {max_length}<\/yellow> characters.”
\n success: “Note added to {player}<\/yellow>.”<\/p>\n

# List command messages
\nlist:
\n usage: “Usage: \/note list [page]”
\n invalid-page: “Invalid page number.”
\n no-self-permission: “You don’t have permission to view your own notes.”
\n empty: “{player}<\/yellow> has no notes.”
\n header: “=== Notes for {player} ===”
\n uuid-line: “UUID: {uuid}”
\n total-line: “Total Notes: {count} | Page: {page}\/{total_pages}”
\n entry: “[#{id}] {timestamp} {actor}: {text}”
\n next-page: “Use \/note list {player} {page}<\/yellow> for the next page.”<\/p>\n

# Remove command messages
\nremove:
\n usage: “Usage: \/note remove ”
\n invalid-id: “Invalid note ID.”
\n success: “Note #{id}<\/yellow> removed from {player}<\/yellow>.”
\n not-found: “Note #{id}<\/yellow> does not exist for {player}<\/yellow>.”<\/p>\n

# Clear command messages
\nclear:
\n usage: “Usage: \/note clear confirm”
\n confirm-prompt: “Are you sure you want to clear all notes for {player}<\/yellow>?”
\n confirm-instruction: “Use \/note clear {player} confirm<\/yellow> to proceed.”
\n success: “Cleared {count}<\/yellow> note(s) from {player}<\/yellow>.”
\n empty: “{player}<\/yellow> has no notes to clear.”<\/p>\n

# Info command messages
\ninfo:
\n usage: “Usage: \/note info ”
\n no-self-permission: “You don’t have permission to view your own notes.”
\n header: “=== Note Info for {player} ===”
\n uuid-line: “UUID: {uuid}”
\n total-line: “Total Notes: {count}”
\n latest-header: “Latest Note:”
\n latest-entry: “[#{id}] {timestamp} {actor}: {text}”
\n view-all: “Use \/note list {player}<\/yellow> to view all notes.”<\/p>\n

# Reload command messages
\nreload-success: “Plugin configuration and messages reloaded successfully!”<\/p>\n

# Help command messages
\nhelp:
\n header: “=== PlayerNotes Commands ===”
\n entry: “\/note {usage} – {description}”
\n unknown-subcommand: “Unknown subcommand. Use \/note<\/yellow> for a list of commands.”
\n“`<\/p>\n<\/details>\n<\/details>\n","protected":false},"excerpt":{"rendered":"

Easily allow staff to add notes to players! Cross server support (MySQL)<\/p>\n","protected":false},"featured_media":122788,"template":"","meta":{"_minecraft_slug":"playernotes","_minecraft_project_id":"km9E2s7v","_minecraft_author":"aarushbhutra25","_minecraft_license":"MIT","_minecraft_downloads":37,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playernotes.zip","_minecraft_size_bytes":830101,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:45:55.929546Z","_minecraft_date_created":"2025-11-05T07:40:56.002003Z","_minecraft_date_modified":"2025-11-05T07:03:35.993332Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playernotes","_minecraft_icon_attachment_id":122788,"_minecraft_imported_at":"2026-06-07T05:18:16+00:00","_minecraft_import_hash":"0446d51527de8f648067d6232d1b3861","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,867,92],"mod_loader":[132],"minecraft_version":[40,38,78,79,80,81,82],"class_list":["post-122787","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-21-10","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nPlayerNotes - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PlayerNotes - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Easily allow staff to add notes to players! Cross server support (MySQL)\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playernotes\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playernotes\\\/\",\"name\":\"PlayerNotes - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playernotes\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playernotes\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/playernotes-icon-1d41c8784a8066ae313af101bd5c6d5941b421ef_96.webp\",\"datePublished\":\"2026-06-07T05:18:15+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playernotes\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playernotes\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playernotes\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/playernotes-icon-1d41c8784a8066ae313af101bd5c6d5941b421ef_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/playernotes-icon-1d41c8784a8066ae313af101bd5c6d5941b421ef_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/playernotes\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"PlayerNotes\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PlayerNotes - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/","og_locale":"en_US","og_type":"article","og_title":"PlayerNotes - Minecraft","og_description":"Easily allow staff to add notes to players! Cross server support (MySQL)","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/","name":"PlayerNotes - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/playernotes-icon-1d41c8784a8066ae313af101bd5c6d5941b421ef_96.webp","datePublished":"2026-06-07T05:18:15+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/playernotes-icon-1d41c8784a8066ae313af101bd5c6d5941b421ef_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/playernotes-icon-1d41c8784a8066ae313af101bd5c6d5941b421ef_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/playernotes\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"PlayerNotes"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/122787","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/122788"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=122787"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=122787"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=122787"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=122787"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}