Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
โ๏ธ VRX Clans - Advanced Clan, Territory, Base & War System
VRX Clans is a modern, feature-rich and highly configurable clan system for Minecraft servers.
It gives your players everything they need to create clans, claim territory, protect bases, manage members, build a shared economy, complete quests and contracts, organize events, unlock Prestige, form alliances, fight wars, activate clan shields and compete on leaderboards.
Built for Paper and Purpur, VRX Clans is designed for servers that want a deep clan experience with clean GUIs, flexible configuration, persistent progression, database support, admin tools and performance-focused systems.
Whether your server is focused on Survival, PvP, SMP, Citybuild, Hardcore, economy gameplay or competitive clan wars, VRX Clans can be adapted to your server concept.
โ Version & Compatibility
- Current Version:
1.0.5 - Supported Server Software: Paper, Purpur
- Minecraft Compatibility:
1.20+ - Recommended Java Version: Java 17+
- Database Support: SQLite and MySQL
- Economy Support: Vault-compatible economy plugins
- Language Support: English and German
Bukkit and Spigot are not officially supported. VRX Clans is designed for modern Paper-based servers.
โจ Main Features
- Clan creation and management
- Chunk-based Clan Territory System
- Claim protection
- Clan territory map
- Level-based claim limits
- Claim shop upgrades
- Dynamic clan bases with protection
- Clan bank and economy
- Physical item payments
- Custom Model Data item payments
- Clan vault with persistent storage
- Clan levels and XP
- Configurable level rewards
- Clan Prestige System
- Prestige Points
- Prestige-exclusive rewards
- Prestige tag colors
- Prestige leaderboard
- Clan achievements
- Clan quests
- Large-scale Clan Contracts
- Contract rewards
- Shop vouchers
- Clan Events
- Event rewards
- Clan shop with boosters and upgrades
- Extended shop upgrades
- Renameable clan roles
- Dynamic role permissions
- Clan diplomacy
- Allies and rivals
- Clan wars with wagers
- War history
- Kill-farming protection
- Clan Shield System
- New clan protection
- War-loss protection
- Territory PvP shield protection
- Clan logs
- Clan tags for chat and tab
- Multiple clan homes
- Clan applications
- Clan profiles
- Clan mail
- Clan MOTD
- Leaderboards
- Cached
/clan top - Admin Inspect GUI
- PlaceholderAPI support
- Discord webhook support
- DecentHolograms integration
- WorldGuard integration
- SQLite & MySQL
- HikariCP connection pooling
- Database migrations
- Chunk-based protection caching
๐๏ธ Clan Territory System
VRX Clans includes a complete chunk-based Territory System.
Clans can claim areas of the world and build their own territory.
Commands
/clan claim
/clan unclaim
/clan map
/clan claims
Territory Features
- Claim the chunk you are currently standing in
- Unclaim clan territory
- View all owned claims
- View surrounding territory through a clan map
- Claim limits based on clan progression
- Extra claim slots through clan upgrades
- Configurable maximum claim limits
- Optional connected-claim requirement
- Disabled worlds
- WorldGuard protection checks
- Admin bypass support
- Persistent claim storage
Territory Protection
Players outside the owning clan can be prevented from:
- Breaking blocks
- Placing blocks
- Opening containers
- Using protected blocks
- Interacting with protected territory
- Performing restricted actions inside enemy claims
The system uses chunk-based caching so protection checks remain efficient even with many clans and claimed chunks.
๐บ๏ธ Territory Progression
Claim limits can scale with clan progression.
For example:
Base Claims: 3
Every 5 Clan Levels: +1 Claim
Shop Upgrade: +1 Claim
Maximum: 50 Claims
This allows territory to grow naturally alongside the clan.
Claim expansions can also require a specific Prestige level.
๐ก๏ธ Dynamic Clan Bases
Clans can set their own main base location.
The base system works alongside the Territory System and can provide additional protection and teleport functionality.
The base radius can grow through:
- Clan members
- Configured progression
- Shop upgrades
- Clan levels
- Other server-defined progression
Inside protected clan areas, enemy players can be prevented from:
- Breaking blocks
- Placing blocks
- Opening containers
- Interacting with protected objects
WorldGuard integration can prevent players from placing clan bases or claims inside protected server regions such as spawn.
๐ฆ Clan Bank & Economy
Every clan has its own shared bank account.
Members can deposit money into the clan bank, while authorized clan ranks can withdraw money or use clan funds for:
- Clan shop purchases
- War wagers
- Territory upgrades
- Base upgrades
- Shield activation
- Clan progression
- Other configurable features
Commands
/clan bank
/clan deposit <Amount>
/clan withdraw <Amount>
Supported economy features include:
- Clan deposits
- Clan withdrawals
- Clan bank GUI
- Shop purchases
- War wagers
- Upkeep / taxes
- Upgrade payments
- Admin economy management
VRX Clans can work with Vault-compatible economy plugins such as:
- VRX Economy
- EssentialsX Economy
- CMI
- TheNewEconomy
- Other Vault-supported economy systems
๐ Physical Item Payments
VRX Clans is no longer limited to money-only purchases.
Features can be configured to require physical Minecraft items instead of in-game currency.
Payment types can include:
MONEY
ITEM
Item Payments Can Check
- Material
- Amount
- Display name
- Custom Model Data
This allows server owners to create custom currencies and progression items.
Examples
Claim Upgrade
โ 32 Emeralds
Clan Shield
โ 16 Diamonds
Special Upgrade
โ Custom Model Data Token
This makes it possible to use:
- Rare resources
- Event tokens
- Custom currencies
- Boss drops
- Premium crafting materials
- Server-specific items
๐ Flexible Shop Payments
Different shop upgrades can use completely different payment methods.
Example:
Member Upgrade
โ $10,000
Claim Upgrade
โ 32 Emeralds
Vault Upgrade
โ 16 Diamonds
Special Upgrade
โ Custom Token
This gives server owners significantly more freedom when designing their clan economy.
๐ฆ Clan Vault
Clans can unlock a shared virtual storage inventory called the Clan Vault.
The vault can be unlocked at a configurable clan level and expanded later through progression or shop upgrades.
Features
- Persistent item storage
- Configurable unlock level
- Configurable upgrade levels
- Safe inventory handling
- Admin vault access
- Extended vault upgrades
- Optimized dirty-save system
Vault data is only saved when changes are detected, reducing unnecessary database operations.
๐ Clan Levels, XP & Rewards
Clans earn XP through active gameplay.
XP can be gained from:
- Breaking blocks
- Killing monsters
- Killing players
- Completing Clan Quests
- Completing Clan Events
- Completing Contracts
- Admin rewards
- Custom server progression
When enough XP is earned, the clan levels up.
Level Rewards
Level rewards can include:
- Clan bank money
- Clan XP
- Custom messages
- Console commands
- Server-wide announcements
- Progression unlocks
Supported placeholders include:
%clan%
%level%
%bank%
๐๏ธ Clan Prestige System
When a clan reaches the configured maximum level, it can enter Prestige.
Command
/clan prestige
Example:
Level 50
โ Prestige 1
โ Level resets
โ Reach Level 50 again
โ Prestige 2
Prestige creates long-term progression even after clans reach the normal maximum level.
๐ Prestige Rewards
Prestige can provide permanent rewards such as:
- Additional clan homes
- Additional member slots
- Clan bank rewards
- Special clan tag colors
- Exclusive shop upgrades
- Additional claim progression
- Prestige Points
- Server-specific custom rewards
Prestige rewards and limits can be configured by the server owner.
๐จ Prestige Clan Tag Colors
Specific Prestige levels can unlock exclusive clan tag colors.
Example:
Prestige 1 โ Dark Aqua
Prestige 2 โ Purple
Prestige 3 โ Gold
Prestige 5 โ Pink
This gives high-level clans a visible status symbol.
๐ Prestige Exclusive Upgrades
Shop upgrades can require a minimum Prestige level.
Examples:
Advanced Claim Expansion
Required Prestige: 1
Advanced Vault Upgrade
Required Prestige: 3
Elite Member Expansion
Required Prestige: 5
Prestige therefore becomes more than a cosmetic progression system.
โญ Prestige Points
Clans can earn Prestige Points independently from their Prestige level.
Prestige Points can be rewarded through:
- Clan Contracts
- Events
- Achievements
- Custom rewards
- Server progression
This allows server owners to create additional Prestige-based systems in the future.
๐ Prestige Leaderboard
Prestige has its own leaderboard category.
/clan top prestige
Players can compete to become one of the highest Prestige clans on the server.
๐ Clan Achievements
VRX Clans includes a configurable achievement system that gives clans long-term goals.
Achievements can be based on:
- Clan members
- Clan bank balance
- Clan kills
- Clan level
- Completed events
- Progression milestones
Rewards can include:
- Clan bank money
- Clan XP
- Console commands
- Custom progression rewards
Command
/clan achievements
โ Clan Quests
Clan Quests are cooperative objectives designed for regular progression.
Example quest types:
- Kill monsters
- Mine specific blocks
- Deposit money
- Complete gameplay objectives
Quest progress is shared across the clan.
When a quest is completed, the clan can receive rewards such as:
- Clan XP
- Clan bank money
- Other configured rewards
Quests can automatically reset after a configurable interval.
๐งพ Clan Contracts
Clan Contracts are large-scale cooperative objectives designed to be significantly bigger than standard quests.
Commands
/clan contracts
/clan contract start <ID>
/clan contract progress
Example Contracts
Mine 10,000 Stone
Kill 500 Zombies
Deposit 100,000 Money
Win 3 Clan Wars
Recruit 5 Members
All eligible clan members contribute toward the same contract progress.
โ๏ธ Mining Contracts
Contracts can require clans to mine large quantities of blocks.
Example:
Stone Master
Mine:
10,000 Stone
Every clan member can contribute toward the objective.
๐ง Combat Contracts
Combat-focused clans can receive mob hunting contracts.
Example:
Zombie Hunters
Kill:
500 Zombies
Progress is shared across the entire clan.
๐ฐ Economy Contracts
Contracts can also be connected to the clan economy.
Example:
Wealthy Clan
Deposit:
$100,000
Clan bank deposits contribute toward the contract.
โ๏ธ War Contracts
Competitive clans can receive war-based contracts.
Example:
War Legends
Win:
3 Clan Wars
This rewards clans that actively participate in the war system.
๐ฅ Recruitment Contracts
Clan growth can also contribute toward contract objectives.
Example:
Recruiters
Recruit:
5 New Members
This gives growing clans additional goals.
๐ Contract Rewards
Clan Contracts can offer significantly larger rewards than normal quests.
Rewards can include:
- Clan XP
- Clan bank money
- Clan boosters
- Shop vouchers
- Prestige Points
Contracts therefore serve as one of the main long-term progression systems.
๐๏ธ Shop Vouchers
Clan Contracts can reward Shop Vouchers.
A voucher can cover a money-based clan shop purchase.
This allows active clans to unlock upgrades without directly receiving additional money.
Item-based purchases still require the configured physical item.
๐ Clan Events
Clan leaders can create internal events for their members.
Commands
/clan event create <Name>
/clan event list
/clan event join <Event>
/clan event cancel <Event>
/clan event complete <Event>
Example Events
Raid Night
Farming Event
War Training
Base Building
Boss Fight
Clan Meeting
Event Features
- Create internal clan events
- View active events
- Join events
- Cancel events
- Complete events
- Persistent event storage
- Shared clan participation
- Configurable maximum active events
Clan Events are ideal for community-focused servers and organized clans.
๐ Clan Event Rewards
Completing an event can reward:
- Clan XP
- Clan bank money
- XP boosters
- Achievement progress
This rewards clans for actively playing together.
๐ Event Achievements
Clan Events can contribute toward the achievement system.
Example:
Achievement:
Event Team
Requirement:
Complete 10 Clan Events
Possible rewards:
- Clan XP
- Clan bank money
- Console commands
๐ Clan Shop, Boosters & Upgrades
The Clan Shop gives clan progression and the clan bank a real purpose.
Possible purchases include:
- Base radius upgrades
- XP boosters
- Haste boosters
- Speed boosters
- Strength boosters
- Base regeneration
- Base saturation
- Additional members
- Additional homes
- Vault upgrades
- Additional claims
- Ally slots
- Rival slots
- Teleport improvements
All prices, limits, requirements and payment methods can be configured.
๐ง Extended Shop Upgrades
Extended upgrades can include:
members
homes
vault
claims
allies
rivals
teleport
Each upgrade can have:
- Enabled / disabled state
- Price
- Physical item payment
- Upgrade amount
- Maximum purchases
- Prestige requirement
This allows highly customizable clan progression.
โ๏ธ Dynamic Rank Permissions
Clan leaders can manage rank permissions directly through an in-game GUI.
Permission categories can include:
- Inviting players
- Kicking members
- Promoting members
- Demoting members
- Accessing the Clan Bank
- Accessing the Clan Vault
- Setting the clan base
- Managing territory
- Using the Clan Shop
- Managing Clan Wars
- Managing diplomacy
- Managing other clan features
This allows clans to organize themselves without staff intervention.
๐ท๏ธ Renameable Roles & Clan Tags
Clan roles can be renamed individually by each clan.
Default roles include:
- Recruit
- Member
- Officer
- Co-Leader
- Leader
Clans can also create custom clan tags.
Clan tags can be displayed in:
- Chat
- Tab list
- PlaceholderAPI
- Clan profiles
Tag colors, blocked tags and tag length can be configured.
Prestige can also unlock additional clan tag colors.
๐ค Diplomacy System
Clans can manage relationships with other clans.
Relationship types include:
- Allies
- Rivals
- Neutral
Diplomacy requests can:
- Be accepted
- Be denied
- Expire automatically
- Follow configurable limits
The number of allies and rivals can also be expanded through clan shop upgrades.
โ๏ธ Clan Wars & KDR Tracking
VRX Clans includes a competitive Clan War System.
Clans can start wars with wagers:
/clan war <Clan> <Wager>
When a war is accepted:
- Both clans pay their wager
- The money enters the war pot
- Clan kills are tracked
- The configured kill target determines the winner
- The winner receives the pot
- War results are recorded
The plugin also tracks:
- Clan kills
- Clan deaths
- Clan KDR
- War victories
- War results
- War history
๐ซ War Kill-Farming Protection
Repeatedly killing the same player can be prevented from counting toward a clan war.
A configurable cooldown determines when another kill against the same player can count again.
This helps prevent artificial war progression and stat farming.
๐ Clan War History
Completed wars are stored in the clan's history.
Commands
/clan warhistory
/clan warhistory <Clan>
Players can review previous clan conflicts and results.
๐ก๏ธ Clan Shield System
VRX Clans includes a complete Clan Shield System for PvP and competitive servers.
Commands
/clan shield
/clan shield activate
/clan shield status
A shield gives clans temporary protection and helps prevent weaker clans from being permanently farmed.
โ๏ธ Shield War Protection
While protected:
- Other clans can be prevented from starting a war
- War requests against the protected clan can be blocked
- Recently defeated clans receive recovery time
- New clans can prepare before entering competitive gameplay
๐ฐ Territory Shield Protection
Clan Shields can provide additional protection inside owned territory.
Depending on the configuration:
- Enemy PvP can be disabled
- Clan claims become safer
- Bases can receive temporary protection
- Players receive time to recover after major conflicts
๐ New Clan Protection
Newly created clans can automatically receive temporary protection.
Example:
New Clan Shield:
24 Hours
This gives new clans time to:
- Recruit members
- Build a base
- Claim territory
- Gather resources
- Prepare for war
- Establish themselves on the server
๐ Protection After War Loss
A clan can automatically receive protection after losing a war.
Example:
War Lost
โ Shield activated for 6 hours
This prevents repeated wars against the same weakened clan.
๐ Manual Clan Shields
Authorized clan members can manually activate a shield.
/clan shield activate
Shield activation can require:
- Clan bank money
- Physical items
- Custom server items
๐ Item-Based Shield Activation
Example:
Shield Duration:
12 Hours
Cost:
16 Diamonds
instead of:
$25,000
This allows rare defensive items to become part of the server economy.
โณ Shield Cooldowns
Manual shields support configurable cooldowns.
Example:
Shield Duration:
12 Hours
Shield Cooldown:
48 Hours
This prevents permanent protection and keeps competitive gameplay balanced.
๐ Shield Status
Players can check their current Clan Shield.
/clan shield status
The status can show:
- Current shield state
- Remaining protection time
- Remaining cooldown
- Protection availability
๐ Clan Logs
Important clan actions are logged automatically.
Clan logs can include:
- Deposits
- Withdrawals
- Kicks
- Promotions
- Demotions
- Role changes
- War events
- Diplomacy events
- Shop activity
- Clan progression
- Other important clan changes
Command
/clan logs
๐ค Clan Profiles
Clans can have public profiles.
Profiles can display:
- Clan name
- Description
- Icon
- Level
- Prestige
- Bank
- Members
- Kills
- Deaths
- KDR
- Allies
- Rivals
- Other clan information
Commands
/clan profile [Clan]
/clan desc set <Description>
/clan icon <Material>
๐ Clan Applications
Players can apply to clans instead of waiting for an invitation.
Features
- Players can apply to clans
- Clan staff can review applications
- Applications can be accepted
- Applications can be denied
- Applications expire automatically
- Expiration time can be configured
Commands
/clan apply <Clan>
/clan applications
/clan accept <Player>
/clan deny <Player>
๐ Multiple Clan Homes
Clans can unlock and manage multiple named homes.
Commands
/clan sethome [Name]
/clan home [Name]
/clan delhome [Name]
/clan homes
Home limits can be increased through:
- Default configuration
- Clan level
- Prestige
- Shop upgrades
๐ฌ Clan Mail & MOTD
VRX Clans includes internal communication tools.
Clan Mail
/clan mail read
/clan mail send <Text>
/clan mail clear
Clan Mail can be used for:
- Clan announcements
- Internal information
- Event notices
- War preparation
- Member communication
Clan MOTD
/clan motd set <Text>
/clan motd clear
The clan MOTD can be displayed to members and used for rules, news and announcements.
๐ Leaderboards
Players can compete through multiple leaderboard categories.
Commands
/clan top level
/clan top prestige
/clan top bank
/clan top kills
/clan top kdr
Leaderboards are cached to reduce repeated calculations and improve performance on servers with many clans.
With DecentHolograms, server owners can also create live hologram leaderboards.
๐ก๏ธ Admin Tools
VRX Clans includes powerful staff and administration tools.
Admin features include:
- Reload configurations
- Force-save clan data
- Inspect clans
- Admin Inspect GUI
- Open clan vaults
- Manage clan banks
- Add clan XP
- Set clan levels
- Change clan leaders
- Force players into clans
- Rename clans
- Disband clans
- Create hologram leaderboards
- End seasons
- Bypass clan protection
Admin Commands
/clana reload
/clana save
/clana inspect
/clana inspect <Clan>
/clana vault <Clan>
/clana eco <Clan> <add|remove|set> <Amount>
/clana addxp <Clan> <XP>
/clana setlevel <Clan> <Level>
/clana setleader <Clan> <Player>
/clana forcejoin <Clan> <Player>
/clana disband <Clan>
/clana rename <Old> <New>
/clana setholo <kills|level|bank>
/clana endseason
Main admin permission:
vrxclans.admin
Protection bypass permission:
vrxclans.admin.bypass
๐งฉ PlaceholderAPI Support
VRX Clans supports PlaceholderAPI for:
- Scoreboards
- Tab lists
- Holograms
- Chat plugins
- Other PlaceholderAPI-compatible plugins
Example placeholders:
%vrxclans_has_clan%
%vrxclans_name%
%vrxclans_level%
%vrxclans_rank%
%vrxclans_members%
%vrxclans_bank%
%vrxclans_radius%
๐ก Discord Webhooks
Important clan events can be sent directly to Discord.
Possible webhook events include:
- Clan creation
- Clan level-ups
- War wins
- Season results
- Other important clan activity
This helps keep communities informed outside Minecraft.
๐๏ธ Database Support
VRX Clans supports:
- SQLite
- MySQL
SQLite
Recommended for:
- Smaller servers
- Simple installations
- Single-server setups
MySQL
Recommended for:
- Larger servers
- High player counts
- External database environments
- More advanced setups
VRX Clans also includes:
- HikariCP connection pooling
- Versioned database migrations
- Persistent clan progression
- Optimized save handling
- Cached leaderboards
- Chunk-based claim caching
- Efficient protection lookups
๐พ Persistent Clan Data
Important clan progression is permanently stored.
This includes:
- Clan information
- Members
- Roles
- Bank balance
- Vault contents
- Clan level
- Prestige
- Prestige Points
- Clan claims
- Additional claim slots
- Clan achievements
- Clan homes
- Applications
- War history
- Clan Events
- Event progress
- Clan Contracts
- Contract progress
- Shop vouchers
- Clan Shield state
- Shield cooldowns
- Profiles
- Clan Mail
- MOTD
- Shop upgrades
- Clan statistics
๐จ Customization
VRX Clans is designed to be highly configurable.
Server owners can customize:
- Messages
- Languages
- GUIs
- Items
- Materials
- Custom Model Data payments
- Menu titles
- Lore
- Economy prices
- Item prices
- Cooldowns
- Clan limits
- Claim limits
- Territory settings
- Protection settings
- Level progression
- Prestige
- Prestige rewards
- Achievements
- Clan Quests
- Clan Contracts
- Contract rewards
- Clan Events
- Event rewards
- Clan Shields
- Shop upgrades
- War settings
- Diplomacy
- Database configuration
- Discord integration
Language files:
en_US.yml
de_DE.yml
The main configuration files remain in English for consistent administration.
๐ฆ Dependencies & Integrations
Required
- Paper or Purpur
- Java 17+
- Vault
- A Vault-compatible economy plugin
Optional / Recommended
- PlaceholderAPI
- DecentHolograms
- WorldGuard
โ Recommended Setup
For the best experience, use:
- Paper 1.20+ or Purpur 1.20+
- Java 17+
- Vault
- Vault-compatible economy plugin
- PlaceholderAPI for external placeholders
- DecentHolograms for hologram leaderboards
- WorldGuard for protected server regions
- MySQL for larger servers
๐ฎ Command Overview
Territory
/clan claim
/clan unclaim
/clan map
/clan claims
Prestige
/clan prestige
/clan top prestige
Events
/clan event create <Name>
/clan event list
/clan event join <Event>
/clan event cancel <Event>
/clan event complete <Event>
Contracts
/clan contracts
/clan contract start <ID>
/clan contract progress
Clan Shield
/clan shield
/clan shield activate
/clan shield status
Clan Profiles
/clan profile [Clan]
/clan desc set <Description>
/clan icon <Material>
Applications
/clan apply <Clan>
/clan applications
/clan accept <Player>
/clan deny <Player>
Clan Homes
/clan sethome [Name]
/clan home [Name]
/clan delhome [Name]
/clan homes
Clan Mail & MOTD
/clan mail read
/clan mail send <Text>
/clan mail clear
/clan motd set <Text>
/clan motd clear
Wars
/clan war <Clan> <Wager>
/clan war accept
/clan war deny
/clan warhistory
/clan warhistory <Clan>
Leaderboards
/clan top level
/clan top prestige
/clan top bank
/clan top kills
/clan top kdr
โก Performance Focus
VRX Clans is designed with larger servers in mind.
Performance-focused systems include:
- Chunk-based territory caching
- Efficient claim lookups
- Cached leaderboard calculations
- HikariCP connection pooling
- Optimized database writes
- Persistent migrations
- Vault dirty-state saving
- Reduced unnecessary save operations
- Efficient clan data caching
๐ฏ Long-Term Clan Progression
VRX Clans provides multiple progression systems that work together.
Clans can progress through:
Clan Levels
Clan XP
Achievements
Clan Quests
Clan Contracts
Clan Events
Territory Expansion
Shop Upgrades
Clan Homes
War Progression
Prestige
Prestige Points
Leaderboards
This gives players long-term goals beyond simply creating a clan.
๐ฌ Support
If you need support, please provide:
- Server version
- Plugin version
- Java version
- Database type
- Installed dependencies
- Console errors or logs
- Short explanation of the issue
Providing this information helps support resolve issues faster.
โ๏ธ Build. Claim. Protect. Conquer.
Create your clan.
Claim your territory.
Build your base.
Grow your economy.
Complete contracts.
Organize events.
Reach Prestige.
Protect your members.
Fight your rivals.
Build your empire with VRX Clans.


