TreexClans

For Developers

• I developed a smart technology for the new Storage system called BaseSection. It allows your addons to store any custom data directly in the plugin's own storage, so you no longer have to implement your own storage system. Why is it "smart"? Because even if a server owner switches the storage backend from YAML to SQLite or anything else in the future, your code won't need any changes. You won't have to adapt your addon for each storage implementation—the data will automatically be routed to the correct backend. This system is the main reason why this update took longer than expected. And yes, BaseSection is fully asynchronous, powered by CompletableFuture.
• You can now create custom permissions for ranks. Example:

Permission permission = PermissionRegistry.register("glow");
if (member.getRank().hasPermission(permission)) {
  // yes
} else {
  // no
}

The registered permission can then be assigned to a rank by its ID directly in the config or GUI.

For Users

• Added a clan storage filter:

clan-storage:
  filter:
    type: BLACKLIST # or WHITELIST
    materials:
      - BEDROCK
      - BARRIER

• Along with BaseSection, SQLite and MySQL support has been added. These storage implementations are currently experimental and may receive improvements in future updates. YAML remains the stable backend, just as before.

• The /treexclans reload command has been improved. However, storage is no longer restarted during reload, since doing so could slow down the reload process.

• The RanksGui model has been slightly changed:

  • Instead of type: all_ranks, use rank: all, or instead of type: leader_rank, use rank: leader.
  • You can now also define any custom rank and give it a unique style in the menu, for example rank: manager.

• Fixed placeholders:

  • %clan_tag%
  • %clan_prefix%

• New placeholder:

  • %clan_addon_status_<id>% — Returns true if an addon with the specified ID is loaded; otherwise returns false.

• Added the /clan rename command to change a clan's tag.

• Added the /clan transfer command to transfer clan ownership to another player.

New admin commands:

▪ /tc clan <clan> disband - Disband a clan
▪ /tc clan <clan> rename - Change the clan tag
▪ /tc clan <clan> setprefix - Change the clan prefix
▪ /tc clan <clan> setslogan - Change the clan slogan
▪ /tc clan <clan> balance - View the clan bank balance
▪ /tc clan <clan> withdraw - Withdraw money from the clan bank
▪ /tc clan <clan> deposit - Deposit money into the clan bank
▪ /tc clan <clan> base - Teleport to the clan base
▪ /tc clan <clan> resetbase - Remove the clan base
▪ /tc clan <clan> transfer - Transfer clan ownership
▪ /tc clan <clan> chest - Open the clan storage

▪ /tc reset_storage - Clear the storage database

• While testing the plugin, I discovered a potential vulnerability where players could use any PlaceholderAPI placeholder in /clan setslogan and /clan chat, causing it to be parsed. This has been fixed.

• Internal placeholders now use the {placeholder} format instead of %placeholder% for better clarity and to distinguish them from PlaceholderAPI placeholders.