PumpkinMsg
PluginApache-2.0

PumpkinMsg

A high-performance, single-JAR messaging system for Velocity and Paper featuring advanced spy tools, RGB styling, and seamless PlaceholderAPI integration.

26
Downloads
0
Followers
2 months ago
Updated
📦
1
Versions

📖About PumpkinMsg

🎃 PumpkinMsg

PumpkinMsg is a high-performance, cross-platform private messaging system designed for Velocity proxies and Paper/Spigot servers. It allows you to use a single JAR file for your entire network while providing seamless communication, advanced moderation tools, and deep integration with the most popular APIs.


✨ Key Features

  • 🚀 Dual-Platform Core: A single .jar file that detects if it's running on Velocity or Paper/Spigot. No need for multiple plugins!
  • 🌍 Global & Local Messaging: Cross-server messaging for Velocity and high-speed local messaging for Paper.
  • 🧩 PlaceholderAPI Support: (Paper only) Use any %placeholder% in your message formats. Ranks, levels, and custom variables are fully supported.
  • 🎨 LuckPerms Integration: Native support for prefixes and suffixes in all platforms.
  • 🕵️ Dual Spy System:
    • SocialSpy: Monitor private conversations (/msg) between users.
    • CommandSpy: Watch player commands in real-time. Includes server-specific filtering and sensitive command masking (login/register).
  • 🛡️ Total Privacy: Includes /ignore system and /togglemsg for players who want to fly under the radar.
  • 🌈 MiniMessage Native: Use RGB, Gradients, and hover events in your config.toml.
  • 💾 Safe Persistence: All user settings (ignores, spy status) are saved in a lightweight database system.

📜 Commands & Permissions

Command Aliases Description Permission
/msg <player> <msg> /w, /tell Sends a private message. None
/reply <message> /r Replies to the last interacted player. None
/ignore <player> - Blocks or unblocks a player. None
/togglemsg /tmsg Enables/Disables your private messages. None
/socialspy /spy Toggles private chat monitoring. pumpkinmsg.staff.spy
/spycommands /cmdspy Toggles command monitoring. pumpkinmsg.staff.cmdspy
/pumpkinreload - Reloads the configuration. pumpkinmsg.admin.reload

🛠️ Configuration (config.toml)

Customize your styles using MiniMessage and Placeholders. The system is safe against "Placeholder Injection" (players cannot trigger placeholders in their chat).

[format]
# You -> Target (Supports PAPI on Paper)
sender = "<#ABB2BF>[<#FF9500>You <#5C6370>-> <#61AFEF><target><#ABB2BF>] <white><message>"

# Recipient Format (Example with rank placeholder)
receiver = "<#ABB2BF>[%luckperms_prefix% <#61AFEF><sender> <#5C6370>-> <#FF9500>You<#ABB2BF>] <white><message>"

# Staff Spy Format
spy = "<#C678DD>[Spy] <sender_prefix><#61AFEF><sender> <#5C6370>-> <target_prefix><#61AFEF><target><#5C6370>: <#D19A66><message>"

📦 Installation

For Velocity Networks:

  1. Place PumpkinMsg.jar in your Velocity plugins folder.
  2. Ensure LuckPerms (Velocity version) is installed for prefix support.
  3. Restart your proxy.

For Paper/Spigot Servers:

  1. Place the same PumpkinMsg.jar in your server's plugins folder.
  2. (Optional) Install PlaceholderAPI to enable custom variables in formats.
  3. Restart your server.

Made with 🎃 by the Pumpkingz.