PlayerNotes
🟡 Updated this yearPreview
🔍 Analysis
- 🏆 #32 of 333 management mods in this game by downloads
📋 About This Mod
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.
!(https://cdn.modrinth.com/data/cached_images/be054af52b8940372a4bf6bc0424f75897bde90f.png)
## Commands
Spoiler
Main Command: `/note` Aliases: `/notes`, `/pnote`, `/playernotes`
### Subcommands
`/note add
`/note remove
`/note clear
`/note list
`/note info
## Permissions
Spoiler
| Permission | What it does | Default | |---|---|---| | `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
Spoiler
Soft dependency
### Placeholders
| Placeholder | Meaning |
|---|---|
| `%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_
## Message System
Spoiler
### MiniMessage Support - Colors (names and hex) - Gradients - Rainbow text - Bold, italic, underline, strike, obfuscated - Hover and click events
### Message placeholders | Placeholder | Meaning | |---|---| | `{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
Spoiler
### Flat File - YAML - Folder per UUID - Good for small servers
### MySQL - Works across network - Uses HikariCP - Async
Spoiler
### config.yml
Spoiler
```yaml # 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
### messages.yml
Spoiler
```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: "
📊 Mod Details
- Game
- Minecraft Plugins
- Author
- aarushbhutra25
- Version
- 1.0.0
- Downloads
- 73
- Endorsements
- 0
- Category
- management
- Created
- 11/5/2025
- Updated
- 11/5/2025
- Game Versions
- 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
- Tags
- management, social, utility
🔧 How to Install Minecraft Plugins Mods
Download from Modrinth. Use Prism Launcher or drop into your mods folder.
📖 Full step-by-step install guide for Minecraft Plugins →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Minecraft Plugins commands, item IDs, and more.
❓ Frequently Asked Questions
Which Minecraft Plugins versions does PlayerNotes support?
The author lists 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9. Other versions may work but are untested by the author.
What is the latest version of PlayerNotes?
Version 1.0.0, published 2025-11-05 with 73 downloads recorded at the source.
Keep browsing — more Minecraft Plugins mods await