SMPGracePeriod
Disable PvP during server grace period with customizable duration, BossBar countdown, commands, and inter-plugin API.
SMPGracePeriod
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
- Flexible Duration: Blocks all player-to-player damage during grace period - Flexible Duration: Shows remaining time with animated progress bar - Flexible Duration: Title notifications at 1m, 2m, 5m, 10m, 30m, 60m remaining - Flexible Duration: Displays 10-second countdown with sound effects - Flexible Duration: Freeze countdown during events or announcements - Flexible Duration: 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:
```yaml 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.