📋 StaffNotes

StaffNotes is a clean, lightweight, and completely standalone player notes and moderation history system designed for Minecraft server staff members. Easily track suspected rule breakers, keep moderation logs, and share player context among your team without external spreadsheets or bots.

✨ Key Features

• 📝 Instant Note Logging (/note add)

  • Easily record notes on any player with automatic timestamps and staff author tracking.
  • Example: /note add Notch Suspected of using X-Ray, needs check.

• 📖 In-Game GUI Journal (/notes <player>)

  • View all notes recorded for a specific player in an organized chest interface.
  • Stored as readable notes showing the Note ID, timestamp, author, and description.
  • Integrated pagination system supporting unlimited notes.

• 🗑️ Quick Right-Click Deletion

  • Moderators can delete outdated or resolved notes directly inside the GUI by simply Right-Clicking on the note.

• 🚨 Staff Join Alerts

  • When a flagged player with active notes joins the server, online staff members with permission receive a discrete chat alert with a quick reminder.

• 💾 Zero-Configuration SQLite Storage

  • Automatically stores all records in a local embedded database file (notes.db).
  • No external MySQL or database setup required.
  • Lightweight asynchronous design ensuring stable TPS.

• 🌐 Built-in Multi-Language Support

  • Ready to use out of the box in English (en) and Russian (ru).
  • All chat messages, GUI titles, and lore lines can be configured in config.yml.

💻 Commands & Permissions

• /note add <player> <text>

  • Permission: staffnotes.manage (Default: OP)
  • Description: Adds a new note for the specified player.

• /notes <player>

  • Permission: staffnotes.manage (Default: OP)
  • Description: Opens the player notes GUI journal.

• staffnotes.notify (Default: OP)

  • Permission to receive staff chat notifications when flagged players join.

📦 Requirements & Platforms

• Server Platforms: Purpur, Paper, Spigot
• Supported Versions: 1.21.x (1.21, 1.21.1+)
• Java Requirement: Java 21 or higher
• Dependencies: None! Operates 100% standalone.

⚙️ Configuration File (config.yml)

Located at: plugins/StaffNotes/config.yml

• language: Set to "en" for English or "ru" for Russian.
• All chat prefixes, alerts, and GUI texts can be customized.