---

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 <player> [minutes]	Grant protection to an online player	newbie.admin
/newbie remove <player>	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

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.