ВЕРСИИ (7)

## VRX Clans 1.0.6 - Fixed clan leaders not being able to kick members properly - Improved startup loading and database safety - Added better Spigot, Bukkit, Paper, Purpur and Folia support - Improved autosaving and database performance - Improved database migrations and upserts - Improved shutdown saving - Improved language system - Made GUIs more configurable - Added more detailed permissions - Fixed several smaller bugs and stability issues

# 🚀 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 ```text /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: ```text MONEY ``` or: ```text 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: ```text $10,000 ``` a clan could be required to pay: ```text 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: ```text 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: ```text +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 ```text /clan prestige ``` ### Example Progression ```text 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: ```text 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: ```text Claim Expansion Required Prestige: 1 ``` or: ```text 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 ```text /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 ```text /clan event create <Name> /clan event list /clan event join <Event> /clan event cancel <Event> /clan event complete <Event> ``` ### Example Events ```text 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: ```text Achievement: Event Team Requirement: Complete 10 Clan Events ``` Possible rewards: ```text 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 ```text /clan contracts /clan contract start <ID> /clan contract progress ``` ### Example Contracts ```text 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: ```text 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: ```text Contract: Zombie Hunters Objective: Kill 500 Zombies ``` Progress is shared between all clan members. --- ## 💰 Economy Contracts Contracts can also use clan economy progression. Example: ```text 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: ```text 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: ```text 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 Shield System Clans can now receive temporary protection through the new Clan Shield System. ### New Commands ```text /clan shield /clan shield activate /clan shield status ``` The shield system is especially useful for PvP, Survival and competitive clan servers. --- ## ⚔️ War Protection While a Clan Shield is active: - Other clans cannot start a war against the protected clan - War requests against the protected clan can be blocked - Protected clans cannot be repeatedly targeted immediately after losing wars This prevents smaller or weaker clans from being permanently farmed. --- ## 🏰 Territory PvP Protection Clan Shields can provide additional protection inside a clan's own territory. While enabled: - Enemy PvP can be blocked inside protected claims - Clan bases become temporarily safer - Players have time to rebuild after major conflicts This behavior can be configured by server owners. --- ## 🆕 New Clan Protection Newly created clans can automatically receive a temporary Clan Shield. Example: ```text New Clan Protection: 24 Hours ``` This gives new clans time to: - Recruit members - Build their base - Gather resources - Prepare for PvP - Establish territory without immediately becoming a target. --- ## 💀 Protection After Losing a War Clans can automatically receive protection after losing a clan war. Example: ```text War Lost → Clan Shield activated for 6 hours ``` This prevents repeated war farming and gives the losing clan time to recover. --- ## 🔐 Manual Clan Shield Authorized clan members can manually activate their shield. ### Command ```text /clan shield activate ``` Manual activation can require: - Clan bank money - Physical items This uses the same flexible payment system as the clan shop. --- ## 💎 Item-Based Shield Activation Clan Shields can also require physical Minecraft items. Example: ```text Shield Activation: 16 Diamonds ``` instead of: ```text $25,000 ``` This allows servers to create rare defensive resources or special shield tokens. --- ## ⏳ Shield Cooldown Manual Clan Shields have configurable cooldowns. Example: ```text Shield Duration: 12 Hours Cooldown: 48 Hours ``` This prevents clans from permanently staying protected. --- ## 📊 Shield Status Players can check their clan's current protection status. ### Command ```text /clan shield status ``` The status can show: - Whether the shield is active - Remaining shield duration - Remaining cooldown - Current protection state --- ## 🗄️ Persistent Progression The new systems are stored permanently. This includes: - Territory claims - Additional claim slots - Prestige - Prestige Points - Clan Events - Event progress - Clan Contracts - Contract progress - Shop vouchers - Clan Shield duration - Clan Shield cooldown Clan progression therefore remains available after server restarts. --- ## 🌍 Language Support VRX Clans continues to provide separate language files. ```text Languages/en_US.yml Languages/de_DE.yml ``` - `en_US.yml` contains English messages - `de_DE.yml` contains German messages - Main configuration files remain in English --- ## ⚙️ New Configuration Options Version 1.0.5 introduces new configuration sections for: ```text Territory Claims Claim Protection Claim Limits WorldGuard Claim Protection Physical Item Payments Extended Shop Payments Prestige Prestige Rewards Prestige Tag Colors Prestige Shop Requirements Clan Events Event Rewards Clan Contracts Contract Rewards Shop Vouchers Prestige Points Clan Shields New Clan Protection War Loss Protection Manual Shield Activation Shield Cooldowns Territory PvP Protection ``` Server owners can configure these systems to match their own server economy and gameplay style. --- ## ✅ New Commands Overview ### Territory ```text /clan claim /clan unclaim /clan map /clan claims ``` ### Prestige ```text /clan prestige /clan top prestige ``` ### Clan Events ```text /clan event create <Name> /clan event list /clan event join <Event> /clan event cancel <Event> /clan event complete <Event> ``` ### Clan Contracts ```text /clan contracts /clan contract start <ID> /clan contract progress ``` ### Clan Shield ```text /clan shield /clan shield activate /clan shield status ``` --- ## ⚡ Performance The new territory system is designed around chunk-based claim handling. This helps keep protection checks efficient even on servers with many clans and claimed chunks. Existing optimizations such as cached clan leaderboards and optimized database handling remain part of VRX Clans. --- ## 🎯 Long-Term Progression Version 1.0.5 significantly expands the long-term progression of VRX Clans. Clans can now progress through: ```text Clan Levels Achievements Clan Quests Clan Contracts Clan Events Territory Expansion Shop Upgrades Prestige Prestige Points War Progression Leaderboards ``` This gives both casual and competitive clans more reasons to remain active over long periods of time. --- ## ✅ Compatibility VRX Clans v1.0.5 officially supports: ```text Paper 1.20+ Purpur 1.20+ Java 17+ ``` Bukkit and Spigot are not officially supported. --- ## 📌 Update Recommendation Before installing the update: 1. Stop your server. 2. Create a backup of your VRX Clans plugin folder. 3. Create a backup of your database. 4. Replace the previous plugin version. 5. Start the server. 6. Check the newly added configuration sections. 7. Configure Territory, Prestige, Contracts, Events and Shields as desired. 8. Test the new systems before using them on a production server. --- ## ❤️ Thank You Thank you for using **VRX Clans**. Version **1.0.5** brings some of the biggest progression and PvP additions to the plugin so far. **Claim your territory. Grow your clan. Complete contracts. Reach Prestige. Protect your people. Conquer the server.**

# 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: ```text /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: ```text /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: ```text /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: ```text /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: ```text /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: ```text /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: ```text /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: ```text /clan motd set <Text> /clan motd clear ``` --- ### 🛒 Extended Clan Shop Upgrades The clan shop has been expanded with new upgrade options. New upgrade categories: ```text members homes vault allies rivals teleport ``` New command: ```text /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: ```text /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: ```text 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.

# **Beta**