Clans

VRX Clans v1.0.5

Version 1.0.5 is a major progression, territory, economy and PvP update for VRX Clans. This update introduces a complete Clan Territory System, flexible physical item payments, Clan Prestige, Clan Events, large-scale Clan Contracts, a new Clan Shield System, and multiple new progression options for long-term clan gameplay. ---

Clan Territory System

Clans can now claim chunks and build their own protected territory.

New Commands

/clan claim
/clan unclaim
/clan map
/clan claims

Features

- Claim chunks for your clan - Unclaim existing territory - View all claimed chunks - View nearby territory through a clan map - Claim limits based on clan level - Additional claim slots through upgrades - Configurable maximum claim limits - Optional connected-claim requirement - Disabled worlds support - WorldGuard integration - Admin bypass support

Territory Protection

Foreign players can be prevented from: - Breaking blocks - Placing blocks - Opening containers - Interacting with protected blocks - Performing protected actions inside clan territory The territory system uses chunk-based handling for efficient protection checks. ---

Physical Item Payments

Clan shop features and other systems can now use physical Minecraft items instead of only in-game money. Server owners can configure whether a feature costs:

MONEY

or:

ITEM

Item Payment Support

Item payments can use: - Minecraft material - Item amount - Custom display name - Custom Model Data This allows servers to create completely different progression systems.

Example

Instead of paying:

$10,000

a clan could be required to pay:

32 Emeralds

This can be used for: - Rare resources - Event currencies - Custom tokens - Custom server items - Premium upgrade materials - Special progression items ---

Extended Shop Payment Support

The clan shop has been expanded to support both money and physical item payments. Different upgrades can use different payment types. For example:

Member Upgrade → Money
Claim Upgrade → Emeralds
Vault Upgrade → Diamonds
Teleport Upgrade → Custom Token

This gives server owners significantly more freedom when designing their economy. ---

Claim Upgrades

Clans can purchase additional territory capacity through the clan shop. Possible upgrade:

+1 Clan Claim

Claim upgrades can be configured with: - Price - Payment type - Added claim slots - Maximum purchases - Required Prestige level This allows claim progression to be connected with clan levels, Prestige and the clan economy. ---

Clan Prestige System

Clans can now enter Prestige after reaching the configured maximum clan level.

New Command

/clan prestige

Example Progression

Level 50
→ Prestige 1
→ Clan Level resets
→ Reach Level 50 again
→ Prestige 2

Prestige provides long-term progression even after clans reach the normal maximum level.

Prestige Rewards

Prestige can grant permanent bonuses such as: - Additional clan homes - Additional member slots - Clan bank rewards - Special clan tag colors - Exclusive shop upgrades - Additional progression rewards The maximum Prestige level and rewards can be configured by the server owner. ---

Prestige Clan Tag Colors

Prestige levels can unlock special clan tag colors. Example:

Prestige 1 → Dark Aqua
Prestige 2 → Purple
Prestige 3 → Gold
Prestige 5 → Pink

This gives experienced clans an additional visual status symbol. ---

Prestige Exclusive Shop Upgrades

Clan shop upgrades can now require a specific Prestige level. Example:

Claim Expansion
Required Prestige: 1

or:

Advanced Vault Upgrade
Required Prestige: 3

This makes Prestige useful beyond cosmetic rewards. ---

Prestige Leaderboard

Prestige has been added as a new clan leaderboard category.

New Command

/clan top prestige

Players can now compete to become one of the highest Prestige clans on the server. ---

Prestige Points

Clans can now earn Prestige Points separately from their actual Prestige level. Prestige Points can be rewarded through systems such as: - Clan Contracts - Special events - Achievements - Custom server progression This creates another progression currency that server owners can use for future rewards or custom systems. ---

Clan Events

Clan leaders can now create internal events for their members.

New 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 clan events - Join active events - List currently active events - Complete events - Cancel events - Configurable maximum active events per clan - Persistent event storage - Clan-wide event participation Clan Events are designed to make clans more active and community-focused. ---

Clan Event Rewards

Completing a clan event can reward the clan. Possible rewards include: - Clan XP - Clan bank money - XP boosters - Achievement progress This allows server owners to reward clans for organizing and playing together. ---

Event Achievements

Clan Events can now contribute toward achievements. Example:

Achievement: Event Team
Requirement: Complete 10 Clan Events

Possible rewards:

Clan Bank Money
Clan XP
Custom Commands

This connects the event system with long-term clan progression. ---

Clan Contracts

Clans can now accept large-scale cooperative contracts. Contracts are designed to be significantly larger than normal clan quests and require long-term teamwork.

New 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

Each clan can work together toward completing the active contract. ---

Mining Contracts

Contracts can require clans to mine large amounts of specific blocks. Example:

Contract: Stone Master

Objective:
Mine 10,000 Stone

Every eligible clan member contributes to the same progress. ---

Mob Hunting Contracts

Clans can receive combat-based contracts. Example:

Contract: Zombie Hunters

Objective:
Kill 500 Zombies

Progress is shared between all clan members. ---

Economy Contracts

Contracts can also use clan economy progression. Example:

Contract: Wealthy Clan

Objective:
Deposit 100,000 Money

Clan bank deposits contribute toward the contract goal. ---

War Contracts

Competitive clans can receive contracts based on war victories. Example:

Contract: War Legends

Objective:
Win 3 Clan Wars

This rewards clans that actively participate in the war system. ---

Recruitment Contracts

Clan growth can also be used as a contract objective. Example:

Contract: Recruiters

Objective:
Recruit 5 New Members

This gives growing clans additional progression goals. ---

Contract Rewards

Clan Contracts can provide much larger rewards than normal quests. Possible rewards include: - Clan XP - Clan bank money - Clan boosters - Shop vouchers - Prestige Points Contracts can therefore become one of the main long-term progression systems for clans. ---

Shop Vouchers

A new Shop Voucher reward has been added. Shop vouchers can be rewarded through Clan Contracts. A voucher can be used to cover a money-based clan shop purchase. This allows server owners to reward active clans with free upgrades without directly giving them money. Item-based purchases remain separate and still require the configured physical items. ---

Clan

VRX Clans v1.0.4

Major Feature Update

VRX Clans v1.0.4 brings a large feature update focused on clan customization, social interaction, progression, management tools and long-term gameplay. This update adds new clan tags, achievements, multiple clan homes, war history, clan applications, clan profiles, clan mail, MOTD features, extended shop upgrades and improved leaderboard performance. ---

New Features

Clan Tags

Clans can now use custom tags to represent their identity. New features: - Custom clan tags - Clan tag colors - Optional chat display - Optional tab list display - Configurable tag length - Blocked tag list for protected names New commands:

/clan tag <Tag>
/clan tagcolor <Color>

---

Clan Achievements

A new achievement system has been added to give clans more long-term goals. Achievements can reward clans for reaching milestones such as: - Member count - Bank balance - Kills - Clan level Possible rewards include: - Clan bank money - Clan XP - Custom commands New command:

/clan achievements

---

Multiple Clan Homes

Clans can now unlock and manage multiple homes. New features: - Named clan homes - Level-based home unlocks - Configurable maximum homes - Easy teleport management New commands:

/clan sethome [Name]
/clan home [Name]
/clan delhome [Name]
/clan homes

---

Clan War History

Clan wars are now recorded in a history system. Players can view previous wars and check past results. New commands:

/clan warhistory
/clan warhistory <Clan>

---

Clan Applications

Players can now apply to join clans instead of only relying on invites. New features: - Players can apply to clans - Clan staff can accept or deny applications - Applications expire automatically - Configurable expiration time New commands:

/clan apply <Clan>
/clan applications
/clan accept <Player>
/clan deny <Player>

---

Clan Profiles

Clans now have public profiles. A clan profile can show important clan information such as: - Clan description - Clan icon - Level - Bank - Members - Kills - Deaths - KDR New commands:

/clan profile [Clan]
/clan desc set <Description>
/clan icon <Material>

---

Clan Mail

A new clan mail system has been added. Clan members can read important messages, while authorized members can send messages to the clan. New commands:

/clan mail read
/clan mail send <Text>
/clan mail clear

---

Clan MOTD

Clans can now set a Message of the Day. This is useful for announcements, events, rules or internal clan information. New commands:

/clan motd set <Text>
/clan motd clear

---

Extended Clan Shop Upgrades

The clan shop has been expanded with new upgrade options. New upgrade categories:

members
homes
vault
allies
rivals
teleport

New command:

/clan shopupgrade <members|homes|vault|allies|rivals|teleport>

These upgrades allow clans to improve their progression and unlock more useful features over time. ---

Admin Clan Editor GUI

Admins now have improved clan inspection and management tools. Admin commands:

/clana inspect
/clana inspect <Clan>

The admin inspect system helps staff review clans more easily and manage support situations faster. ---

Performance Improvements

Clan Top Cache

The clan leaderboard system has been optimized. Leaderboards are now cached instead of being recalculated every time a player uses /clan top. This improves performance, especially on servers with many clans. ---

New Config Options

This update adds new configuration sections for: - Clan tags - Clan homes - Clan achievements - Clan applications - Clan profiles - Clan mail - Clan MOTD - Admin editor - Extended shop upgrades - Clan top cache Server owners can fully customize limits, prices, rewards, timeouts and enabled features. ---

Language Files

- English language file: en_US.yml - German language file: de_DE.yml Configs remain in English for clean and consistent administration. ---

Compatibility

VRX Clans v1.0.4 officially supports:

Paper 1.20+
Purpur 1.20+
Java 17+

Bukkit and Spigot are not officially supported. ---

Recommended Update Steps

1. Stop your server. 2. Create a backup of your plugin folder and database. 3. Upload the new plugin version. 4. Start the server. 5. Check the console for update messages. 6. Compare your config files with the new default config. 7. Add missing config sections if needed. 8. Test the new commands and GUI features. ---

Thank You

Thank you for using VRX Clans. This update makes clans more customizable, more social, more competitive and easier to manage.

VRXClans v1.0.3

General

- Plugin version updated to 1.0.3. - Prepared compatibility for Paper 1.20 up to 1.26+. - Refactored the project into a more stable and modern structure.

Performance & Database

- Switched database access to HikariCP connection pooling. - Separated clan data handling into cleaner repository, service, and cache structures. - Added a migration system for future database changes. - Optimized region protection using chunk-based caching. - Clan vaults are now only saved when they were actually modified.

Clan System

- Added clan logs for: - Deposits - Withdrawals - Kicks - Promotions and demotions - War events - Diplomacy events - Clan roles can now be renamed in the GUI. - Ally, rival, and neutral requests now expire after a configurable timeout. - Added war kill-farming protection. - Added configurable clan level rewards.

Commands

- Added /clan top with categories: - level - bank - kills - kdr - Added /clan logs. - Added /clana inspect. - Improved TabComplete for /clan: - Subcommands - Clan names - Player names - Top categories - Diplomacy actions - War wagers - Bank amounts

GUI

- Added an admin inspect GUI for clans. - Expanded the roles and permissions GUI. - Improved clan vault handling. - Optimized GUI navigation and displays.

Bug Fixes

- Fixed a bank exploit with negative amounts. - Fixed vault persistence after server restarts. - Fixed XP level-ups when receiving large amounts of XP. - Fixed join cooldown reset. - Improved SQL safety. - Reworked async chat handling to use Paper-compatible events.

<div align="center">

Version 1.0.2 - The "Enterprise & Sovereignty" Update

This major update transforms VRX Clans into a high-end solution for competitive servers. We have introduced deep gameplay mechanics like base upgrades and dynamic permissions, while significantly hardening the plugin’s core with WorldGuard integration and major performance optimizations. </div> ---

New Gameplay Features

Holograms & Leaderboards (Seasons)

Live Rankings: Full integration for DecentHolograms*! You can now display the Top 5 clans based on Kills, Level, or Bank Balance directly at your spawn. Season System:* Admins can now end a season using <kbd>/clana endseason</kbd>. The winning clan receives a customizable reward, and statistics are reset for the next competitive cycle.

Passive Base Effects (Upgrades)

Strategic Advantages:* Clans can now purchase permanent upgrades in the Clan Shop. Regeneration & Saturation:* Once unlocked, all clan members automatically receive healing and saturation effects while standing within their protected base radius.

Dynamic Rank System (Custom Permissions)

Full Customization: A brand new GUI for Clan Leaders! You can now individually set permissions for every rank (Recruit, Member, Officer, Co-Leader*). Decide exactly who is allowed to invite players, withdraw money, use the shop, or declare wars. ---

Security & Administration

WorldGuard Integration

Region Protection:* Clan bases can no longer be established within existing WorldGuard regions. This prevents players from "base-squatting" in spawn areas or other players' protected claims. Admin Bypass:* Added the <kbd>vrxclans.admin.bypass</kbd> permission. Administrators with this node can ignore all clan protections to perform maintenance or enforce server rules. --- <details> <summary><b> Technical, Performance & Bugfixes (Click to expand)</b></summary> Silk-Touch Fix:* Resolved an exploit where players could place and mine diamond ores repeatedly to farm clan quests. Inventory Safety:* Fixed a critical "Async Inventory" crash. Clan Vaults are now safely cached via Base64 on the main thread before being saved to the database. GUI Refinement:* Corrected all YAML indentation issues. Menus now load perfectly without missing items or alignment errors. Move-Event Optimization:* Rewrote the player movement logic. The server now only performs coordinate calculations if a player is actually in the process of teleporting, drastically reducing idle CPU usage. Optimized Save Engine:* The asynchronous saving logic for MySQL and SQLite has been refined to ensure zero TPS drops during high-frequency data writes. </details> ---

⚠️ INSTALLATION NOTE > Please delete your old gui_default.yml, config.yml, de_DE.yml and en_US.yml before restarting your server. This allows the plugin to generate the new menu structures required for the Permission System and Base Upgrades.

The Ultimate Enterprise Update (v1.0.1)

This massive update brings highly requested features and backend optimizations, turning VRX Clans into a robust, enterprise-level solution for your server!

New Features & Gameplay

PlaceholderAPI Integration:* An absolute must-have for server owners! We added full support for PlaceholderAPI. You can now use placeholders like %vrxclans_name%, %vrxclans_level%, or %vrxclans_members_online% in your scoreboards, tab lists, or holograms. Clan Quests & Daily Missions:* Introducing the new "Clan Quests" GUI! Clans can now work together to complete daily tasks (e.g., "Mine 1,000 Diamond Ores", "Kill 5,000 Zombies", or "Deposit $10,000"). Completing these missions rewards the clan with massive XP and heavily boosts teamwork. Clan Wars & KDR Tracking:* We added competitive stat tracking! The plugin now tracks Kills and Deaths (KDR) for every clan. You can declare war using /clan war <Clan> <Wager>. Once accepted, the war begins—the first clan to reach the kill target (e.g., 50 kills) takes the entire wager pot! Discord Webhooks:* Keep your community engaged outside of Minecraft! The plugin now automatically sends beautiful, color-coded embed messages to your Discord server whenever a clan is created, levels up, or wins a war.

Performance & Security

MySQL & SQLite Database Support:* We upgraded the storage engine! You are no longer restricted to standard YAML files. Use the lightning-fast local SQLite database, or connect to an external MySQL database (perfect for huge data amounts and BungeeCord/Velocity synchronization). Asynchronous Auto-Save:* Protect your players' progress! A new asynchronous scheduler quietly saves all Clan XP and Bank data in the background every 10 minutes without causing any server lag. Say goodbye to data rollbacks during sudden server crashes. 100% GUI Click Security (Anti-Glitch):* We completely hardened the inventory click events. Advanced exploits like hotbar-swapping (using number keys 1-9), shift-clicking, and offhand-swapping to steal or dupe items from GUIs are now entirely blocked server-side.