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.

PumpkinAnnouncer is a single-JAR plugin that automatically detects whether it is running on a Paper server or a Velocity proxy and configures itself accordingly — no separate builds, no manual platform flags. Once installed, it schedules announcements on a configurable timer, cycling through each message in a shuffled order so your players never see the same announcement twice in a row.

Key features

Cross-Platform, One File

Drop a single JAR into either your Paper plugins/ folder or your Velocity plugins/ folder. PumpkinAnnouncer detects the platform at startup and loads the correct configuration automatically.

Shuffled Queue

Announcements play in random order. Once every announcement has been shown, the queue reshuffles — your players see variety every cycle without repetition.

Configurable Cooldown

Set a global cooldown-seconds value to control how often announcements fire. The default is 60 seconds, but you can tune it for any pace.

Multiple Delivery Channels

Each announcement can simultaneously deliver a Chat message, ActionBar overlay, BossBar, Title/Subtitle, and a Sound effect — mix and match per announcement.

Animated Gradient Text

BossBar and Title fields support smooth animated gradients. Define a list of hex colors and a frame interval, and PumpkinAnnouncer cycles through them in real time.

Per-World & Per-Server Filtering

On Paper, target specific worlds with the worlds key. On Velocity, target specific backend servers with the servers key. Use "global" to broadcast everywhere.

PlaceholderAPI Support

Any %placeholder% token in your text fields resolves per-player when PlaceholderAPI is installed on Paper, letting you personalise every announcement.

Automatic Update Checker

PumpkinAnnouncer checks Modrinth for new releases on startup. Players with the pumpkin.admin permission see a clickable in-chat notification when an update is available.

Version

This documentation covers PumpkinAnnouncer v2.4.