aNewbie - New player protection, done right.
Give newcomers a safe start without breaking your server's gameplay balance.
MySQL • SQLite • YAML | Folia • Paper • Spigot | PlaceholderAPI | WorldGuard | 1.17 - 26.1
What does it do?
aNewbie protects new players when they first join your server.
You can use a classic timer-based system, or block-based protection where protection ends after the player breaks a configured amount of blocks. This works well for survival servers that want new players to be safe, while still allowing protection to end naturally as they start progressing.
Time-based protection can also pause while a player is AFK, so protection time is not wasted while the player is inactive. Protection progress can be displayed through action bars, titles, particles, and a fully configurable boss bar.
Protected players can be prevented from attacking, being attacked, using certain commands, chatting, picking up items, or entering restricted worlds and WorldGuard regions. You decide what gets blocked and how strict the protection should be.
Features
Time-Based Protection - Give new players protection for a fixed duration like 30m, 1h, or 2d.
Block-Based Protection - End protection after the player breaks a configured number of blocks.
AFK Protection Pause - Pause time-based protection while players are AFK, with optional title reminders and configurable AFK sound playback.
PvP & PvE Control - Block protected players from dealing or receiving damage from players and mobs.
World & Region Restrictions - Stop protected players from entering selected worlds or WorldGuard regions.
Action Bar, Boss Bar & Titles - Show remaining time, block progress, or protection status with configurable action bar, boss bar, and title displays.
Custom Restriction Feedback - Show different title, subtitle, sound, and message feedback for blocked actions.
Particle Effects - Optional visual aura around protected players, with configurable effect type and refresh rate.
Group Durations - Give VIP, Premium, or other groups extra protection time through permissions.
Command Blocking - Block commands such as /tpa, /spawn, /warp, or any command you configure.
Command Spy - Let staff monitor blocked newbie commands, with exclusions for sensitive commands.
Item Pickup & Chat Blocking - Optionally block pickup and chat while protection is active.
Disable Confirmation - Players can be required to confirm before disabling their own protection.
Extend Protection Command - Extend an already protected player's time-based or block-based protection without resetting their whole protection state.
Localized Commands - Configure command names, aliases, usage text, and locale-specific subcommands.
Safe Config Updating - Merge missing config, command, database, and language keys without replacing the whole file.
Multiple Storage Types - Store player data in YAML, SQLite, or MySQL.
PlaceholderAPI Support - Use protection status, remaining time, and block progress in other plugins.
Developer API - Integrate aNewbie into your own plugins through the public API.
Protection Modes
TIME_BASED
Protection ends when the timer reaches zero. This is the classic newbie-protection setup.
Time-based protection can pause while the player is AFK. Once they become active again, the protection timer continues from where it stopped.
BLOCK_BASED
Protection ends when the player reaches the configured block break limit. This is useful if you want protection to end based on early-game progress instead of only time.
Block-based protection does not need AFK pausing, because it only progresses when blocks are broken.
Commands
All commands use /anewbie. Aliases: /newbie, /new, /koruma, /protection, /p, /k
/anewbie help - Show the help menu
/anewbie disable - Disable your own protection
/anewbie disableplayer <player> - Disable another player's protection
/anewbie info - View plugin and protection information
/anewbie check <player> - Check another player's protection status
/anewbie give <player> <duration> - Give time-based protection
/anewbie give <player> - Give block-based protection when BLOCK_BASED mode is active
/anewbie extend <player> <duration> - Extend a player's time-based protection
/anewbie extend <player> <blocks> - Extend a player's block-based protection
/anewbie list - List players with protection data
/anewbie spy - Toggle command spy mode
/anewbie reload - Reload plugin files
Permissions
anewbie.use - Use the main command | default: everyone
anewbie.help - Use the help command | default: everyone
anewbie.disable - Disable your own protection | default: everyone
anewbie.info - View plugin/protection info | default: everyone
anewbie.disableplayer - Disable another player's protection | default: OP
anewbie.check - Check another player's protection | default: OP
anewbie.give - Give protection to a player | default: OP
anewbie.extend - Extend a player's protection | default: OP
anewbie.list - List protected players | default: OP
anewbie.command.spy - Use command spy | default: OP
anewbie.reload - Reload the plugin | default: OP
Placeholders requires PlaceholderAPI
%anewbie_remaining_protection_time% - Remaining protection time, or active block-mode text
%anewbie_protection_is_active% - Whether the player has active protection
%anewbie_blocks_broken% - Blocks broken by the player
%anewbie_blocks_needed% - Total blocks needed to end block-based protection
%anewbie_blocks_remaining% - Blocks still needed
%anewbie_block_progress% - Block progress in broken/needed format
%anewbie_protection_type% - Current protection type
Database
Choose your storage backend in database.yml.
YAML - Simple file storage. Good for small servers and testing.
SQLite - Local database storage. No external database server needed.
MySQL - Remote database support with HikariCP pooling. Best for larger servers and networks.
Installation
1. Put aNewbie.jar into your plugins/ folder.
2. Restart or start the server.
3. Edit config.yml, commands.yml, database.yml, and language files.
4. Run /anewbie reload after configuration changes.
Optional hooks: PlaceholderAPI for placeholders and WorldGuard for region restrictions.
Found a bug or have a suggestion? Join the Discord.
If you enjoy this plugin, please leave a
rating on BuiltByBit!
/anewbie disable - Disable your own protection
/anewbie disableplayer <player> - Disable another player's protection
/anewbie info - View plugin and protection information
/anewbie check <player> - Check another player's protection status
/anewbie give <player> <duration> - Give time-based protection
/anewbie give <player> - Give block-based protection when BLOCK_BASED mode is active
/anewbie extend <player> <duration> - Extend a player's time-based protection
/anewbie extend <player> <blocks> - Extend a player's block-based protection
/anewbie list - List players with protection data
/anewbie spy - Toggle command spy mode
/anewbie reload - Reload plugin files
Permissions
anewbie.use - Use the main command | default: everyone
anewbie.help - Use the help command | default: everyone
anewbie.disable - Disable your own protection | default: everyone
anewbie.info - View plugin/protection info | default: everyone
anewbie.disableplayer - Disable another player's protection | default: OP
anewbie.check - Check another player's protection | default: OP
anewbie.give - Give protection to a player | default: OP
anewbie.extend - Extend a player's protection | default: OP
anewbie.list - List protected players | default: OP
anewbie.command.spy - Use command spy | default: OP
anewbie.reload - Reload the plugin | default: OP
Placeholders requires PlaceholderAPI
%anewbie_remaining_protection_time% - Remaining protection time, or active block-mode text
%anewbie_protection_is_active% - Whether the player has active protection
%anewbie_blocks_broken% - Blocks broken by the player
%anewbie_blocks_needed% - Total blocks needed to end block-based protection
%anewbie_blocks_remaining% - Blocks still needed
%anewbie_block_progress% - Block progress in broken/needed format
%anewbie_protection_type% - Current protection type
Database
Choose your storage backend in database.yml.
YAML - Simple file storage. Good for small servers and testing.
SQLite - Local database storage. No external database server needed.
MySQL - Remote database support with HikariCP pooling. Best for larger servers and networks.
Installation
1. Put aNewbie.jar into your plugins/ folder.
2. Restart or start the server.
3. Edit config.yml, commands.yml, database.yml, and language files.
4. Run /anewbie reload after configuration changes.
Optional hooks: PlaceholderAPI for placeholders and WorldGuard for region restrictions.
Found a bug or have a suggestion? Join the Discord.
If you enjoy this plugin, please leave a
rating on BuiltByBit!Latest reviews
- dominicdev
- Version: v1.9.2
Excellent plugin with a clean setup, useful protection features, and solid performance. The configuration is flexible, easy to understand, and works well for servers that want to protect new players without overcomplicating gameplay. Highly recommended.
mytiffy
Thank you for the review! I’m glad you found aNewbie useful and easy to configure. I really appreciate your feedback. 
