Description: A lightweight, feature-rich staff note-taking system for Paper/Spigot servers. StaffNotes allows you to attach timestamped notes to players, flag them for join-time awareness, and export notes for ban appeals or records.
Features
Simple Note Management - Add, view, and remove timestamped notes for any player
Player Flagging - Flag players with reasons for join-time staff alerts
Pinned Notes - Mark important notes that appear in summaries
Tags - Organize notes with custom tags
Join Alerts - Automatic notifications when flagged players join
Export Functionality - Export player notes to text or markdown files
API Integration - Full service API and custom Bukkit events (found here)
Configurable Messages - Customize all plugin messages via YAML
YAML Storage - Simple, readable data files
Lightweight - Minimal overhead with efficient caching
Beautiful UI - Clean color scheme with aqua, red, and yellow accents
Tab Completion - Full command and player name tab completion
Offline Support - Work with offline players seamlessly
Commands
/note add <player> <text> [--pinned] [--tags=tag1,tag2] - Add a note to a player
/note list <player> - List all notes for a player
/note get <player> <id> - View full details of a specific
/note remove <player> <id> - Remove a note from a player
/note flag <player> <reason> - Flag a player for join alerts
/note unflag <player> - Remove flag from a player
/note export <player> [--format=txt\|md] - Export a player's notes to file
/note help - Show help information
/notes - Alias for /note
Permissions
staffnotes.* - Grants all StaffNotes permissions
staffnotes.use - Add notes to players
staffnotes.view - View notes and receive join alerts
staffnotes.manage - Remove notes and flag/unflag players
staffnotes.export - Export player notes to files
Color Scheme
StaffNotes uses a beautiful color scheme by default:
Aqua (`&b`) - Primary color for information
Red (`&c`) - Warnings and flagged players
Yellow (`&e`) - Important highlights and pinned notes
All colors and messages are customizable through messages.yml.
Installation:
Download StaffNotes-1.0.0.jar
Place it in your server's plugins/ folder
Restart your server
Configuration files will be created automatically on first run
Set up permissions for your staff
Requirements:
Server: Paper 1.20+ (works on Spigot with reduced features)
Java: 17 or higher
Disk Space: Minimal (text files only)
Tips and Tricks:
Use `--pinned` for notes that should always be visible to staff
Use tags like `warning`, `positive`, `behavior` for easy categorization
Export notes before major moderation decisions for your records
Keep pinned notes concise - they appear in join alerts
Flag frequently problematic players for instant staff awareness
Troubleshooting: Notes not saving after restart?
Ensure the server has write permissions to plugins/StaffNotes/
Check server logs for any error messages
Verify you're using the latest version
Join alerts not appearing?
Make sure join-alert.enabled is true in config.yml
Verify staff have the staffnotes.view permission
Player must be flagged with a reason (check usage syntax with /note help)
Command not working?
Check your permissions using /lpp user <name> info (for LuckPerms; if you are using another plugin for permissions then check them using that plugin's features)
Ensure the player name/UUID is correct
Try /note help for command syntax
Support:
Issues or Questions - Report bugs using the discussions page on this resource
Requesting Changes - Please also use the discussions page on this resource to request changes
Updates - Check the resource page for the latest version
Disclaimer: You do not have permission to decompile, edit, or distribute this resource. Changes can be requested through the discussions page.