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.

!Example

Commands

Permissions

PlaceholderAPI

Message System

Storage Options

Files

# PlayerNotes Configuration

# Storage configuration
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

Performance settings

performance:

Enable simple caching for recent note lists

enable-cache: true

Cache time-to-live in seconds

cache-ttl: 60

Maximum number of players to cache

cache-size: 50

</details>

### messages.yml


<details>
<summary>Spoiler</summary>


```yaml
# 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."
  
# Reload command messages
reload-success: "<green>Plugin configuration and messages reloaded successfully!"

# 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."