⚠️ Migration Note (Important)
If you are upgrading from v1.2.4 or earlier, you must regenerate your ProShield config folder to load new settings and GUIs correctly.

Steps:

1. Stop your server.
2. Delete the /plugins/ProShield/ folder.
3. Restart the server → new configs/messages will be generated.
4. Reapply your custom changes.

This ensures Expansion Requests, World Controls GUI, and Safezone mob protection all work correctly.

✨ New Features
Expansion Requests System (Player → Admin)

• Players can now request claim expansions directly via a GUI.
• Admins review requests in the Expansion Review GUI with options to Approve or Deny (with custom reasons).
• Full Expansion History with pagination.
• Messages & deny reasons configurable via messages.yml.

World Controls GUI (Admin-Only)

• Admins can toggle global world protections in-game (fire, explosions, mob griefing, etc.).
• No need to edit YAML mid-game — changes apply instantly.
• Fully integrated with protection.world-controls.defaults in config.yml.

Safezones & Mob Control

• Claims can now be flagged as safezones.
• Hostile mobs are:
  • Repelled at borders (push-back effect).
  • Despawned inside safezones (configurable).
  • Prevented from pathing/locking onto players inside safezones.
• Controlled via protection.mobs.* in config.yml.

Fully Functional GUIs

• All menus (Player & Admin) are now fully wired and interactive:
  • Claim land, Unclaim, Claim Info, Trusted Players, Role Assignment, Claim Flags.
  • Expansion Requests, Expansion History, Admin Tools, World Controls, Deny Reasons.
• Back & Exit buttons work consistently everywhere.

Fixes & Improvements

• GUIListener overhaul → Now routes clicks safely using color-stripped titles.
• Role assignment polish → Properly assigns roles & clears pending states.
• Flags menu → Toggling now saves instantly with confirmation messages.
• Config & messages reload → /proshield reload updates config.yml + messages.yml live.
• Better deny flow → Admins can pick denial reasons from messages.yml.
• Performance tuning:
  • Reduced redundant entity checks.
  • Async-safe handling of expansion requests.
• Build stability → Fixed API mismatches in mob tasks (now compiles cleanly).

Admin Notes

• New permissions introduced:
  • proshield.admin.expansions → Access expansion review/history.
  • proshield.admin.worldcontrols → Access world-level controls GUI.
• Expansion deny reasons are stored in messages.yml under messages.deny-reasons.
• History menu supports pagination for long-term server use.

Summary
ProShield 1.2.5 is the biggest stability + features release yet:

• ✅ Expansion Requests (player-to-admin workflow).
• ✅ Safezones & advanced mob control.
• ✅ World Controls GUI for live toggling.
• ✅ Fully functional GUIs (no more placeholders).

This sets the stage for ProShield 2.0, where we’ll add Towns, Shops, Economy Integration, and Custom Roles.

Please back up your ProShield folder before upgrading!

This update focuses on admin functionality, protection improvements, and polish.
It also introduces spawn guard radius, mob repel at claim borders, and a more complete Admin GUI.

✨ New Features
Admin Enhancements

• Admin GUI Reload Button – Reload configs directly in-game (no restart needed).
• Back Button Fixes – Properly returns to previous menus (Player & Admin GUIs).
• Spawn Guard Radius – Configurable spawn.radius option prevents claiming near spawn.
• Admin Compass – OPs automatically receive the Admin Compass on join.

Player Improvements

• Trust & Transfer Expansion – More player actions added to the compass menu.
• Player GUI Back Button Fixed – No more stuck menus.
• Claim Management Polish – Smarter claim/unclaim actions.

Entity & Mob Protection

• Mob Border Repel – Hostile mobs bounce back from claim borders (configurable).
• Mob Spawn Control – Cancel natural spawns in claims (configurable), allow spawner spawns.
• Entity Protection – Improved protection for pets, item frames, and armor stands.

Fixes & Improvements

• Fixed "Entering Wilderness" spam when walking between chunks.
• Fixed admin vs. player compass logic.
• Polished GUI slot layout and descriptions.
• Improved role manager to reload correctly with config changes.
• General cleanup of listeners and constructors for consistency.

⚠️ Migration Note
Because of changes to config.yml and GUI slot mappings, you may need to:

1. Backup and delete your existing /plugins/ProShield/ folder
2. Restart your server → ProShield will regenerate the updated config.
3. Re-apply any custom settings.

This ensures all new features (spawn guard, mob repel, admin reload, etc.) are properly available.

Reminder

• Requires Spigot/Paper 1.18 → 1.21.
• Java 17+ is required.
• Always backup your ProShield folder before updating.

✨ Added

Claim Preview – Players can now preview claim borders before finalizing.

Claim Ownership Transfer – Owners can safely transfer claim ownership to another player.

Back Button in GUIs – Navigate back to the previous menu without closing the interface.

Admin Help Tooltip – Small help section added inside the Admin GUI.

Debug Logging Toggle – Easier troubleshooting with optional debug mode in config.

Improved

Polished Compass GUI layout and navigation.

Refined messages for better clarity and feedback.

More flexible claim expiry handling (preview vs. commit).

Improved role management tuning for trusted players.

Expanded item protection coverage inside claims.

Fixed

Fixed potential UI spam-click issues in menus.

Fixed player join compass logic when inventories are full.

Fixed config version headers (now correctly show 1.2.3).

General cleanup of deprecated API usage and event listeners.

✅ This update is mostly quality-of-life polish + small feature expansions.
It sets the foundation for bigger upgrades in ProShield 2.0.

Release Notes

New Features

Item Drop Protection (configurable, off by default)

Prevents dropped items inside claims from despawning.

Fully configurable with claims.keep-items (default: false) and claims.keep-items-seconds (default: 900).

Admins can toggle via the Admin GUI.

GUI Improvements

Added Help Menu that shows only the commands players have permission to use.

Admin GUI (slot 33) now properly opens the Admin Menu instead of placeholder messages.

Claim Roles Update

Added Member role alongside Visitor, Builder, Container, and Co-Owner.

/proshield trust [role] supports the new role.

Role permissions polished for clarity in GUI and config.

Fixes & Improvements

Polished config.yml layout: clearer toggles, grouped sections, and comments.

Config migration ensures new settings (claims.keep-items) are added automatically.

Improved expiry cleanup command to handle dry runs more consistently.

General code cleanup and minor performance improvements.

Release Notes

What’s New in 1.2.1

✨ Claim Roles & Access Levels

Added role-based access inside claims:

Visitor → Can enter claims but cannot interact.

Builder → Can build and interact with blocks.

Co-Owner → Nearly full access, can help manage claims.

Roles are configurable via commands and will be expanded further in the GUI.

Trust System Improvements

GUI and command integration for trust/untrust.

Radius-based trust management in the GUI (easier to trust nearby players).

Command line support remains as a fallback.

Protection Fixes

Fixed compass duplication bug (no more endless ProShield compasses).

Minor fixes to container/interactions checks.

⚙️ Quality of Life (QoL) Enhancements

Reload command now fully refreshes role and trust data.

More consistent config caching and listener reloads.

Prep work for ProShield 2.0 features.

Coming Next

This release is a stepping stone towards ProShield 2.0!
Expect Towns, Shops, Claim Flags, and Economy Integration in upcoming versions.

Check the 2.0 Roadmap for a sneak peek.

ProShield 1.2 is here! This release focuses on quality of life improvements, enhanced protection features, and a flexible claim system — making land management smoother for both players and server administrators.

✨ Highlights

Claim Roles & Access Levels
Assign roles (Owner, Co-Owner, Member, Guest) with different permissions inside claims.

Claim Expansion System
You can just expand claims into neighbouring chunks without unclaiming/re-claiming.

Configurable Claim Messages
Players now see configurable entry/exit messages when crossing claim borders.

Claim Expiry & Cleanup Enhancements
Automatic cleanup of inactive claims, with preview and admin purge tools.

Global & Per-World Toggles
Fine-tuned protection settings (explosions, fire spread, entity griefing, etc.) on a per-world basis.

Improved Admin GUI
More powerful tools for admins: teleport to claims, manage trusted users, and handle expired claims.

ProShield 1.1.9 is here!
This update brings major quality-of-life improvements, expanded protections, and better admin control.

✅ Added

Expanded protection system:

Fire spread & block burn control

Explosion controls (Creeper, TNT, Wither, Ender Dragon, End Crystals, etc.)

Entity grief control (Enderman, Ravager, Silverfish, Dragon, Wither)

Enderman teleport denial inside claims

Non-container interaction control (doors, buttons, trapdoors, levers, etc.) with whitelist/blacklist mode

Bucket usage protection (block filling/emptying in claims)


Claim expiry system (optional): Automatically remove claims of inactive players after configurable days.

Admin tools:

/proshield reload to refresh configs without restart

Admin-only purge of expired claims

Teleport to claims via admin menu


Auto-compass: Ops/admins now automatically receive the ProShield compass on join (configurable).


Changed / Improved

Refined GUI system for smoother navigation

Protection checks now respect trusted players and bypass permission more consistently

Organized and extended config.yml with per-feature toggles

Improved claim saving/loading for reliability


Fixed

Fixed missing compass issue for operators on first join

Fixed config sections being overwritten incorrectly

Fixed issues with bypass permissions not applying correctly



---

⚡ This is a big QOL release preparing the way for ProShield 2.0 (future Vault/LuckPerms/shop integration).

Changelog (v1.1.8)

Fixed GUI syncing issues

Added admin compass auto-give for OPs

Expanded block/container/interaction protection

Configurable whitelist/blacklist system

Stability and bug fixes

✨ New & Improved

• Admin Compass
  
  • Added a craftable Admin Compass (iron + redstone + compass) with a custom recipe.
    
    
  • Automatically given to admins/operators on join (if they don’t already have one).
    
    
  • Can also be obtained via /proshield command.
    
• Player GUI
  
  • Fully rebuilt and synced with the new GUIListener.
    
    
  • Provides simple claim management via menu:
    
    • ✅ Create Claim
      
      
    • Claim Info
      
      
    • ❌ Remove Claim
      
• GUIListener
  
  • Centralized all claim interaction logic (create, remove, info).
    
    
  • Clean separation: GUI builds UI, listener handles clicks & claim actions.
    
• Block Protection
  
  • Players cannot place or break blocks inside claims they don’t own.
    
• Player Join Handling
  
  • Logs player joins in console.
    
    
  • Ensures compass distribution and prepares for future player-claim sync.
    

Internal Changes

• Reorganized package structure:
  
  • plots/ now contains PlotManager, BlockProtectionListener, PlayerJoinListener, and Claim.
    
    
  • gui/ now contains GUIManager, PlayerGUI, and GUIListener.
    
• Rewritten constructors and event wiring for consistency:
  
  • All listeners and commands receive their required dependencies (ProShield, PlotManager, etc.).
    
• Removed duplicate/misplaced classes that caused JitPack build errors.
  
  
• Updated plugin.yml and pom.xml for clean build & deployment.
  
  
• Switched to version 1.1.7 to clear old JitPack cache issues.
  

Bug Fixes

• Fixed duplicate class errors during builds.
  
  
• Fixed missing symbols in PlayerGUI and PlotManager.
  
  
• Corrected event registration wiring for consistency.
  
  
• Compass recipe no longer duplicates on server reload.
  

✅ This release sets a solid foundation: stable claims, protection, admin utilities, and a working GUI.
Next steps (if you want in future versions): per-player data saving/loading, claim visualization, or permissions integration.

✨ New Features

• AdminJoinListener
  • Server owners with OP permissions now automatically receive the ProShield compass when joining the server.
  • Admins can preview the menu system without owning a plot, allowing easier testing and configuration.

Changes

• Updated pom.xml to use a stable Paper API version (no more -SNAPSHOT dependency errors).
• Locked Java 17 for both Maven and JitPack builds to ensure compatibility.
• Synced plugin.yml with the new features and permissions.

Fixes

• Fixed various build issues related to Paper snapshot dependencies.
• Improved stability of PlotManager and listener registration.

Download

• Grab the latest ProShield-1.1.6.jar from the assets below.
• Place it in your server’s plugins/ folder.
• Restart the server to generate the ProShield config folder and begin customizing.

Changelog
For the full history of changes, see the CHANGELOG.md.

Thank you for supporting ProShield! Your feedback helps guide future updates.

This update fixes a critical issue that prevented the plugin from being detected and loaded correctly by Spigot/Paper servers.

Changes in 1.1.5:

• ✅ Fixed incorrect plugin.yml main class path (com.proshield.ProShield) so the plugin now loads properly.
  
  
• ✅ Added operator-level permissions: server operators now automatically have full access to all ProShield commands.
  
  
• ✅ Improved permission structure with clear separation between proshield.use (basic commands) and proshield.admin (admin-level commands).
  

This update is highly recommended for all server owners to ensure proper functionality.