Custom Factions & Land Claiming | Destructible Walls & War [1.0]

Custom Factions & Land Claiming | Dynamic Border Walls & Strategic Warfare
Are you looking to elevate your server's faction experience beyond traditional, outdated mechanics? This fully custom Factions and Land Claiming plugin brings a fresh layer of tactical depth to Minecraft. Designed originally for unique themed servers, it manages player wilderness gameplay with unique structural defenses, economy integration, and structured warfare.

Key Features
1. Team & Faction Management

• 
  Custom Ranks & Permissions: Players can create teams with custom names and tags. Leaders can assign custom sub-ranks (e.g., Officer, Member) and toggle specific permissions like claiming land or declaring war.
  
  
• 
  Roster Access: View team rosters, ranks, and permissions easily via commands or a user-friendly GUI.
  
  
• 
  Friendly Fire Restriction: Team members are completely protected from friendly fire at all times.
  
  
• 
  Member Cap Upgrades: Teams start with a 5-member limit, which can be upgraded using in-game currency via the Central Chunk menu.
  
  
• 
  Alliance System: Send and accept alliance requests. Allies cannot attack each other and can freely walk through each other's claims, but they cannot break/place blocks or interact with containers. Server-wide broadcasts notify everyone when an alliance forms or breaks.
  
  
• 
  Inactivity Protection: If no member logs in within 6 days of team creation, the team automatically disbands. Logging in within those initial 6 days permanently extends the inactivity buffer to 12 days from that point forward. Disbanding completely cleans up the team, unclaiming land and removing walls.
  

️ 2. Advanced Chunk-Based Claiming

• 
  Central Chunk (HQ): Your first claim acts as your base of operations. Future chunk-based claims (16x16) must expand outward from it with no gaps allowed.
  
  
• 
  Separate Claims: Establish up to 5 completely separate land claims across the world, though additional claims beyond the first become increasingly expensive. If a separate claim is captured, only that specific land is lost.
  
  
• 
  Absolute Land Protection: Non-members are restricted from placing/breaking blocks, accessing containers, or causing TNT block damage inside your claims. Enemies and neutrals are automatically blocked or teleported out entirely.
  
  
• 
  Fluid Flow Protection: Water and lava cannot flow into claimed land from the outside.
  
  
• 
  The 30-Block Buffer Zone: A 30-block ring exists right outside your claim's outer border where PvP and free movement are active. Non-members cannot build or mine here normally, but attackers can build TNT cannons here during an active war to assault the wall.
  

3. Dynamic Destructible Wall System

• 
  Automatic Border Generation: Claiming land instantly generates a physical wall along the outer edge of your entire connected territory, seamlessly tracing complex shapes like L-shaped designs. The wall automatically regenerates and adapts whenever territory expands.
  
  
• 
  Configurable Settings: Default wall height ranges from 10 to 20 blocks tall, and block materials (like stone brick mixes) are fully configurable.
  
  
• 
  Wall Health Mechanic: The wall features a structural health pool (100 HP default) that can be upgraded or repaired with currency via the Central Chunk GUI.
  
  
• 
  No Physical Block Griefing: TNT cannons fired by an active enemy during war reduce the wall's HP without physically breaking blocks. Once health hits 0, the wall blocks disappear, rendering the base breachable.
  
  
• 
  Dynamic Bossbar Display: Any player within 100 blocks of a wall belonging to a faction currently at war will see a live health bossbar ([FactionName] Wall 55/100 HP).
  

⚔️ 4. Strategic War & Capturing

• 
  War Declarations: Declare war on enemies using /war declare, triggering a server-wide broadcast. Wars cannot be declared on allies, but multiple factions can simultaneously wage war on the same target.
  
  
• 
  24-Hour Timer: Wars last roughly 24 hours and auto-end if the Central Chunk isn't captured, triggering another broadcast.
  
  
• 
  Breach & Capture Windows: When a wall falls, defenders have a 12-hour window. If the defending leader logs in during this time, a formal capture phase can begin. If they fail to log in within 12 hours, attackers can bypass the mechanic and claim the Central Chunk instantly.
  
  
• 
  Intense Capture Mechanic: To win, the attacking leader must stand inside the defending Central Chunk for 10 consecutive minutes. Moving out or dying completely resets the timer, keeping PvP intense during active sieges. A successful capture returns all chunks in that claim back to wilderness.
  

5. Central Chunk Upgrade Menu
Right-clicking or using a command at the Central Chunk opens an interactive GUI menu. Players can purchase member cap increases, chunk limits, wall HP upgrades, wall repairs, or establish costly new claims.

️ Command Reference
Command Description
/team create [name]
Create a new team

/team invite [player]
Invite a player to your team

/team kick [player]
Kick a player from your team

/team promote/demote [player]
Change a member's rank

/team disband
Disband your team

/team info [name]
View team info, members, and land

/team ally [teamname]
Send or accept an ally request

/team unally [teamname]
Break an alliance

/claim
Claim the chunk you are standing in

/unclaim
Unclaim the chunk you are standing in

/claim map
Show a map of nearby claimed chunks

/war declare [teamname]
Declare war on another team

/war status
View current active wars

/faction menu
Open the Central Chunk upgrade menu


️ UI & Scoreboard Integration

• 
  Server Broadcasts: Auto-announcements keep the server updated on wars, wall breaches, captures, alliances, and disbands.
  
  
• 
  Immersive Login Titles: Logging in during a war flashes a screen title warning players (YOUR LAND IS AT WAR) along with their opponent's name.
  
  
• 
  Scoreboard Integration: Dynamically appends war details, time remaining, participating wall HP, and live capture timers to the server's existing scoreboard layout.
  
  
• 
  Reminders: Online faction members receive configurable text reminders every 30 minutes during active wars.
  

Technical Details & Dependencies

• 
  Compatibility: Fully optimized for Paper / Spigot 1.21.1 (Java).
  
  
• 
  Economy Engine: Integrates flawlessly via Vault API (with Essentials as the economy provider).
  
  
• 
  Data Persistence: Safe data storage across server restarts via flat file or database options.
  
  
• 
  Usability: Native tab-completion supported across applicable commands.
  
  
• 
  100% Configurable: Adjust wall heights, default HP pools, costs, timers, and all player-facing messages within the config.yml or messages.yml.
  
  
• 
  Admin Tools: Includes console and admin-ready management commands.
  

⚙️ Dependencies (Required Plugins)
To ensure the economy system (purchasing new chunks, upgrading member limits, and repairing walls) works flawlessly, your server must have the following plugins installed:

• 
  Vault (The core economy API)
  
  
• 
  An Economy Provider (Such as EssentialsX, which is highly recommended and tested)
  

Developer Note: This plugin focuses exclusively on wilderness faction gameplay. It is designed to run perfectly alongside plugins like WorldEdit/WorldGuard used to protect server-owned hubs or town hubs.