XClans | Custom clan roles | GUIs | 1.18 - 1.21 icon

XClans | Custom clan roles | GUIs | 1.18 - 1.21 -----

Clan Plugin with custom roles, gui, many commands and more



XClans

XClans is a powerful and modern clans plugin for Minecraft servers, built with GUIs, custom roles, and a wide variety of commands.
It allows players to create and manage clans with ease, customize clan colors and ranks, and compete for the top spots on the server.
If you have any problems or questions, please contact me on Discord: norius_tv
Video:


Features

Fully Customizable
  • Create custom clan ranks with detailed permissions.
  • Set unique clan colors – full HEX and gradient support included.
  • Translate and edit every message & GUI text in the lang.yml.
  • Adjust all gameplay settings in the config.yml for total control.
️ Many GUIs
  • User-friendly menus for almost every action.
  • Change clan settings, promote or demote members, or manage the clan bank directly from the GUI.
  • No more confusing commands – everything is accessible with just a few clicks.

Clan Levels
  • Define custom clan levels with unique benefits:
    • Maximum bank size
    • Maximum homes
    • Maximum inventory size
    • Maximum clan members
  • Players can upgrade their clan using in-game cash.
Clan Homes
  • Create multiple clan homes with custom names.
  • Fast teleportation system for the whole clan.
️ Clan Plot
  • Full PlotSquared support: set a dedicated plot as your official clan territory.
Clan Inventory
  • Shared storage for the entire clan.
  • Configure permissions for who can view or take items.
Top Clans
  • Display a leaderboard of the strongest and most successful clans.
Clan Settings
  • Set your clan status (open, closed, or invitation-only).
  • Toggle PvP on or off within your clan.
  • Unlock and set custom clan colors as your clan levels up.
Clan Bank
  • Deposit and withdraw money from the clan’s shared bank.
  • Unlock new clan levels using clan funds.
️ Database
  • Supports MySQL, SQLite, and MariaDB.
  • All database requests are performed asynchronously for maximum performance.
️ Clan Tag
  • Assign a clan tag to represent your group.
  • Optionally display it in the tablist behind the player’s name.
Placeholders
  • %xclans_tag%: returns the tag of the players clan
  • %xclans_name%: returns the name of the players clan
  • %xclans_formatted_tag%: returns a formatted tag of the players clan in minimessage format
  • %xclans_formatted_name%: returns a formatted name of the players clan in minimessage format

Requirements:
  • Vault
  • A Paper server

Commands:

Player Commands
  • /clan (Opens the clan menu)
  • /clan create <Name> <Tag> (Create a clan)
  • /clan join <Name|Tag> (Join a clan)
  • /clan delete (Delete your clan)
  • /clan leave (Leave your clan)
  • /clan kick <Player> (Kick a member)
  • /clan promote <Player> (Promote a member)
  • /clan demote <Player> (Demote a member)
  • /clan info <Clan> (Show clan info)
  • /clan settings <Setting> <Value> (Change clan settings)
  • /clan inventory (Open clan inventory)
  • /clan sethome <Name> (Set a clan home)
  • /clan delhome <Name> (Delete a clan home)
  • /clan home <Name> (Teleport to a clan home)
  • /clan setplot (Set the clan plot)
  • /clan plot (Teleport to the clan plot)
  • /clan bank <deposit|withdraw> <Amount> (Clan bank actions)
  • /clan chat (Write in clan chat)
  • /clan togglechat (Toggle clan chat)
  • /clan upgrade (Upgrade the clan)
  • /clan top (Show top clans)
  • /clan list (List all clans)
Admin Commands
  • /clanadmin bank <Clan> <withdraw|deposit> <Amount> (Manage the clan bank)
  • /clanadmin upgrade <Clan> (Upgrade the clan level)
  • /clanadmin kick <Clan> <Player> (Remove a player from a clan)
  • /clanadmin promote <Clan> <Player> (Promote a player in a clan)
  • /clanadmin demote <Clan> <Player> (Demote a player in a clan)
  • /clanadmin delhome <Clan> <Name> (Delete a clan home)
  • /clanadmin changename <Clan> <Name> (Change the clan name)
  • /clanadmin changetag <Clan> <Tag> (Change the clan tag)
  • /clanadmin setstatus <Clan> <Status> (Set the clan status)
  • /clanadmin pvp <Clan> <enable|disable> (Enable/Disable PvP in a clan)
  • /clanadmin broadcast <Clan> <Message> (Send a message to the clan)
Configuration:

Code (YAML):
prefix : "<#FFAA00>[⚔ <#FFD700>Clan<#FFAA00> ⚔]"
language
: "de"

use-mariadb
: false
use-mysql
: false

database
:
  user
: "root"
  host
: ""
  database
: ""
  password
: ""
  port
: 3306

settings
:
  prefix-in-every-message
: true

  default-rank
: "member" # rank a player receives when joining a clan

  creator-rank
: "leader" # rank a player receives when creating a clan

  create-clan-price
: 10000

  click-delay-ms
: 250

  min-name-length
: 5

  min-tag-length
: 3

  max-name-length
: 18

  max-tag-length
: 4

  invitation-expiring-sec
: 30

  announce-change-settings
: true

  change-player-list-name
: true

  clan-player-list-name-format
: "%player_name% <dark_gray>[%xclans_formatted_tag%<dark_gray>]"

  player-list-name-format
: "%player_name%"

  default-color
: "<#55FFFF>%name%"

  send-update-on-join
: true

levels
:
  1
:
    homes
: 1
    bank-size
: 10000
    inv-size
: 18
    max-members
: 5
  2
:
    homes
: 3
    bank-size
: 100000
    inv-size
: 27
    price
: 10000
    max-members
: 10
  3
:
    homes
: 5
    bank-size
: 500000
    inv-size
: 36
    price
: 100000
    max-members
: 20
  4
:
    homes
: 10
    bank-size
: 2000000
    inv-size
: 45
    price
: 250000
    max-members
: 25
  5
:
    homes
: 15
    bank-size
: 10000000
    inv-size
: 54
    price
: 500000
    max-members
: 50


colors
:
  - material
: RED_NETHER_BRICKS
    name
: "<#AA0000>%name%"
    unlock-level
: 2
  - material
: LIGHT_BLUE_CONCRETE
    name
: "<#00AAFF>%name%"
    unlock-level
: 3
  - material
: EMERALD_BLOCK
    name
: "<#2ECC71>%name%"
    unlock-level
: 3
  - material
: GOLD_BLOCK
    name
: "<#FFAA00>%name%"
    unlock-level
: 3
  - material
: ORANGE_CONCRETE
    name
: "<gradient:#FF7E5F:#FEB47B>%name%</gradient>"
    unlock-level
: 3
  - material
: PRISMARINE
    name
: "<gradient:#00C6FF:#0072FF>%name%</gradient>"
    unlock-level
: 4
  - material
: PURPLE_CONCRETE
    name
: "<gradient:#7F00FF:#E100FF>%name%</gradient>"
    unlock-level
: 5
Code (YAML):
# Available Permissions:
#   - all                → All permissions
#   - settings.name      → Change clan name
#   - settings.color     → Change clan color
#   - settings.pvp       → Toggle clan PvP
#   - settings.status    → Change clan status (open/closed/invite only)
#   - settings.edit      → Edit general clan settings
#   - members.kick       → Kick members
#   - members.promote    → Promote members
#   - members.demote     → Demote members
#   - members.invite     → Invite members
#   - clan.upgrade       → Upgrade clan level
#   - clan.setplot       → Set clan plot
#   - clan.delete        → Delete clan
#   - clan.sethome       → Set clan home
#   - clan.delhome       → Delete clan home
#   - inv.view           → View clan inventory
#   - inv.take           → Take items from clan inventory
#   - inv.put            → Put items into clan inventory
#   - bank.deposit       → Deposit money into clan bank
#   - bank.withdraw      → Withdraw money from clan bank

roles
:
  - name
: "leader"
    displayname
: "<#AA0000>Leader"
    priority
: 1
    permissions
:
     - "all"

  - name
: "co-leader"
    displayname
: "<#FF5555>Co-Leader"
    priority
: 2
    permissions
:
     - "settings.name"
      - "settings.color"
      - "settings.pvp"
      - "settings.status"
      - "settings.edit"
      - "members.kick"
      - "members.promote"
      - "members.demote"
      - "members.invite"
      - "clan.upgrade"
      - "clan.setplot"
      - "clan.sethome"
      - "clan.delhome"
      - "inv.view"
      - "inv.take"
      - "inv.put"
      - "bank.deposit"
      - "bank.withdraw"

  - name
: "mod"
    displayname
: "<#5555FF>Mod"
    priority
: 3
    permissions
:
     - "members.kick"
      - "members.invite"
      - "clan.sethome"
      - "clan.delhome"
      - "inv.view"
      - "inv.take"
      - "inv.put"
      - "bank.deposit"

  - name
: "farmer"
    displayname
: "<#55FF55>Farmer"
    priority
: 4
    permissions
:
     - "inv.view"
      - "inv.put"
      - "bank.deposit"

  - name
: "member"
    displayname
: "<#AAAAAA>Member"
    priority
: 5
    permissions
: [ ]
 
Resource Information
Author:
----------
Total Downloads: 4
First Release: Sep 26, 2025
Last Update: Nov 2, 2025
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings