# FrontierGuard - The Ultimate Land Protection Plugin
Transform your Minecraft server with the most advanced dual-mode land claiming system!
Now includes optional WorldGuard support for even greater flexibility!
IP: **play.ocefrontier.nz** (1.21.8)
Come test it out before adding it to your server :)
## Why Choose FrontierGuard?
FrontierGuard isn't just another land claiming plugin – it's a complete gameplay transformation! Give your players freedom to build in peace or fight for glory.
## ⚡ Game-Changing Features
### Dual Player Modes – Revolutionary Gameplay Choice
Players choose a mode when they join, with a configurable 24-hour cooldown for swapping.
- ✌️ **Peaceful Mode** – Chunk-based claiming, economy integration, full grief protection, invitations, and optional PvP at designated areas
- ⚔️ **Normal Mode** – Unrestricted PvP, raiding everywhere, and traditional survival mechanics
### Advanced Land Claiming Integration
- Scalable pricing: $1,000 → $2,000 → $3,000…
- Vault integration (works with any economy plugin)
- Optional WorldGuard dependency – integrate seamlessly with existing region protection setups
- ❌ No refunds – strategic claim choices matter!
### ✨ Stunning Visual Effects
- Colour-coded boundaries with terrain-following particles
- Player-specific visibility for clean, personalized experiences
- ✨ Dynamic particle systems that adapt to your world
### 🖱️ Intuitive GUI System
- One-click mode switching with live stats
- Smart tooltips and comprehensive help system
- Advanced invitation management for collaborative building
- Real-time claim statistics and player information
### ⚔️ Dynamic PvP Areas
- WorldEdit-style selection for precise zone creation
- Named zones with custom descriptions
- Entry/exit notifications with visual feedback
- Comprehensive admin tools for server management
### ⚔️ Reputation System
- -15 to +15 scale
- Lose 1 rep with a PvP kill in the wild
- Gain 1 rep per hour played
- At -15 rep, can be configured to show coords in tab menu (with PlaceholderAPI `%frontierguard_coords%`)
### 🛡️ Advanced Protection Features
- Environmental Damage Protection
- Smart fire/lava protection – Peaceful players protected from player-placed environmental hazards
- TNT explosion control – Configurable blast protection with invitation system
- ⚡ Proximity-based placement rules – Prevents griefing through strategic block placement
- Natural vs. Player-caused detection – Only protects from intentional damage, not natural hazards
### 🌐 WorldGuard Integration
- Optional dependency – Works with or without WorldGuard
- Automatic region detection – Prevents claiming in protected areas
- ⚙️ Seamless compatibility – Integrates with existing server setups
- Enhanced protection – Respects all WorldGuard regions and flags
### 🤝 Collaborative Building System
- Invitation system – Invite friends to build on your claims
- Permission management – Granular control over invited players
- ⏰ Automatic revocation – Invitations expire when players change modes
- Invitation tracking – Full audit trail of all invitations
## 🎮 Player Experience
### For Peaceful Players:
- Safe building zones with full grief protection
- Economic progression through strategic land claiming
- Team building with invitation systems
- Optional PvP in designated areas when ready
### ⚔️ For Normal Players:
- Full PvP freedom with traditional survival mechanics
- Raiding opportunities in unclaimed areas
- ⚡ No restrictions on environmental damage
- Strategic gameplay with risk vs. reward decisions
## 🛠️ Admin Features
### Comprehensive Management
- Admin bypass for all restrictions
- Detailed statistics and player tracking
- Live configuration with `/fg reload`
- Claim management tools for server maintenance
### ⚙️ Flexible Configuration
- Customizable pricing and economy settings
- ⏰ Configurable cooldowns for mode switching
- Visual effect customization for server branding
- World-specific settings for multi-world servers
## 📜 Commands
```bash
/fg claim - Claim your current chunk (Peaceful mode only)
/fg unclaim - Release your current chunk
/fg claims - View all your claims with coordinates
/fg claiminfo - Inspect any chunk's ownership and details
/fg show - Visualize nearby claim boundaries for 5 seconds
/fg invite - Grant access to your claim
/fg uninvite - Revoke access from your claim
/fg invitations - Manage all your claim invitations
/fg gui - Open the main GUI interface
/fg cooldown - Check your mode change cooldown timer
/fg setpvpzone - Get area selection tool
/fg createpvparea - Create new PvP zone from selection
/fg deletepvparea - Remove a PvP zone
/fg listpvpareas - View all existing PvP areas
/fg reload - Reload plugin configuration
/fg setmode - Change player modes
/fg forcemode - Force mode change (bypass cooldown)
/fg adminclaims - View another player's claims
/fg setclaimlimit <#> - Configure claim limits for groups
/fg update - Check for plugin updates
/fg testeconomy - Debug economy integration (admin only)
/fg help - Show command help
```
> Note: All commands can use `/fg` instead of `/frontierguard`.
## 🔑 Permissions
| Permission | Description | Default |
|----------------------------------|--------------------------------------------|---------|
| frontierguard.* | Access to all FrontierGuard commands | ✘ |
| frontierguard.use | Basic command usage | ✔ |
| frontierguard.claim | Claim chunks | ✔ |
| frontierguard.unclaim | Unclaim chunks | ✔ |
| frontierguard.claims | List claims | ✔ |
| frontierguard.claiminfo | Check claim information | ✔ |
| frontierguard.gui | Access GUI system | ✔ |
| frontierguard.invite | Invite players to claims | ✔ |
| frontierguard.uninvite | Remove player invitations | ✔ |
| frontierguard.invitations | View claim invitations | ✔ |
| frontierguard.cooldown | Check mode change cooldown | ✔ |
| frontierguard.changemode | Change player mode via GUI | ✔ |
| frontierguard.claims.unlimited | Unlimited claims | ✘ |
| frontierguard.claimamount.* | Unlimited claims (wildcard) | ✘ |
| frontierguard.claimamount.10 | +10 bonus claims | ✘ |
| frontierguard.claimamount.20 | +20 bonus claims | ✘ |
| frontierguard.claimamount.50 | +50 bonus claims | ✘ |
| frontierguard.claimamount.100 | +100 bonus claims | ✘ |
| frontierguard.claims.vip | VIP claim group (legacy) | ✘ |
| frontierguard.claims.premium | Premium claim group (legacy) | ✘ |
| frontierguard.admin | Full admin access | OP |
| frontierguard.admin.pvparea | Manage PvP areas | OP |
| frontierguard.admin.reload | Reload configuration | OP |
| frontierguard.admin.setmode | Set player modes | OP |
| frontierguard.admin.forcemode | Force mode changes (bypass cooldown) | OP |
| frontierguard.admin.claims | View all player claims | OP |
| frontierguard.admin.setclaimlimit | Set claim limits | OP |
| frontierguard.admin.update | Check for plugin updates | OP |
| frontierguard.bypass | Bypass all protection systems | OP |
*Note: Claim amount permissions add bonus claims to the base limit + purchased claims.*
## 🧩 Placeholders
| Placeholder | Description |
|-------------------------------|-------------------------------------------------------|
| %frontierguard_reputation% | Shows the player's reputation value |
| %frontierguard_mode_display% | Displays the player's current mode |
| %frontierguard_reputation_full%| Shows the reputation value with colour formatting |
| %frontierguard_coords% | Shows live coordinates if player reputation is -15 |
| %frontierguard_coordinates% | Alternative for `%frontierguard_coords%` |
| %frontierguard_location% | Alias for live coordinates when reputation is -15 |
| %frontierguard_noob% | Displays "Noob" if the player is considered new |
## 📥 Download & Setup
1. Install Vault + EssentialsX (or your economy plugin)
2. *(Optional)* Install WorldGuard if you want region-level integration
3. *(Optional)* Install PlaceholderAPI
4. *(Optional)* Install TAB
5. Drop `FrontierGuard.jar` into `/plugins` and restart
6. Configure `config.yml`, set permissions, and create PvP areas
---
### Join the FrontierGuard Revolution!
Protect your world. Empower your players. **Download FrontierGuard Now!**
*Created with ❤️ by danielvnz*