SMPGracePeriod - Grace Period Plugin for Paper

A lightweight Paper plugin that disables PvP for a configurable duration. Perfect for SMP servers wanting a safe startup period or PvP-free events.

What It Does

• Disables PvP: Blocks all player-to-player damage during grace period
• BossBar Display: Shows remaining time with animated progress bar
• Milestone Alerts: Title notifications at 1m, 2m, 5m, 10m, 30m, 60m remaining
• Final Countdown: Displays 10-second countdown with sound effects
• Pause/Resume: Freeze countdown during events or announcements
• Persistence: Automatically resumes after server restart
• Flexible Duration: Supports formats like 5m, 2h, 1d, 300s

Quick Start

/smpg start        - Begin grace period
/smpg stop         - End immediately
/smpg pause        - Freeze countdown
/smpg resume       - Resume countdown
/smpg status       - Check current state

Permission: smpgraceperiod.admin (OP by default)

Configuration

Edit config.yml to customize:

grace-period:
  duration: 5m

bossbar:
  color: PURPLE
  style: SEGMENTED_20

sounds:
  milestone: "block.note_block.bell"
  countdown: "block.note_block.hat"
  final: "entity.player.levelup"

Messages use MiniMessage format for colors and styling.

Installation

1. Download plugin JAR
2. Place in plugins/ folder
3. Start/restart server
4. Edit config.yml in plugins/SMPGracePeriod/
5. Restart server

Use /smpg start to begin.