SendMSG

!(https://cdn.modrinth.com/data/cached_images/7c481d017b2c4c1846c0a862cfa441a50e234fec.png)

# SendMSG – Private Messaging for Your Server

!(https://cdn.modrinth.com/data/cached_images/edf22ab454799fefa352b0527e53f9094d0b201c_0.webp) !(https://cdn.modrinth.com/data/cached_images/3951022f95b2b7dd5eaf66130cc850a742b251ca.png) !(https://cdn.modrinth.com/data/cached_images/4ff6f48632c3fc07ba32165622ec6677c699476f_0.webp)

Lightweight, multilingual, fully customizable private messaging plugin for Spigot/Paper 1. 21+ - 26. 1+

## ✨ Features

| Feature | Description | |---------|-------------| | 📨 5 sending commands | `/msg`, `/m`, `/tell`, `/w`, `/pm` | | 💬 Quick reply | `/r` or `/reply` – reply to the last sender | | 🌍 3 languages | English, Ukrainian, Russian (change with `/sendmsg lang`) | | 🛡️ Anti-spam | Configurable delay with bypass permission | | 🔔 Sound alerts | Customizable sounds for sending and receiving | | 📢 Subtitles | Popup notification when receiving a message | | 🔕 Block PMs | `/msgtoggle` – disable incoming private messages | | 👁️ SocialSpy | `/spy` – see all private messages | | 🚫 Ignore system | `/ignore` – ignore/unignore players | | ⏰ Auto-expire ignores | Ignore players with auto-removal after N days | | 📁 Message logging | All PMs saved to `logs/private.log` | | 💾 Ignore saving | Ignores stored in `ignores.yml` | | 🧹 Auto cleanup | Automatic cleanup task every hour | | 🔔 Update notifications | Checks Modrinth on startup, notifies ops when a new version is available | | 🎨 Fully customizable | All messages in `messages/*.yml` + color codes | | 🔧 Lightweight | No external dependencies required | | ⚡ EssentialsX compatible | Overrides EssentialsX private messages |

## 🎮 How it looks in-game

When you send a message: ```text ✉ You -> Player: Hello! ```

When you receive a message: - 📺 Subtitle: `✉ You have a message` - 💬 Chat: `✉ Player writes you: Hello!` - 💬 Reply hint: `→ Reply with: /r (text)` - 🔊 Sound: `ENTITY_EXPERIENCE_ORB_PICKUP`

> ⚠️ All text, sounds, subtitles, and colors can be changed in the configuration files.

## 📋 Commands

| Command | Description | Aliases | |---------|-------------|---------| | `/msg ` | Send a private message | `/m`, `/w`, `/tell`, `/pm` | | `/r ` | Reply to the last sender | `/reply` | | `/ignore ` | Ignore/unignore a player (toggle) | `/ig` | | `/msgtoggle` | Disable/enable incoming private messages | – | | `/spy` | Toggle SocialSpy (see all PMs) | – | | `/sendmsg lang ` | Change plugin language | `EN`, `UA`, `RU` | | `/sendmsg reload` | Reload configuration | – | | `/sendmsg help` | Show help | – |

Language codes: `EN` (English), `UA` (Ukrainian), `RU` (Russian)

## 🔐 Permissions

| Permission | Description | Default | |------------|-------------|---------| | `sendmsg.msg` | Allows using `/msg` and `/m` | ✅ `true` | | `sendmsg.reply` | Allows using `/r` and `/reply` | ✅ `true` | | `sendmsg.ignore` | Allows using `/ignore` | ✅ `true` | | `sendmsg.msgtoggle` | Allows using `/msgtoggle` | ✅ `true` | | `sendmsg.bypass.cooldown` | Bypass the message cooldown | 👑 `op` | | `sendmsg.spy` | Allows using `/spy` (SocialSpy) | 👑 `op` | | `sendmsg.admin` | Access to `/sendmsg lang` and `/sendmsg reload` | 👑 `op` |

## ⚙️ Configuration (`config.yml`)

```yaml # Plugin language: ru-RU, uk-UA, en-EN lang: en-EN

# Delay between messages (seconds) cooldown-seconds: 10 ```

# Enable / disable features

```yaml features: subtitle: true # Show subtitle when receiving a message subtitle-reply: true # Separate subtitle for replies sound-receive: true # Play sound when receiving a message sound-send: true # Play sound when sending a message reply-hint: true # Show "/r" hint below incoming messages cooldown: true # Enable message cooldown msg-toggle: true # Enable /msgtoggle command social-spy: true # Enable /spy command log-to-file: true # Save all PMs to logs/private.log ```

# Sound settings

```yaml sound: receive: name: ENTITY_EXPERIENCE_ORB_PICKUP volume: 1. 0 pitch: 1. 2 send: name: ENTITY_VILLAGER_WORK_CARTOGRAPHER volume: 1. 0 pitch: 1. 0

# Ignore settings ignore: # Auto-remove ignore after N days (0 = forever) auto-expire-days: 7 ```

# Update checker

```yaml update-checker: enabled: true # check Modrinth on startup for new versions notify-ops-on-join: true # notify ops in chat when they join, if an update exists ```

📝 Message formats (`messages/en-EN.yml`)

```yaml format: incoming: "&2✉ &f&l{from} &7writes you: &f{message}" reply-hint: "&2→ &7Reply with: &b&n/r (text)" outgoing: "&2✉ &7&lYou &7-> &f&l{to}&7: &f{message}" spy: "&8 &7{from} -> {to}: {message}" console-name: "Console"

subtitle: "&2✉ &7You have a message" subtitle-repl