Skip to main content

Documentation Index

Fetch the complete documentation index at: https://pumpkings.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

PumpkinMsg is a high-performance private messaging plugin built for Minecraft networks. A single JAR file auto-detects whether it is running on a Paper server or a Velocity proxy, so you never need to manage separate builds for different parts of your infrastructure. It ships with rich MiniMessage formatting, deep LuckPerms integration, and a dual spy system that gives your moderation team full visibility into player conversations and commands.

Key Features

Private Messaging

Players use /msg and /reply to start private conversations across your entire network. Tab-completion suggests online player names in real time.

Ignore System

/ignore lets any player block messages from a specific user. Toggling the command a second time removes the block.

Toggle Messages

/togglemsg lets players disable all incoming private messages in one step — useful for streamers or busy staff.

SocialSpy

Staff members with the right permission can watch every private conversation on the network, or narrow the feed to a single player.

Command Spy

CmdSpy surfaces the commands players run, with optional per-server filtering and automatic masking of sensitive commands like /login.

LuckPerms Prefixes

The spy format automatically pulls each player’s LuckPerms prefix, so moderators see rank information alongside every intercepted message.

PlaceholderAPI

On Paper servers, any PlaceholderAPI placeholder is valid inside format strings, letting you embed ranks, levels, or custom variables.

MiniMessage Formatting

Every format string supports the full MiniMessage spec — hex colors, RGB gradients, hover events, and click actions.

Platform Support

PumpkinMsg 1.3 targets Paper 1.20+ and Velocity. The same JAR works on both platforms; the plugin detects its environment at startup and loads the correct adapter automatically.
Java 17 or newer is required on all platforms. The plugin stores all user data in lightweight flat files inside the plugin data folder — no database setup is needed.

Injection Safety

Player-provided message text is treated as a plain-text literal — not as a raw MiniMessage string. This means players cannot inject color codes, gradients, or click events into their messages, regardless of what they type.