ZenPings

# ZenPings **ZenPings** is a lightweight, no-nonsense Minecraft plugin for Paper servers that brings clean, customizable ping notifications to your chat. Mention players with `@Username` to grab their attention in the chaos of multiplayer chats — complete with sound alerts, highlight effects, and action bar messages. Stay noticed, stay organized, without the clutter. --- ## ✨ Features - 🔔 **Ping Alerts** – Mention players using `@Username` to play a sound and highlight their name. - 🎛️ **Toggle Support** – Players can easily enable or disable pings using `/ping` or `/ping on/off`. - ⏱️ **Anti-Spam Cooldown** – Prevent ping spam with a fully configurable cooldown timer. - 🚀 **Ultra Optimized** – Built in **Kotlin**, with performance as a core focus. - 📦 **Paper-Only** – Designed specifically for modern **Paper servers** for best compatibility and speed. --- ## 📜 Commands | Command | Description | |---------------------|--------------------------------------| | `/ping` | Toggle ping alerts on/off | | `/ping on` / `off` | Explicitly enable/disable pings | | `/ping reload` | Reload plugin configuration (admin) | --- ## 🔐 Permissions | Permission | Description | |------------------------|-------------------------------------------| | `zenpings.toggle` | Allows use of `/ping` | | `zenpings.reload` | Allows use of `/ping reload` | | `zenpings.color.vip` | Grants **gold-colored** pings | | `zenpings.color.default` | Grants **aqua/gray/custom** ping colors | --- ## ⚙️ Configuration (`config.yml`) ```yaml replacement-text: "<yellow>@<aqua>%player%</aqua>" sound: BLOCK_NOTE_BLOCK_PLING volume: 1.0 pitch: 0.8 prefix: "@" cooldown-seconds: 5 action-bar-message: "<yellow>%player% mentioned you!</yellow>" ``` ## 📬 Support Need help or have a feature suggestion? - 💬 Join the **ZenPings Discord**: (https://discord.gg/HFP5v3rZAA) - 🛠️ Open an issue on (https://github.com/luvtoxic/ZenPings/issues) We’re here to help! --- ## 🧾 License **ZenPings** is licensed under a **non-commercial license**. You are free to: - ✅ Use it on public or private servers - ✅ Modify the source code for personal or public use - ✅ Share modified versions **with credit** You may not: - ❌ Sell this plugin or its modified versions - ❌ Include it in paid products, bundles, or setups Read the full terms in (https://github.com/luvtoxic/ZenPings?tab=License-1-ov-file). --- ## 🧑‍💻 Credits > Built with ☕ and ❤️ by (https://github.com/luvtoxic) ---