T-Clans - Unique clans system

The unique clan system. The clans system supports PlaceholderAPI and Vault.
The ranking system can be integrated with Bedwars1058 and T-MiniGameAPI.

There are four different types of clan creation:

with paying (Vault integration)
with needed items
with one needed item
without items and money needed

clan management
clan groups (ranks)
clan upgrade
clan settings
ranking (points for winning, dying, losing, and killing)
integration with Bedwars1058 and T-MiniGameAPI minigames
configurable GUI
MySQL and SQLite support (Install - T-DataBaseAPI)
data synchronization between servers

Player's commands

/clan create (tag) (full name) - Creates a new clan
/clan disband - Disbands the clan
/clan manage - Opens the clan management GUI
/clan inivite (nick) - Invites the user to the clan
/clan kick (nick) - Kicks the member
/clan accept (tag) - Accepts an invitation from the clan
/clan setrank (nick) (rank) - Confer rank to the player
/clan ranking - Opens the GUI with clans ranking
/clan chat (message) or # (message) - Sends a message to clan members
/clan announcement (message) - Sends announcement to clan members
/clan leave - Leaves from the clan
/clan sethome - Sets clan's home location
/clan home - Teleports to home location
/clan info (tag) - Opens gui with clan's informations
/clan rename (new-name) - Changes clan name
/clan storage - Opens clan storage

Admin commands

/adminclan setitems - Opens a gui where you can set up the items needed to create a clan
/adminclan disband (tag) - Disbands the clan
/adminclan disbandall - Disbands all the clans
/adminclan reload - Reloads all configuration files
/adminclan migratetodb- Migrates data from YAML to SQL database

Permissions:

clan.admin - permission to access admin commands
clan.create - permission to create a clan (This permission is disabled by default)
clan.tag.colors - permission to use colors in tag

Min. Java 11

Installation:
1. Put the T-Clans plugin into the plugins directory on your server folder
2. Start server

YAML:

adminSettings:
  adminPermission: "clan.admin"
  setItemsInventoryTitle: "&aPut items"

clanSettings:
  tag:
    maxLength: 4
    minLength: 2
    upperCaseOnly: false
    allowNumbers: false

  fullName:
    maxLength: 24
    minLength: 4
    allowNumbers: true

  showTagPrefixOnChat: true
  showTagPrefixOnTab: true
  tagPrefix: '&8[&a{TAG}&8]&r '

  clanDisbandConfirmCode: "CONFIRM"

  clanCreateGlobalMessage: true
  clanDisbandGlobalMessage: true

  clanChatFormat: '&6&lCLAN-CHAT &7{RANK} &7{NICK} » &8{MESSAGE}'

  clanAnnouncementFormat: '&c&lCLAN-ANNOUNCEMENT &7» &8{MESSAGE}'
  #in minecraft ticks (20 ticks = 1 second)

  clanDisbandConfirmTime: 1200
  clanAcceptConfirmTime: 6000

  clanUpgrade:
    clanSize:
      default: 10
      upgradeStep: 2
      maxUpgradesAmount: 5

      #if false plugin will use items to purchase upgrades
      upgradeByEconomy: false
      economyStartAmount: 1000
      economyStepAmount: 500

      item: GOLD_INGOT #all items you can find here https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
      itemStartAmount: 15
      itemStepAmount: 5

  defaultClanRankingInclude: true

  clanCreatePermissionRequire: false
  clanCreatePermission: "clan.create"

  clanCreateEconomyRequire: true
  clanCreateEconomy: 1337

  clanCreateItemsRequire: true
  clanNeededItemsInventoryTitle: "&aItems needed"
  clanCreateItems:

membersGuiName: '&a&lMembers'

clanDefaultGroups:
  owner:
    displayName: '&cOwner'
    priority: 100
  co_owner:
    displayName: '&eCo-Owner'
    priority: 80
  mod:
    displayName: '&aMod'
    priority: 70
  member:
    displayName: '&9Member'
    priority: 10
ranking:
  minPointsPerKill: 1
  maxPointsPerKill: 5
  minPointsPerWin: 5
  maxPointsPerWin: 25
  minPointsPerDefeat: -25
  maxPointsPerDefeat: -5
  minPointsPerDeath: -3
  maxPointsPerDeath: -1

YAML:

clanHelp:
  - ''
  - '&7&m--[--------&r &aClan player commands &7&m--------]--'
  - ''
  - ' &f/&aclan create &f<tag> <full name> &7- Creates a new clan'
  - ' &f/&aclan disband &7- Disbands the clan'
  - ' &f/&aclan manage &7- Opens the clan management gui'
  - ' &f/&aclan inivite &f<nick> &7- Invites the user to clan'
  - ' &f/&aclan kick &f<nick> &7- Kicks the member'
  - ' &f/&aclan accept &f<tag> &7- Accepts an invitation from the clan'
  - ' &f/&aclan setrank &f<nick> <rank> &7- Confer rank to the player'
  - ' &f/&aclan ranking &7- Opens the gui with clans ranking'
  - ' &f/&aclan chat &f<message> &7or &f# <message> &7- Sends message to clan members'
  - ' &f/&aclan announcement &f<message> &7- Sends announcement to clan members'
  - ''
adminClanHelp:
  - ''
  - '&7&m--[--------&r &aClan admin commands &7&m--------]--'
  - ''
  - ' &f/&aadminclan setitems - Opens a gui where you can set up the items needed to create a clan'
  - ' &f/&aadminclan disband &f<tag> &7- Disbands the clan'
  - ' &f/&aadminclan disbandall &7- Disbands all the clans '
clanCreateGlobal:
  - '&7 ﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉'
  - '&7  &aPlayer &f{PLAYER} &r&acreated a clan &f{TAG}'
  - '&7 ﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍'
clanDisbandGlobal:
  - '&7 ﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉﹉'
  - '&7  &cThe clan &f{TAG}&c has been disbanded'
  - '&7 ﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍﹍'

creatorIsAlreadyMember: '&cYou cannot create a clan because you are already in one'
tagAlreadyTaken: '&cThis tag is already taken'
successCreateClan: '&aThe clan was created successfully'
noTagOrFullNameArgument: '&cYou have to give clan tag and full name &f/&cclan create &f<tag> <full name>'
illegalArgumentLength: '&cMinimal {TAG_OR_FULLNAME} length is&f {MIN} &cand maximum tag length is&f {MAX}'
illegalArgumentMarks: '&cYou used forbitted characters'
noPermission: '&cYou do not have access to use this command'
notEnoughItems: '&cYou do not have enough items to create a clan'
notEnoughEconomy: '&cYou do not have enough money to create a clan. Clan create cost &f${COST}'
itemsRequireDisable: '&aYou can create a clan with out any items'
successSetItems: '&aThe new items have been configured successfully'
disbandClan: '&aThe clan has been disbanded successfully'
disbandAllClan: '&aAll the clans have been disbanded successfully'
disbandWarning: '&4Warning! &cClan disband is irreversible. If you want to continue use this command &f/&cclan disband &f{CODE}'
adminDisbandWarning: '&4Warning! &cClan disband is irreversible. If you want to continue use this command &f/&cadminclan disband &f{TAG} &f{CODE}'
adminDisbandAllWarning: '&4Warning! &cClan disband is irreversible. If you want to continue use this command &f/&cadminclan disbandall &f{CODE}'
incorrectAdminClanDisbandUseCommand: '&cYou have to give clan tag f/&cadminclan disband &f<tag>'
illegalTagArgument: '&cClan with this tag not exist'
dontHaveClan: '&cYou don''t have clan'
incorrectClanInviteUseCmd: '&cYou have to give player name &f/&cclan invite &f<player>'
playerIsAlreadyMember: '&cYou cannot invite this player because is already in clan'
playerIsNotOnline: '&cThis player is not online'
invite: '&aYou have received a clan invitation to &f{TAG}&a, to join use command &f/&aclan accept &f{TAG}'
noInvite: '&cYou do not have invitation form this clan'
alreadyInvite: '&cYou have already invited this player'
successInvite: '&aThe invitation has been sent successfully'
incorrectClanAcceptUseCmd: '&cYou have to give clan tag &f/&cclan accept &f<tag>'
successAccept: '&aYou have joined to the clan &f{TAG}'
incorrectClanSetRankUseCmd: '&cYou have to give player name and rank &f/&cclan setrank &f<nick> <ranga>'
playerNoInClan: '&cThis player is not in your clan'
incorrectClanKickUseCmd: '&cYou have to give player name &f/&aclan kick &f<nick>'
successKickedMember: '&aYou have kicked &f{PLAYER}&a successfully'
kickedMessage: '&cYou have been kicked out of the clan'
rankNotExist: '&cRank &f{RANK}&c not exist'
successSetRank: '&aRank &f{RANK}&a has been successfully set to &f{PLAYER}'
incorrectAdminClanRankingUseCmd: '&cYou have to give tag and switch &f/&cadminclan ranking &f<tag> <on | off> '
changeClanRankingIncludeToOff: '&cThe clan &f{TAG}&c has no more included to ranking'
changeClanRankingIncludeToOn: '&aThe clan &f{TAG}&a is now included to ranking'
notEnoughItemsToUpgradeSize: '&cYou do not have enough items to upgrade clan size'
notEnoughEconomyToUpgradeSize: '&cYou do not have enough money to upgrade clan size.'
maxClanSize: '&cThis clan reached maximum size level. You cannot upgrade it anymore.'
successUpgradeSizeClan: '&aThe clan size has been broadened successfully to &f{CURRENT}'
successSwitchClanPvp: '&aPvp in the clan has been set to {STATUS}'
successSwitchClanPublicRanking: '&aPublic ranking has been set to {STATUS}'
removedPoints: '&7Your clan member kill someone or win game and your clan has got &a{POINTS}'
addedPoints: '&7Your clan member death or defeat game and your clan has got &a{POINTS}'
clanIsNotPublic: '&cClan is not public'

YAML:

guis:
  mainClanManage:
    displayname: '&a&lClan Manage'
    size: 27
    empty_slots:
      material: BLACK_STAINED_GLASS_PANE
    slots:
      10:
        material: PLAYER_HEAD
        displayname: '&a&lMembers'
        click_action:
          type: 'OPEN_MEMBERS_MENU'
          args: [ ]
      12:
        material: EMERALD
        displayname: '&a&lClan upgrade'
        click_action:
          type: 'OPEN_CLAN_UPGRADE_MENU'
          args: [ ]
      14:
        material: PAPER
        displayname: '&a&lRanks permissions'
        click_action:
          type: 'OPEN_MENU'
          args:
            - 'clanGroups'
      16:
        material: FILLED_MAP
        displayname: '&a&lClan Settings'
        click_action:
          type: 'OPEN_CLAN_SETTINGS_MENU'
          args: [ ]


  clanUpgrade:
    displayname: '&a&lClan Upgrade'
    size: 9
    empty_slots:
      material: BLACK_STAINED_GLASS_PANE
    slots:
      4:
        material: PLAYER_HEAD
        displayname: '&aUpgrade members limits'
        lore:
          - '&eCost {AMOUNT} {ITEM}' #if you use purchase by economy {ITEM} will be no displayed
          - '&7Current clan size is &f{SIZE}'
        click_action:
          type: 'UPGRADE_CLAN_MEMBERS'
          args: [ ]

  clanSettings:
    displayname: '&a&lClan Settings'
    size: 9
    empty_slots:
      material: BLACK_STAINED_GLASS_PANE
    slots:
      3:
        material: IRON_SWORD
        displayname: '&ePvP'
        lore:
          - '{PVP_STATUS}'
        click_action:
          type: 'SWITCH_PVP'
          args: [ ]
      5:
        material: FEATHER
        displayname: '&ePublic Ranking'
        lore:
          - '{PUBLIC_RANKING_STATUS}'
        click_action:
          type: 'SWITCH_PUBLIC_RANKING'
          args: [ ]
  clanGroups:
    displayname: '&a&lClan groups'
    size: 27
    empty_slots:
      material: BLACK_STAINED_GLASS_PANE
    slots:
      11:
        material: GOLDEN_HELMET
        displayname: '&eCo-Owner'
        click_action:
          type: 'OPEN_PERMISSIONS_MENU'
          args:
            - "CO_OWNER"
      13:
        material: IRON_HELMET
        displayname: '&aModerator'
        click_action:
          type: 'OPEN_PERMISSIONS_MENU'
          args:
            - 'MODERATOR'
      15:
        material: LEATHER_HELMET
        displayname: '&9Member'
        click_action:
          type: 'OPEN_PERMISSIONS_MENU'
          args:
            - 'MEMBER'
  clanGroupPermissions:
    displayname: '&a&lGroup permission'
    size: 9
    slots:
      0:
        material: DIAMOND_SWORD
        displayname: '&aKicks members'
        lore:
          - '&7Status: {PERMISSION_STATUS_KICK_MEMBERS}'
        click_action:
          type: 'TOGGLE_PERMISSION'
          args:
            - 'KICK_MEMBERS'
      1:
        material: CHEST
        displayname: '&aOpen clan menu'
        lore:
          - '&7Status: {PERMISSION_STATUS_OPEN_CLAN_MENU}'
        click_action:
          type: 'TOGGLE_PERMISSION'
          args:
            - 'OPEN_CLAN_MENU'
      2:
        material: PAPER
        displayname: '&aManage permissions'
        lore:
          - '&7Status: {PERMISSION_STATUS_MANAGE_PERMISSIONS}'
        click_action:
          type: 'TOGGLE_PERMISSION'
          args:
            - 'MANAGE_PERMISSIONS'
      3:
        material: LEATHER_HELMET
        displayname: '&aSet ranks'
        lore:
          - '&7Status: {PERMISSION_STATUS_SET_RANKS}'
        click_action:
          type: 'TOGGLE_PERMISSION'
          args:
            - 'SET_RANKS'
      4:
        material: ANVIL
        displayname: '&aClan upgrades'
        lore:
          - '&7Status: {PERMISSION_STATUS_CLAN_UPGRADE}'
        click_action:
          type: 'TOGGLE_PERMISSION'
          args:
            - 'UPGRADE_CLAN'
      5:
        material: MAP
        displayname: '&aChange settings'
        lore:
          - '&7Status: {PERMISSION_STATUS_CHANGE_SETTINGS}'
        click_action:
          type: 'TOGGLE_PERMISSION'
          args:
            - 'CHANGE_SETTINGS'
  clanRanking:
    displayname: '&a&lRanking'
    size: 45
    empty_slots:
      material: BLACK_STAINED_GLASS_PANE
    slots:
      13:
        material: DIAMOND_BLOCK
        displayname: '&a&lTop 1'
        lore:
          - '&7Clan: &a{CLAN_NAME_TOP_1}'
          - '&7Points: &a{CLAN_POINTS_TOP_1}'
        click_action:
          type: 'OPEN_CLAN_INFO_MENU'
          args:
            - '1'
      21:
        material: EMERALD_BLOCK
        displayname: '&a&lTop 2'
        lore:
          - '&7Clan: &a{CLAN_NAME_TOP_2}'
          - '&7Points: &a{CLAN_POINTS_TOP_2}'
        click_action:
          type: 'OPEN_CLAN_INFO_MENU'
          args:
            - '2'
      23:
        material: GOLD_BLOCK
        displayname: '&a&lTop 3'
        lore:
          - '&7Clan: &a{CLAN_NAME_TOP_3}'
          - '&7Points: &a{CLAN_POINTS_TOP_3}'
        click_action:
          type: 'OPEN_CLAN_INFO_MENU'
          args:
            - '3'
      29:
        material: IRON_BLOCK
        displayname: '&a&lTop 4'
        lore:
          - '&7Clan: &a{CLAN_NAME_TOP_4}'
          - '&7Points: &a{CLAN_POINTS_TOP_4}'
        click_action:
          type: 'OPEN_CLAN_INFO_MENU'
          args:
            - '4'
      30:
        material: IRON_BLOCK
        displayname: '&a&lTop 5'
        lore:
          - '&7Clan: &a{CLAN_NAME_TOP_5}'
          - '&7Points: &a{CLAN_POINTS_TOP_5}'
        click_action:
          type: 'OPEN_CLAN_INFO_MENU'
          args:
            - '5'
      31:
        material: IRON_BLOCK
        displayname: '&a&lTop 6'
        lore:
          - '&7Clan: &a{CLAN_NAME_TOP_6}'
          - '&7Points: &a{CLAN_POINTS_TOP_6}'
        click_action:
          type: 'OPEN_CLAN_INFO_MENU'
          args:
            - '6'
      32:
        material: IRON_BLOCK
        displayname: '&a&lTop 7'
        lore:
          - '&7Clan: &a{CLAN_NAME_TOP_7}'
          - '&7Points: &a{CLAN_POINTS_TOP_7}'
        click_action:
          type: 'OPEN_CLAN_INFO_MENU'
          args:
            - '7'
      33:
        material: IRON_BLOCK
        displayname: '&a&lTop 8'
        lore:
          - '&7Clan: &a{CLAN_NAME_TOP_8}'
          - '&7Points: &a{CLAN_POINTS_TOP_8}'
        click_action:
          type: 'OPEN_CLAN_INFO_MENU'
          args:
            - '8'
  clanInformation:
    displayname: '&a&lAbout clan'
    size: 9
    empty_slots:
      material: BLACK_STAINED_GLASS_PANE
    slots:
      4:
        material: BOOK
        displayname: '&a&lClan information'
        lore:
          - '&7Name: &a{CLAN_NAME}'
          - '&7Tag: &a{CLAN_TAG}'
          - '&7Owner: &a{CLAN_OWNER}'
          - '&7Members: &a{CLAN_MEMBERS_AMOUNT}'
          - '&7Points: &a{CLAN_POINTS}'
        click_action:
          type: 'NONE'
          args:
            - ''

{NICK}
{RANK}
{MESSAGE}
{CLAN_TAG}
{CLAN_NAME}
{CLAN_OWNER}
{CLAN_MEMBERS_AMOUNT}
{CLAN_POINTS}
{CLAN_LEVEL}
{CLAN_EXPERIENCE}
{CLAN_NAME_TOP_%PLACE_ON _TOP%}
{CLAN_POINTS_TOP_%PLACE_ON _TOP%}
{AMOUNT}
{ITEM}
{SIZE}
{PVP_STATUS}
{PUBLIC_RANKING_STATUS}
{PERMISSION_STATUS_%PERMISSION_NAME%}
{PLAYER_NAME}
{PLAYER}
{TAG}
{TAG_OR_FULLNAME}
{MIN}
{MAX}
{COST}
{CODE}
{CURRENT}
{STATUS}
{POINTS}
{DATA}
{NEW_NAME}
{EXPERIENCE}
{LEVEL}
{LEVEL_REWARD}

%clans_clan_tag%
%clans_settings_pvp%
%clans_settings_ranking%
%clans_player_rank%

1. You can not redistribute this plugin.
2. You can not copy and redistribute the code of this plugin.
If you break the rules, we will take legal action against you.
Breaking these rules your license can be disabled and permanently banned your account.

See our website: https://timsixth.pl/
Join our discord community: https://discord.gg/zKmMy8bK56

T-Clans - Unique clans system v1.7.0

Overview Dependencies Updates (10) History Discord Website