Overview

Awaiting approval v1.2.2

Platforms

Paper, Purpur, Folia

Minecraft

1.21 to 1.21.11 (Java 21); 26.x (Java 25)

Java

21 / 25

Required

None

Optional

PlaceholderAPI, MiniPlaceholders, LuckPerms

NewbieShield protects genuine first-time players with online-time PvP immunity and configurable Guardian Totem lives. Existing players are seeded without protection when the plugin is first installed.

Requirements #

• Paper, Purpur, or a compatible Paper fork
• Minecraft 1.21 through 1.21.11 with Java 21
• Minecraft 26.x with Java 25
• PlaceholderAPI, MiniPlaceholders, and LuckPerms are optional

Installation #

1. Stop the server.
2. Place NewbieShield.jar in the server's plugins directory.
3. Start the server once to generate the configuration and language files.
4. Configure plugins/NewbieShield/config.yml as needed.
5. Run /newbieshield doctor to verify the active storage backend.

YAML works without setup. SQLite is recommended for larger standalone servers. MySQL is intended for networks that share protection state. Use /newbieshield migrate <YAML|SQLITE|MYSQL> confirm before changing storage.type, then restart the server.

Main features #

• PvP immunity measured only while the player is online
• Optional mutual PvP blocking
• Guardian Totem lives for lethal damage from mobs, falls, lava, PvP, and other normal damage
• Vanilla Totem of Undying priority when configured
• Direct, projectile, tameable-owner, and TNT-source attribution
• First-install seeding that leaves existing players untouched
• YAML, SQLite, and MySQL storage
• Action bar, boss bar, or disabled HUD mode
• English, Turkish, German, Spanish, and French messages
• Paper and Folia scheduler compatibility
• Config validation, safe reload rejection, versioned config migration, and shutdown persistence