> ## Documentation Index
> Fetch the complete documentation index at: https://pumpkings.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PumpkinAnnouncer: Scheduled Announcements for Minecraft

> PumpkinAnnouncer delivers cross-platform automated announcements with animated gradients, multi-channel delivery, and a single JAR for Paper and Velocity.

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

<CardGroup cols={2}>
  <Card title="Cross-Platform, One File" icon="box">
    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.
  </Card>

  <Card title="Shuffled Queue" icon="shuffle">
    Announcements play in random order. Once every announcement has been shown, the queue reshuffles — your players see variety every cycle without repetition.
  </Card>

  <Card title="Configurable Cooldown" icon="clock">
    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.
  </Card>

  <Card title="Multiple Delivery Channels" icon="tower-broadcast">
    Each announcement can simultaneously deliver a **Chat** message, **ActionBar** overlay, **BossBar**, **Title/Subtitle**, and a **Sound** effect — mix and match per announcement.
  </Card>

  <Card title="Animated Gradient Text" icon="palette">
    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.
  </Card>

  <Card title="Per-World & Per-Server Filtering" icon="filter">
    On Paper, target specific worlds with the `worlds` key. On Velocity, target specific backend servers with the `servers` key. Use `"global"` to broadcast everywhere.
  </Card>

  <Card title="PlaceholderAPI Support" icon="brackets-curly">
    Any `%placeholder%` token in your text fields resolves per-player when PlaceholderAPI is installed on Paper, letting you personalise every announcement.
  </Card>

  <Card title="Automatic Update Checker" icon="arrow-up-to-line">
    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.
  </Card>
</CardGroup>

## Version

This documentation covers **PumpkinAnnouncer v2.4**.