ClanSystem v1.25.4 – Patchnotes

• New: Enhanced Redis connection diagnostics with detailed logs
• Improved: Automatic fallback to ExpiringMap on 5x Redis failures
• Fixed: NullPointerException on clan cache access

Support: Discord

ClanSystem v1.25.3 – Patchnotes

• Added: Improved Redis connection error handling
• Improved: Better resource management for Redis connections
• Fixed: Redis connection timeout issues in scheduled export tasks
• Fixed: Memory leaks from unclosed Redis connections

Support: Discord

ClanSystem v1.25.2 – Patchnotes

• Fixed: Navigation items in the Clan Members inventory now correctly use config values and can be edited.
• Improved: Refresh button in Clan Members inventory is now smoother.
• Changed: All German item names in GUIs are now in English.
• Changed: Layout of Clan Members inventory improved.
• Added: Automatic migration for inventory layout changes.
• Added: Automatic fallback to ExpiringMap if Redis is not available.

Support: Discord

- [+] Fixed Mysql error

[+] Database system is now fully flexible: supports MySQL and SQLite (auto fallback)
[+] New config option: database.type (mysql/sqlite) in database.json
[+] Redis cache support: Set database.redis.enabled to true for Redis-based cache
[+] All SQL access is now routed through a DatabaseManager interface
[+] DefaultConfig and database.json now include all necessary options for MySQL, SQLite, and Redis
[+] Improved startup logging: shows active DB type, cache type (ExpiringMap/Redis) and connection status
[+] All cache and DB operations are now fully null-safe

Update Changelog

• Improved Cache Dump Functionality:
  • The cache dump is now saved as a readable file.
  • Only the most important clan information is exported (ID, name, owner, members, tag, kills, etc.).
  • The file and its parent folder (/dumps) are automatically created if they do not exist.
  • Much easier for server admins to read or import.
  • Enable debugmode on non-production server and use /clan cache-dump
• General:
  • Minor code improvements and bug fixes related to cache handling.

Reduced file size

Members Menu is now fully YAML-based
- The members menu now uses a dedicated YAML file for its layout, title, items, and navigation.
- Title, design, and item placement are fully customizable via YAML – consistent with other GUIs.

Unknown Skull Filler (Configurable)
- New feature: empty member slots can be filled with a custom “Unknown” skull item.
- Toggleable via config:
settings.defaults.inventories.clan_members.unknown_skull_filler
- Name and lore for the skull are fully configurable.


Note:
The old xenodov GUI system has been completely removed.
All menus now use YAML/config files and are fully customizable!

Patch Notes ClanSystem - Version 1.24.5-BETA
Changes:

• Configuration Path Updates (Automatic Migration):
  • Removed: settings.database ( Not used )
  • Renamed:
    • settings.api.http.activated ➝ settings.api.https.activated
    • settings.api.http.endpoints.player.info.path ➝ settings.api.https.endpoints.player.info.path
    • settings.api.http.endpoints.clan.info.path ➝ settings.api.https.endpoints.clan.info.path
  • Removed Root Path: settings.api.http
  • All existing data will be migrated automatically if present.
    

Patch Notes ClanSystem - Version 1.24.4-BETA
Bug Fixes:

• **Fixed SSL Certificate Generation Issue: **
  • Resolved a bug where the certificate was not properly created, ensuring smooth HTTPS setup.
  • Important: After updating, delete the certificates folder located at:
    plugins/ClanSystem/certificates to generate a new working one.

Patch Notes ClanSystem - Version 1.24.3-BETA
New Features:

• [API Endpoint] Bearer Token Implementation:
  
  • Added Bearer Token authentication.
  • A unique token is generated on the first start phase, enhancing security and user identification.
• [API Endpoint] HTTPS with Automatic Certificate Generation:
  
  • Enabled HTTPS for secure communication.
  • The SSL certificate is now automatically generated, ensuring encrypted traffic without manual setup.

Changes:

• [API Endpoint] Replaced Javalin Endpoint with Jetty:
  
  • Switched from Javalin to Jetty for the server framework, improving request handling and server flexibility.
  • Routes remain unchanged, ensuring seamless functionality.
• [API Endpoint] Security Headers Implemented:
  
  • Added Strict-Transport-Security header with a max-age of 31536000 seconds (1 year) and includeSubDomains directive to enforce HTTPS across all subdomains.
  • Introduced X-Content-Type-Options header with nosniff to prevent browsers from misinterpreting file types.
  • Enabled X-XSS-Protection header with 1; mode=block to activate cross-site scripting (XSS) filtering.
  • Configured X-Frame-Options header to DENY, preventing the site from being displayed in a frame and mitigating clickjacking attacks.
• [API Endpoint] Rate Limiting with Bucket4j:
  
  
• Implemented Rate Limiting using Bucket4j.
  
  
• Users are limited to 20 tokens with a refill rate of 10 tokens per minute Every request will charge 1 Token.
  
  
• This ensures fair usage and prevents overloading of the server.
  

Patch Notes ClanSystem - Version 1.24.2-BETA
New Features:

• Customizable Contract Types:
  • Added a new config option to define which contract types can be generated.
  • Located under: settings.contracts.generator.types
  • Available types atm: KILL, ORE

Performance Improvements:

• Optimized Config Handling:
  • Improved how contract types are stored and retrieved, reducing unnecessary file reads.
  • Default values are now handled more efficiently to prevent redundant lookups.

Patch Notes ClanSystem - Version 1.24.1-BETA
Changes:

• Inventory Settings Migration:
  • Config overhaul: All inventory settings have been migrated from config.json to the new inventories.json.
  • Data is automatically updated, with missing values replaced by defaults.
• Code Cleanup:
  • Consolidated the ClanPlayer registration logic to eliminate redundancy and streamline the codebase.
• Database Connection Optimization:
• Explicitly closed PreparedStatement and Connection objects for better resource management and to avoid potential leaks.

• Performance Boost:
  • Reduced overhead by eliminating unnecessary String.format calls in SQL queries and improving the handling of Clan base location data.

Patch Notes ClanSystem - Version 1.24.0-BETA
Bug Fixes:

• Fixed Critical Inventory Bug:
  • Resolved a major issue where the new Clan Rewards Inventory was mistakenly overwritten onto the Contract Inventory.
  • The inventories now function independently as intended.

Patch Notes ClanSystem - Version 1.23.9-BETA
New Features:

• Added Clan Contracts Rewards Menu:
  • Implemented a new menu for viewing and claiming Clan Contracts rewards.
  • Players can now easily access their earned rewards through this interface.
  • The new inventory file includes a dedicated area for rewards, represented with placeholders.
  • This can be managed with the following commands:
    • /clan ri clan_rewards – View and edit the Clan Rewards inventory.
    • /clan si clan_rewards – Save changes to the Clan Rewards inventory.

Bug Fixes:

• Fixed Incorrect Corrupt File Name in Clan Contracts GUI:
  • Previously, when an inventory error occurred in the Clan Contracts GUI, an incorrect file path (AdminSettings Path) was displayed as corrupt in the chat.
  • Now, the correct inventory file name is shown instead.
• Removed Unused Code:
  • Cleaned up unused code to improve readability and maintainability.

To get the new main menu, just delete the main_inventory.json file in plugins folder

Patch Notes ClanSystem - Version 1.23.8-BETA
Changes:

• Removed Unnecessary Broadcast Messages:
  • Reviewed all broadcast messages and removed those not needed in the production environment.
• Removed Unused Code:
  • Cleaned up unused code to improve readability and maintainability.

Patch Notes ClanSystem - Version 1.23.7-BETA
Bug Fixes:

• Fixed Dynamic Money Reward Issue:
  
  • Resolved a bug where players did not receive the correct dynamic money amount.
  • The issue was caused by an double to int cast error, which has now been fixed.
• Fixed ItemPack Custom Name Color Issue:
  
  • Items in ItemPacks with custom-colored names were not displaying colors correctly in-game.
  • This issue has been resolved, and you can now use &6 and other color codes to set item names properly.

Changes:

• Removed Unnecessary Debug Messages:
  
  • Two debug messages in the ContractManager were removed as they were visible even when debug mode was disabled.
• Removed Unused Code:
  
  • Cleaned up unused code to improve readability and maintainability.

Patch Notes ClanSystem - Version 1.23.6-BETA
New Features:

• Cash Rewards for Clan Contracts:
  • Added a dynamic cash reward system for Clan Contracts based on player contribution.
  • The more a player contributes to the contract, the higher their reward.
  • Example: If a player completes 40% of a contract, they receive 40x the cash reward.
  Cash reward format:
  • Defined in the config as: money:[min-max]
  • Example: money:10-50 → A random value between 10 and 50 is generated and then multiplied by the player's contribution percentage (e.g., 40x for 40% contribution).
  • Fixed a bug that occurred when you completed a contract. You now receive the correct % of the participation.

Bug Fixes:

• Fixed Vault Bug:
  • Resolved an issue with Vault integration, ensuring proper functionality.
• Fixed a bug that broadcast messages were there without debug mode.

Changes:

• Removed Useless Code:
  • Cleaned up unnecessary code to improve maintainability and performance.

Patch Notes ClanSystem – Version 1.23.4

Changes

• Changed the default output of the placeholder %clansystem_tag% from NO_CLAN to an empty string.

Patch Notes ClanSystem – Version 1.23.3

New Features

• Added sub_permissions to the commands.json file.
  • system.commands.clan.admin
• Added a new command: /clan admin
  • This command allows admins with the system.commands.clan.admin permission to manage clan-related administrative tasks.
  • The command can also be executed via the console.
    
    
    

Do you want to increase the maximum number of members in a clan? Np with the update you can run /clan admin increase_max_members clanname

Patch Notes

Bug Fixes

• Fixed the tag change bug where the tag would incorrectly be set to "yes" after being updated.

Patch Notes

Clan Stats Adjustments

• § has been replaced with &.
• Added a new feature: Clan Alliances! Clans can now collaborate more closely.

Clan Alliances Integration

• Use /clan alliance <name> to invite another clan to form an alliance.
• The invited clan can accept the invitation with /clan accept <clan_name> or decline with /clan deny <clan_name>.
  • Only Clan Admins or Owners can manage alliance invitations.
  • Note: Alliance invitations expire after 5 minutes if no response is received.

In Progress

• A feature to remove existing alliances is currently under development.

Code Cleanup

• Unused code has been removed to improve efficiency.

Clan Help Command

• The /clan alliance command has been updated with a new description text.

ClanSystem Patch Notes – Version 1.23.0
Bug Fixes:

• Fixed a bug preventing PLAYER_HEAD textures from loading correctly.

ClanSystem Patch Notes – Version 1.22.9
Changes:

• Moved database connection settings from config.json to a new file named database.json.
  • The plugin automatically migrates data from config.json to database.json during an update if database settings are present. No manual action is required by users.

New Features:

• Clan Alliances:
  • Prepared the system for clan alliances.
  • A new database table is created for alliances.
  • PvP between allied clans is automatically disabled if alliances are manually added to the table.

Bug Fixes:

• Fixed an issue during startup caused by an incorrect database connection.
• Fixed an issue during plugin stop caused by an http server close.

Improvements:

• Adjusted the error message displayed in the console during startup to clarify when the database connection cannot be established.

Bug Fixes:

• Fixed the /clan setbase command to ensure it can only be executed by players with Admin permissions or higher.
• Removed two empty items from the language file that were left over and unnecessary.

Improvements:

• Moved the text for the /clan setbase command into the language file for better customization.
• Moved the text for the /clan rewards command into the language file for better customization.
• Moved the text for the /clan base command into the language file for better customization.

Changes:

• Removed the /clan contract command from production it is now only available in Debug mode.
  • This command is not yet suitable for production use. Please use the GUI for managing contracts.

Bug Fixes:

• Removed a debug message from production that appeared when clicking on "contracts" in the GUI.

New Features:

• Added new text for the commands /clan rewards and /clan claim <rewardId>.

Update Instructions:

• After updating the plugin, manually delete the commands.clan.usage entry in the commands.json file, then restart the server.

## Bug Fixes:
- Fixed an issue where "Generated keys not requested" errors occurred.

Bug Fixes:
- Fixed an issue that prevented the plugin from creating tables in the database.

# ClanSystem Patch Notes – Version 1.22.3

## New Features:
- **Contract Rewards:**
- Added contract rewards
- /clan rewards || clan claim <RewardID>

## Changes:
- **Database Update:**
- The database tables need to be deleted manually due to adjustments made for the new RewardSystem.

ClanSystem Patch Notes – Version 1.22.2
New Features:

• Contract Inventory:
  • Added a new Contract Inventory to enhance functionality.
• Contract Manager:
  • Logic for creating, managing, and updating contracts.
  • Method: createInitialContractsForClan generates the first three contracts for a clan.
  • Method: incrementProgress updates contract progress based on player actions (e.g., kills or resource gathering).
  • Method: generateRewardsForContractCompletion generates rewards for all clan members after a contract is completed.
• Contract Scheduler:
  • Monitors contract deadlines
  • Marks expired contracts as "FAILED."
    
  • Checks completed contracts and assigns rewards.
    
  • Dynamically assigns new contracts **12 hours** after completion or failure for clans with completed or failed contracts.

Bug Fixes:

• Fixed an error in the InventoryClickListener that occurred when the inventory was not available as a file.

Changes:

• Updated the Main Inventory.
  • Note: The old inventory file must be deleted manually for the changes to take effect.
• Database Update:
  • The database tables need to be deleted manually due to adjustments made for the new Contract System.

Bug Fixes:

• Connection-Handling für SQL-Queries:
  • Correctly implemented connection closure to avoid errors like "No operations allowed after connection closed."
• Foreign-Key-Constraints:
  • Adjusted database tables to ensure all foreign keys are correctly defined.
• Zeitlogik im Scheduler:
  • Scheduler now accurately processes contracts even when checks occur shortly after 12:00 AM or midnight.

ClanSystem Patch Notes – Version 1.22.1
New Features:

• /clan leave Command:
  • Added a new command that allows players to leave their clan.
  • Note: Clan founders cannot leave their clan.

Updates to Language File:

• Added two new language entries:
  • commands.clan.leave.failure.leader:
    
    • Default: refix: &cYou cannot leave your own clan.
  • commands.clan.leave.success.left:
    
    • Default: refix: &7You left the clan.

ClanSystem Patch Notes – Version 1.22
New Features:

• HTTP API Integration:
  • Added a new endpoint to the HTTP API:
    • /v1/plugin/clan/{clan_id}
  • This endpoint allows external requests to retrieve information about a specific clan by its ID.

New Config Settings:

• settings.api.http.endpoints.clan.info.path
  • Defines the endpoint path for retrieving clan information.
    

ClanSystem Patch Notes – Version 1.21.9
New Features:

• HTTP API Integration:
  • Introduced an HTTP API using Javalin to allow external requests to the ClanSystem.
    
    
  • Responses are returned in JSON format and include rate-limiting for security and performance.
    
    • Rate Limit: 5 requests per minute, per route, per IP.
  • Javalin will utilize Virtual Threads if running on JDK 21 or higher, improving concurrency and scalability.
    

New Config Settings:

• settings.api.http.activated
  
  • Default: false
  • Enables or disables the HTTP API.
• settings.api.http.port
  
  • Default: 8080
  • Specifies the port on which the HTTP API runs.
• settings.api.http.endpoints.player.info.path
  
  • Default: /v1/plugin/player/{uuid}
  • Defines the endpoint path for retrieving player information.

ClanSystem Patch Notes – Version 1.21.8
New Features:

• /clan delete Command:
  • Added a command that allows a clan owner to delete their clan.
    
    
  • A new config value determines the maximum number of members a clan can have for the owner to delete it.
    • Default: 1
  • This ensures larger clans cannot be deleted without meeting the member limit condition.
    

Changes:

• Changed the default clan tag from MiniMessage format to a standard format.
• Replaced the .zip file with a .jar file. Inventories are now fully integrated into the system, making them independent of external files.

Improvements:

• Added a check to the /clan setbase and /clan base commands to verify whether the user is in a clan before execution.

ClanSystem Patch Notes – Version 1.21.7
New Features:

• Webhook Integration for Clan Creation:
  • Added a webhook that triggers when clans are created.
    
    
  • This feature is disabled by default but can be configured under:
    
    • settings.defaults.webhooks.clancreate.*
  • For existing users, the config.yml will automatically update with the default values, keeping the feature disabled.
    
    
  • In the webhook text, the following placeholders are available:
    
    • %nl% - Inserts a new line.
    • %clan_name% - Displays the name of the newly created clan.

Improvements:

• Removed unused code to improve maintainability and reduce clutter.

Upcoming Features:

• /clan delete Command:
  • A new command to delete clans will be added in the next update.

ClanSystem Patch Notes – Version 1.21.6
New Features:

• Webhook Integration:
  • Webhook functionality has been added but is not yet configurable.
  • Configuration options for webhooks will be available in the next update.

Changes:

• Removed remaining broadcast messages from production.
  • Broadcasts will now only appear when debug mode is enabled.

Improvements:

• Optimized the code and removed unused code to improve performance and maintainability.

x

ClanSystem Patch Notes – Version 1.21.5
New Features:

• /clan base Command:
  • Players will now be teleported within 3 seconds if they don't move after using the command.
    
    
  • The teleport delay can be customized in the config.yml under:
    
    • settings.defaults.clan.base_command.teleport_seconds
  • New Permission:
    
    • system.commands.base.fasttp:
      • Grants the ability to skip the 3-second teleport delay when using the /clan base command.

ClanSystem Patch Notes – Version 1.21.4
New Features:

• Made texts translatable for the following sub-commands:
  • /clan create
  • /clan invite
  • /clan kick
  • /clan members
  • /clan stats
  • Plus a few other items for better localization support.

ClanSystem Patch Notes – Version 1.21.3
New Features:

• Settings Inventory:
  • The placeholder item in the top-left corner has been completed.
  • It now displays:
    • The clan owner's name.
    • The number of clan members.
  • Note: To apply this change, you need to replace the inventory file for Admin Settings.
    

Bug Fixes:

• Fixed an issue in the settings menu where clicking outside the screen caused unexpected behavior.

ClanSystem Patch Notes – Version 1.21.2
Bug Fixes:

• /clan ri
  • Fixed an issue where items were not placed in the inventory, and only the chest name was updated.

ClanSystem Patch Notes – Version 1.21.1
New Features:

• Command: /clan ri <filename>
  • Loads an inventory from the folder plugins/ClanSystem/inventories/saver using the specified filename.
  • The next chest you click will be filled with the inventory items, allowing you to edit the inventory directly.
  • Save the edited inventory again using /clan si <filename>.

Quality of Life Improvements:

• Command: /clan si <filename>
  • If the specified filename already exists, you will be asked if the file should be overwritten. Simply confirm by typing yes in the chat.

PlaceholderAPI Integration:

• %clansystem_member_rank%: Displays the clan rank of a member.
• %clansystem_tag%: Displays the clan tag.

Changes:

• Updated the grid name in the main inventory to improve user experience and provide clearer labeling.
  • Note: :rotating_light: You will need to manually replace the file for this change to take effect.

Added missing invs.