ClansPlus - A clan plugin 2.1

A Minecraft plugin that allows players to create and manage their own clan.

This software runs on Spigot and NMS.
Spigot forks without compiled NMS code are not supported.
Officially supported servers are spigot, paper, and folia.
You must use Java 11 or newer.

1. A lot of options for players to manage and control their clan.
2. Automatically updating files if there is a new update.
3. Configurable messages, GUI, etc.
4. Clan skills management.
5. Custom clan icon including Material and Custom head
6. Supporting Discord
7. Supporting API.
8. Supporting GUI.
9. Supporting Hex Color.
10. Supporting BossBar.
11. Supporting Floodgate (GeyserMC).
12. Easily managing plugin database.

Images














[/SPOILER]

You might need these plugins to utilize all plugin features:

1. PlaceholderAPI
   
   1. Clan Info Placeholders:
      
      1. %clanplus_clan_name%
      2. %clanplus_clan_customname%
      3. %clanplus_clan_formatname%
      4. %clanplus_clan_owner%
      5. %clanplus_clan_message%
      6. %clanplus_clan_score%
      7. %clanplus_clan_warpoint%
      8. %clanplus_clan_warning%
      9. %clanplus_clan_maxmembers%
      10. %clanplus_clan_createddate%
      11. %clanplus_clan_format_createddate%
      12. %clanplus_clan_members%
      13. %clanplus_clan_allies%
      14. %clanplus_clan_skilllevel_%
      15. %clanplus_clan_subjectpermission_%
      16. %clanplus_clan_format_subjectpermission_%
      17. %clanplus_clan_discordchannelid%
      18. %clanplus_clan_discordjoinlink%

Player Info Placeholders:

1. %clanplus_player_rank%
2. %clanplus_player_format_rank%
3. %clanplus_player_joindate%
4. %clanplus_player_format_joindate%
5. %clanplus_player_scorecollected%
6. %clanplus_player_lastactivated%
7. %clanplus_player_format_lastactivated%

PlayerPointsVaultVaultUnlocked (for Folia Servers)

1. /clansplus
2. Main command for players:
   
   1. create
   2. accept
   3. reject
   4. leave
   5. spawn
   6. list
   7. menu
   8. chat
   9. pvp
   10. event
   11. info
   12. setting
   13. upgrade
   14. invite
   15. kick
   16. setspawn - clanplus.setspawn
   17. seticon - clanplus.seticon
   18. setpermission - clanplus.setpermission
   19. setowner
   20. setmanager
   21. removemanager
   22. requestally
   23. setcustomname - clanplus.setcustomname
   24. setmessage - clanplus.setmessage
   25. disband

IMPORTANT:
Each clan has its own permission system. Clan owners manage member capabilities.

NOTE:
Only clan owners can disband clans and manage clan permissions.

1. /clansplusadmin - clanplus.admin
2. Admin commands:
   
   1. reload
   2. transferPluginDatabaseType
   3. setClanData
   4. setClanSkillData
   5. setPlayerData
   6. event
   7. backup
   8. delete
   9. chatspy
   10. clanresetall

2.0

1. Fixed: Console spam when shutting down the server.
2. Fixed: Bossbar for clan war events not showing to players who just joined the server.
3. Fixed: Clan war score history was retained even when players left the clan or the clan was deleted. This fix also resolves related bugs such as data errors and score bugs.
4. Fixed: Items in the icon type material menu not displaying properly and causing console spam. Unavailable items will now display as "N/A" and can be customized in the inventory config.
5. Fixed: Console spam when players use END_CRYSTAL.
6. Optimization: Switched to Paper's async chat system to optimize features using chat boxes.
7. Feature Added: Option to toggle join notifications, including clan war and player clan announcements.
8. Feature Added: Configurable delay for the two notifications above when a player joins the server.
9. Command Added: /clanadmin clanresetall (type) to reset all clan stats including score, war points, and warnings.
10. Behavior Change: Due to Folia API limitations, chat box input for inventory list searches has been replaced with a sign-based input method and player timeout.
11. Localization: Prepared "inventory" data for setup, but not yet implemented due to complexity (update time is uncertain ).
12. Optimization: Further code refactoring and cleanup in several areas.
13. Hot fix 1: Fixed sign input does not work properly
14. Hot fix 2: Fixed event to handle player shooting not working properly

1.9

1. Fixed: Players using the default clan name can still use spaces and the & character.
2. Fixed: Several issues that caused excessive console spam.
3. Fixed: Menu errors in the latest Minecraft server versions.
4. Fixed: Server crashes or lag caused by using Discord webhooks.
5. Fixed: Clan members (non-leaders) were able to upgrade clan slots.
6. Fixed: /clan deny could not be used to reject invitations.
7. Optimization: Refactored and optimized code in several areas.
8. Localization: Translated some parts of the plugin/interface to English.

1.8

1. Support for Folia (Folia on PaperMC) (Related PR) (Thanks to @TypicalShavonne)
2. Restored support for some particles
3. Utilized async teleportation, which makes teleporting smoother and reduces server lag
4. Added English (en) language file
5. Support for SuperVanish and other vanish plugins: Players who are vanished will no longer appear in the invite list and will be shown as OFFLINE in the member list if they are vanished. Added an option in config.yml to toggle this feature (vanish-settings)
6. Fixed: Stats from previous clan wars no longer carry over into new clan wars
7. Fixed: Players using ender pearls or other throwable items (except arrows) could previously damage clan members — this is now resolved
8. Fixed: A display bug where transferring manager role incorrectly said "leader role transferred"
9. Fixed: The %by% placeholder not working when transferring the manager role

1.7

1. Fixed the %rank% placeholder not working when upgrading clans
2. Added /clan upgrade point button in the upgrade interface
3. Added a config option to disable using chat boxes with a keyword
4. Fixed PlaceholderAPI being spammed: https://mclo.gs/MZzRTyy
5. Fixed error: https://mclo.gs/Z6LN5Ka (from @tepriu)
6. Fixed issue where creating a clan did not cost moneyFixed several other minor bugs

1.6

1. Added clanplus.setspawn permission to allow setting the clan spawn.
2. If a player had set a spawn in a blacklisted world before this update, they will not be able to teleport to that world.
3. Fixed a bug where players could shoot and damage members of their own clan or allied clans with a bow, even if PvP was disabled for them (Thanks to @HenShino)
4. Added PlaceholderAPI support for clan ranking placeholders:
5. %clanplus_top_score_name_% – Gets the name of the clan in the top rank.
6. %clanplus_top_score_value_% – Gets the score of the clan in the top rank.
7. Players will not be able to set spawn in worlds that are blacklisted.
8. Added a blacklist for worlds when setting spawn (configurable in the config file).

1.5

1. Dropped DiscordSRV support in favor of Webhooks.

1.4

1. Fixed an error that causes money is not given for floodgate player-
2. Fixed the issue where faction war did not grant points for mobs and MythicMobs.
3. Fixed the issue where the console was spammed, and the faction war event could not be ended using a command or when the time ran out (Error log) (Reported by @HenShino).
4. Fixed the issue where the console was spammed during combat when a faction war event was active (Error log) (Reported by @HenShino).
5. Added support for all the latest Minecraft versions and updated the API.
6. Added new permissions:
   - clanplus.setpermission - Customize faction permissions.
   - clanplus.setmessage - Customize faction messages.
   - clanplus.seticon - Customize faction icons.
   - clanplus.setcustomname - Customize faction custom names.

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories> 

<dependency>
    <groupId>com.github.CortezRomeo</groupId>
    <artifactId>ClansPlus</artifactId>
    <version>VERSION</version>
</dependency> 

// Initialize plugin API
ClanPlus clansPlusAPI = Bukkit.getServicesManager().getRegistration(ClanPlus.class).getProvider();

String clanName = "HelloClan";

if(!clansPlusAPI.getPluginDataManager().getClanDatabase().containsKey(clanName))
    clansPlusAPI.getPluginDataManager().loadClanDatabase(clanName);

IClanData clanData = clanPlusAPI.getPluginDataManager().getClanDatabase(clanName);

String playerName = "Cortez_Romeo";
clansPlusAPI.getClanManager().addPlayerToAClan(playerName, clanName, false);
clansPlusAPI.getPluginDataManager().getPlayerDatabase(playerName).setRank(Rank.LEADER);
clanData.setOwner(playerName);
clanData.setMessage("This is the first message of this clan!");
clanData.setCustomName("&bSuper Clan");
clansPlusAPI.getClanManager().alertClan(clanName, "Have a good day!");
clansPlusAPI.getPluginDataManager().saveClanDatabaseToStorage(clanName, clanData);

Contact
Report a bug or need help with something? You're welcome to my discord server

bStats - ClansPlus