Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
āļø VRX Clans - Advanced Clan, 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, build protected bases, manage members, run a shared economy, complete quests, unlock upgrades, form alliances, fight wars and compete on leaderboards.
Built for Paper and Purpur, VRX Clans is designed for servers that want a powerful clan experience with clean GUIs, deep configuration options, database support, admin tools and long-term progression.
Whether your server is focused on Survival, PvP, SMP, Citybuild, Hardcore, or economy gameplay, VRX Clans can be adapted to your server concept.
ā Version & Compatibility
- Current Version:
1.0.4 - 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
Bukkit and Spigot are not officially supported. VRX Clans is built for modern Paper-based servers.
āØ Main Features
- Clan creation and management
- Dynamic clan bases with protection
- Clan bank and economy features
- Clan vault with persistent storage
- Clan levels, XP and configurable rewards
- Clan quests and shared progression
- Clan shop with boosters and upgrades
- Renameable clan roles
- Dynamic role permissions
- Clan diplomacy with allies and rivals
- Clan wars with wagers and KDR tracking
- Clan logs and activity tracking
- Clan tags for chat and tab
- Clan achievements
- Multiple clan homes
- Clan applications
- Clan profiles with descriptions and icons
- Clan mail and MOTD system
- Clan war history
- Leaderboards and
/clan top - Admin inspect/editor GUI
- PlaceholderAPI support
- Discord webhook support
- DecentHolograms support
- WorldGuard support
- Optimized database and cache systems
š”ļø Dynamic Clan Bases
Clans can set their own base location and protect the area around it.
The base radius can grow through:
- Member count
- Configured base radius
- Purchased upgrades
- Progression systems
Inside protected clan areas, enemy players can be blocked from:
- Breaking blocks
- Placing blocks
- Opening protected containers
- Interacting with protected blocks
The protection system is optimized with chunk-based caching for better performance on larger servers.
WorldGuard support can prevent clans from setting bases inside protected regions such as spawn areas.
š¦ Clan Bank & Economy
Each clan has its own shared bank account.
Players can deposit money into the clan bank, while authorized ranks can withdraw money or use the balance for upgrades, wars, shop purchases and other clan features.
Supported economy features:
- Clan deposits
- Clan withdrawals
- Clan bank GUI
- War wagers
- Shop purchases
- Upkeep/tax system
- Admin economy management
VRX Clans works with Vault-compatible economy plugins such as:
- VRX Economy
- EssentialsX Economy
- CMI
- TheNewEconomy
- Other Vault-based economy systems
š¦ 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 upgrades.
Features:
- Persistent item storage
- Configurable unlock level
- Configurable upgrade levels
- Safe inventory handling
- Admin vault access
- Optimized dirty-save system
Vaults are only saved when they are actually changed, reducing unnecessary database usage.
š Clan Levels, XP & Rewards
Clans earn XP through active gameplay and server activities.
XP can be gained from:
- Breaking blocks
- Killing monsters
- Killing players
- Completing clan quests
- Admin commands
- Custom server progression
When a clan reaches enough XP, it levels up.
Level rewards can be fully configured and may include:
- Clan bank money
- Clan XP
- Custom messages
- Console commands
- Server-wide announcements
Supported placeholders include:
%clan%
%level%
%bank%
š 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
- Progression milestones
Rewards can include:
- Clan money
- Clan XP
- Console commands
This gives players more reasons to stay active and progress together.
ā Clan Quests
Clan quests allow members to work together toward shared objectives.
Example quest types:
- Kill monsters
- Mine specific blocks
- Deposit money
- Complete activity goals
Quest progress is shared across the clan.
When a quest is completed, the clan receives rewards such as XP or money.
Quests can reset automatically after a configurable interval.
š Clan Shop, Boosters & Upgrades
The clan shop gives the clan bank a real purpose.
Clans can purchase useful upgrades such as:
- Base radius upgrades
- XP boosters
- Haste boosters
- Speed boosters
- Strength boosters
- Base regeneration
- Base saturation
- Member limit upgrades
- Extra clan homes
- Vault upgrades
- Ally slot upgrades
- Rival slot upgrades
- Teleport improvements
All prices, limits and upgrade values can be configured.
āļø Dynamic Rank Permissions
Clan leaders can manage rank permissions directly through an in-game GUI.
Permission categories can include:
- Inviting players
- Kicking members
- Promoting and demoting members
- Accessing the clan bank
- Accessing the clan vault
- Setting the clan base
- Using the clan shop
- Managing wars
- Managing diplomacy
This allows clans to organize themselves without staff intervention.
š·ļø Renameable Roles & Clan Tags
Clan roles can be renamed individually by each clan.
Default ranks include:
- Recruit
- Member
- Officer
- Co-Leader
- Leader
Clans can also create custom clan tags to represent their identity.
Clan tags can be shown in:
- Chat
- Tab list
- PlaceholderAPI
- Clan profiles
Tag colors, blocked tags and tag length can be configured.
š¤ Diplomacy System
Clans can manage relationships with other clans.
Available relationship types:
- Allies
- Rivals
- Neutral
Diplomacy requests can:
- Be accepted
- Be denied
- Expire automatically
- Follow configurable limits
Friendly fire between clan members or allies can also be controlled through the config.
āļø 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 the wager into the pot
- Kills are tracked
- The first clan to reach the kill target wins
- The winner receives the pot
- War results can be stored in history
The plugin also tracks:
- Clan kills
- Clan deaths
- Clan KDR
- War results
- War history
To prevent abuse, repeated kills against the same player can be blocked from counting again until a cooldown expires.
š Clan Logs
Important clan actions are logged automatically.
Clan logs can include:
- Deposits
- Withdrawals
- Kicks
- Promotions
- Demotions
- Role changes
- War events
- Diplomacy events
- Shop actions
- Clan changes
Players can view recent clan activity with:
/clan logs
š¤ Clan Profiles
Clans can have public profiles.
A clan profile can show:
- Clan name
- Clan description
- Clan icon
- Level
- Bank
- Members
- Kills
- Deaths
- KDR
- Allies
- Rivals
Useful commands:
/clan profile [Clan]
/clan desc set <Description>
/clan icon <Material>
š Clan Applications
Players can apply to join clans instead of waiting for an invite.
Features:
- Players can apply to clans
- Clan staff can review applications
- Applications can expire automatically
- Expiration time is configurable
Commands:
/clan apply <Clan>
/clan applications
/clan accept <Player>
/clan deny <Player>
š Multiple Clan Homes
Clans can unlock and manage multiple homes.
Commands:
/clan sethome [Name]
/clan home [Name]
/clan delhome [Name]
/clan homes
Home limits can be based on:
- Default config value
- Clan level
- Purchased upgrades
š¬ Clan Mail & MOTD
VRX Clans includes clan communication tools.
Clan mail allows important messages to be sent to members.
Commands:
/clan mail read
/clan mail send <Text>
/clan mail clear
The clan MOTD can be used for announcements, rules or event reminders.
Commands:
/clan motd set <Text>
/clan motd clear
š Leaderboards
Players can view top clans directly in-game.
Available leaderboard categories:
/clan top level
/clan top bank
/clan top kills
/clan top kdr
Leaderboards are cached for better performance, especially on servers with many clans.
With DecentHolograms, admins can also create live hologram leaderboards.
š”ļø Admin Tools
VRX Clans includes useful staff and admin tools.
Admin features include:
- Reload configs
- Force save data
- Inspect clans
- Open clan vaults
- Manage clan bank
- Add XP
- Set levels
- Change leaders
- Force players into clans
- Rename clans
- Disband clans
- Create hologram leaderboards
- End seasons
Admin commands include:
/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
Required permission:
vrxclans.admin
š§© PlaceholderAPI Support
VRX Clans supports PlaceholderAPI for scoreboards, tab lists, holograms and other 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 to Discord.
Possible webhook events include:
- Clan creation
- Clan level-ups
- War wins
- Season results
This helps keep your community informed outside the server.
šļø Database Support
VRX Clans supports:
- SQLite
- MySQL
SQLite is great for smaller servers and simple setups.
MySQL is recommended for larger servers or network environments.
The plugin also includes:
- HikariCP connection pooling
- Versioned database migrations
- Optimized save handling
- Cached leaderboard data
- Efficient region protection caching
šØ Customization
VRX Clans is designed to be highly configurable.
You can customize:
- Messages
- GUIs
- Items
- Materials
- Menu titles
- Lore lines
- Prices
- Cooldowns
- Clan limits
- Level rewards
- Achievements
- Quests
- Shop upgrades
- War settings
- Diplomacy settings
- Database settings
Language files:
en_US.yml
de_DE.yml
š¦ Dependencies & Integrations
Required
- Paper or Purpur
- Java 17+
- Vault
- A Vault-compatible economy plugin
Recommended / Optional
- PlaceholderAPI
- DecentHolograms
- WorldGuard
ā Recommended Setup
For the best experience, use:
- Paper 1.20+ or Purpur 1.20+
- Java 17+
- Vault
- A Vault-compatible economy plugin
- PlaceholderAPI for placeholders
- DecentHolograms for leaderboards
- WorldGuard for spawn and region protection
- MySQL for larger servers
š¬ Support
If you need support, please provide:
- Your server version
- Your plugin version
- Your Java version
- Your database type
- Console errors or logs
- A short explanation of the issue
This helps support respond faster and fix issues more efficiently.
āļø Build. Manage. Conquer.
Create powerful clans, build protected bases, grow together, fight wars and dominate the leaderboards with VRX Clans.