⚔️ 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.