MSG DonutSMP

# msgDonutSMP A highly-configurable DonutSMP-style private messaging system for Paper servers (Java 17). Features vanish-aware messaging, persistent ignore lists with GUI management, MiniMessage formatting, PlaceholderAPI placeholders, and optional bStats metrics. ## Features - Full message flow: `/msg`, `/r`, `/msgignore`, `/msgunignore`, `/msgignorelist`, `/msgreload`. - Vanish protection that checks Paper visibility and supports PlaceholderAPI vanish tags (OR gate). - Persistent ignore storage with a head-based GUI list for quick unignore actions. - MiniMessage-powered configurable message and format output. - PlaceholderAPI expansion for last partner and ignore stats. ## Commands & Permissions - `msg.use` — Use messaging and ignore commands (default: true) - `msg.bypass.vanish` — Allow messaging vanished players (default: op) - `msg.bypass.ignore` — Exempt player from being ignored (default: op) - `msg.admin` — Reload config/data and admin actions (default: op) Example commands: - `/msg <player> <message>` — Send a private message. - `/r <message>` — Reply to your last conversation partner. - `/msgignore <player>` — Add a player to your ignore list. - `/msgunignore <player>` — Remove a player from your ignore list. - `/msgignorelist` — Open ignore list GUI. - `/msgreload` — Reload `config.yml` and data (requires `msg.admin`). ## Config (high level) The plugin ships with `config.yml` exposing: - `options.allow-ignore-staff` — Whether staff can be ignored. - `placeholderapi.differentiate-vanished` — Append vanished suffix in placeholders. - `placeholderapi.vanished-suffix` — Suffix appended for vanished players. - `placeholderapi.vanish-placeholders` — PlaceholderAPI vanish tags (OR logic). - `formats.sent` / `formats.receive` — Message format templates. - `messages.*` — All user-facing text (MiniMessage-compatible). - `gui.title` — Ignore list GUI title. Use MiniMessage tags and hex colors in format/message entries. PlaceholderAPI placeholders are used when PlaceholderAPI is present. ## Notes for Server Owners - Vanish detection supports both Paper visibility and configured PlaceholderAPI tags. - Ignore data is persisted by the plugin and reloaded on startup. ## Technical - Java: 17+ - Target: Paper (1.20.2+) - Optional: PlaceholderAPI (softdepend)