The definitive solution for New Player Protection and Death Cooldowns, complete with Advanced Discord Kill Logging and 'Naked Kill' Tracking.
[HR][/HR]
✅ Features
- Grace Period on Death: Automatically grants temporary PvP protection (configurable duration) to players after they are killed, preventing spawn camping.
- New Player Protection: Automatically grants a grace period to players on their very first join (or every join, configurable).
- BossBar Timer: Displays the remaining grace time clearly using a customizable BossBar.
- Manual End Command: Players can voluntarily end their grace period at any time using /endgrace to jump back into action.
- Advanced Discord Kill Logs (Webhooks): Sends detailed logs of every PvP kill to a configured Discord channel, including:
- Killer and Victim Names
- Weapon Used
- Full list of Dropped Items
- Killer's Inventory contents
- Exact Kill Location (World & Coordinates)
- Killer's "Naked Kill" Count (See below)
- Naked Kill Tracking (SQLite): Tracks and increments a killer's count every time they kill a player who has no armor and no item in either hand. This statistic is displayed in the Discord Kill Log.
- SQLite Database: Uses a local database for persistent tracking of player stats (Naked Kills).
[HR][/HR]
⚙️ Commands & Permissions
Commands:
Code (Text):
/endgrace - Manually removes the active grace period from the player.
/pvpreload - Reloads the plugin configuration.
Code (Text):
# Required to use the reload command
pvpgrace.reload:
description: Allows a user to reload the plugin configuration.
default: op
️ Configuration (config.yml)
The plugin is highly configurable. Below is the default configuration:
Code (Text):
# Discord Webhook Configuration
discord:
# Paste your Discord webhook URL here. Keep empty ("") to disable.
webhook-url: "YOUR_WEBHOOK_URL_HERE"
# Grace Period Settings
grace-period:
# Duration for new players (in seconds)
new-player-duration: 600
# Duration after being killed (in seconds)
death-duration: 600
# Grant grace period on every join (not just first join)
always-on-join: false
# BossBar settings
# Available Colors: GREEN, YELLOW, RED, BLUE, PINK, PURPLE, WHITE
bossbar-color: GREEN
# The format string for the BossBar title (%d is minutes, %02d is seconds)
bossbar-format: "§aGrace Period: §f%d:%02d"
# Messages (Supports Color Codes)
messages:
grace-activated: "§aYou have been granted grace period! Use /endgrace to end it early."
grace-expired: "§cYour grace period has expired!"
grace-ended: "§aYour grace period has been ended. You can now engage in PvP!"
no-grace: "§cYou don't have an active grace period!"
new-player-grace: "§aWelcome! You have PvP protection for 10 minutes. Use /endgrace to end it early."
target-protected: "§cThis player is under grace period protection!"
attacker-protected: "§cYou cannot attack while under grace period! Use /endgrace first."
⚠️ Important Notes
- Database: This plugin automatically creates an SQLite file named pvpstats.db in your plugin folder. No external setup is required.
- Dependencies: Requires no external dependencies, running on standard Bukkit/Paper/Spigot 1.21+ APIs.
Enjoy a more balanced PvP experience!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
PvPGrace is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 75 times (via Spigot). Download it and open it directly in the game.