StaffNotes icon

StaffNotes -----

A lightweight staff note-taking system for servers!



StaffNotes By NootherG

[​IMG] [​IMG] [​IMG]

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

  1. Simple Note Management - Add, view, and remove timestamped notes for any player
  2. Player Flagging - Flag players with reasons for join-time staff alerts
  3. Pinned Notes - Mark important notes that appear in summaries
  4. Tags - Organize notes with custom tags
  5. Join Alerts - Automatic notifications when flagged players join
  6. Export Functionality - Export player notes to text or markdown files
  7. API Integration - Full service API and custom Bukkit events (found here)
  8. Configurable Messages - Customize all plugin messages via YAML
  9. YAML Storage - Simple, readable data files
  10. Lightweight - Minimal overhead with efficient caching
  11. Beautiful UI - Clean color scheme with aqua, red, and yellow accents
  12. Tab Completion - Full command and player name tab completion
  13. Offline Support - Work with offline players seamlessly
Commands
  1. /note add <player> <text> [--pinned] [--tags=tag1,tag2] - Add a note to a player
  2. /note list <player> - List all notes for a player
  3. /note get <player> <id> - View full details of a specific
  4. /note remove <player> <id> - Remove a note from a player
  5. /note flag <player> <reason> - Flag a player for join alerts
  6. /note unflag <player> - Remove flag from a player
  7. /note export <player> [--format=txt\|md] - Export a player's notes to file
  8. /note help - Show help information
  9. /notes - Alias for /note
Permissions
  1. staffnotes.* - Grants all StaffNotes permissions
  2. staffnotes.use - Add notes to players
  3. staffnotes.view - View notes and receive join alerts
  4. staffnotes.manage - Remove notes and flag/unflag players
  5. staffnotes.export - Export player notes to files
Color Scheme

StaffNotes uses a beautiful color scheme by default:
  1. Aqua (`&b`) - Primary color for information
  2. Red (`&c`) - Warnings and flagged players
  3. Yellow (`&e`) - Important highlights and pinned notes
All colors and messages are customizable through messages.yml.

Installation:

  1. Download StaffNotes-1.0.0.jar
  2. Place it in your server's plugins/ folder
  3. Restart your server
  4. Configuration files will be created automatically on first run
  5. Set up permissions for your staff
Requirements:
  1. Server: Paper 1.20+ (works on Spigot with reduced features)
  2. Java: 17 or higher
  3. Disk Space: Minimal (text files only)
Tips and Tricks:
  1. Use `--pinned` for notes that should always be visible to staff
  2. Use tags like `warning`, `positive`, `behavior` for easy categorization
  3. Export notes before major moderation decisions for your records
  4. Keep pinned notes concise - they appear in join alerts
  5. Flag frequently problematic players for instant staff awareness
Troubleshooting:

Notes not saving after restart?

  1. Ensure the server has write permissions to plugins/StaffNotes/
  2. Check server logs for any error messages
  3. Verify you're using the latest version
Join alerts not appearing?
  1. Make sure join-alert.enabled is true in config.yml
  2. Verify staff have the staffnotes.view permission
  3. Player must be flagged with a reason (check usage syntax with /note help)
Command not working?
  1. 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)
  2. Ensure the player name/UUID is correct
  3. Try /note help for command syntax
Support:
  1. Issues or Questions - Report bugs using the discussions page on this resource
  2. Requesting Changes - Please also use the discussions page on this resource to request changes
  3. 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.
Resource Information
Author:
----------
Total Downloads: 6
First Release: Oct 28, 2025
Last Update: Oct 28, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings