![new](https://cdn.modrinth.com/data/cached_images/217daf937730dcf49d85e3b72f38514fa7c6e76c.jpeg)

# 🛡️ NewbieGuard ### Temporary PvP protection for new players, built for Folia. `Folia` · `Java 21+` · `Adventure boss bar`

--- New players get a head start: a configurable protection window the moment they first join, with a live boss bar counting down the time left. The countdown pauses while they're offline, and protection drops automatically the moment they throw the first punch. Built specifically for **Folia** — it uses the region and entity schedulers throughout and never touches the legacy `BukkitScheduler`.
## ✨ Features - 🧍 **First-join protection** — new players are shielded for a configurable duration (default **60 minutes**). - 📊 **Live boss bar** — counts down every second and shifts colour as time runs low: 🟢 green → 🟡 yellow → 🔴 red. - ⏸️ **Offline-safe** — the timer only ticks while the player is online; time offline is never deducted. - 🚫 **PvP shield** — incoming attacks on a protected player are cancelled, and the attacker gets a short, spam-protected notice. - ⚔️ **Fair play** — if a protected player strikes someone first, their own protection is removed (configurable). - 🔑 **Staff bypass** — `newbie.bypass` lets staff hit protected players for testing. - 🛠️ **Manual control** — grant or remove protection at any time with commands. - 👥 **New players only** — returning players are never protected.
## 💬 Commands | Command | Description | Permission | |---|---|---| | `/newbie check [player]` | Show remaining protection time | `newbie.check` (self) · `newbie.admin` (others) | | `/newbie grant [minutes]` | Grant protection to an online player | `newbie.admin` | | `/newbie remove ` | Remove a player's protection | `newbie.admin` |
## 🔐 Permissions | Permission | Description | Default | |---|---|---| | `newbie.bypass` | Attack protected players | `op` | | `newbie.check` | Check your own remaining time | everyone | | `newbie.admin` | Grant / remove protection, check others | `op` |
## ⚙️ Configuration ```yaml protection-duration-minutes: 60 remove-on-attack: true bypass-permission: "newbie.bypass" bossbar: green-threshold-minutes: 10 yellow-threshold-minutes: 5 messages: protection-start: "&aYou are protected from PvP for {duration} minutes" protection-expired: "&eYour PvP protection has expired" protection-removed-attack: "&cYou attacked another player — your protection has been removed" blocked-attack: "&cThis player is still under new-player protection and cannot be attacked" bossbar-format: "New Player PvP Protection — Time left {time}" ``` > 💡 The boss bar supports `{time}`, `{minutes}` and `{seconds}` placeholders. > Chat messages support legacy `&` colour codes.
## 📦 Requirements | | | |---|---| | **Server** | Folia | | **Java** | 21 or newer |
## 📝 Notes - Protection is stored in each player's persistent data, so it **survives restarts and rejoins**. - Players who joined **before** the plugin was installed are not protected — use `/newbie grant` to protect them manually.

--- *Lightweight, no dependencies, and Folia-native.*

sainfu9