NClan

Overview

NClan is a modern clans plugin designed to improve player interaction, teamwork, and competitive gameplay on Minecraft servers. It gives players a complete clan system with clan creation, invitations, joining, leaving, kicking members, leader and deputy roles, alliances, player points, clan points, toggleable clan PvP, private clan and alliance chat, and a fully configurable clan upgrade system.

The plugin is built to be easy for players to use and highly configurable for server owners. You can customize clan tags, member limits, alliance limits, PvP settings, point progression, chat formatting, clan creation costs, and clan upgrades to match your server perfectly.

NClan supports multiple economy types, including Vault, XP, PlayerPoints, CoinsEngine, and ItemStack, making it suitable for survival, SMP, PvP, and economy-based servers. It also includes PlaceholderAPI support with relational placeholders, allowing you to display clan data in scoreboards, tablists, chats, and other plugins.

Built for performance and flexibility, NClan is a strong choice for servers that want a complete and configurable clan system without unnecessary complexity.

Features

Folia Support - Compatible with Folia and supports modern Minecraft versions.
100% Configurable - Customize clan settings, tags, limits, points, chat formats, upgrades, and payment options.
High Performance - Designed to run smoothly without unnecessary overhead.
Complete Clan Management - Create clans, invite players, remove members, transfer ownership, and assign deputy roles.
Alliances System - Allow clans to build alliances with configurable alliance limits.
Clan PvP Toggle - Let clan leaders enable or disable friendly PvP between members.
Points Progression - Dynamic player and clan points system with configurable kill-based progression and per-clan boost multipliers.
Kill Titles - Show customizable kill and death titles directly to players on kill events.
Clan & Alliance Chat - Private chat channels for clan members (!) and allied clans (!!).
Clan Upgrades - GUI-based upgrade system to expand member slots, alliance slots, and boost kill points.
Anti-Abuse System - Configurable kill cooldown to prevent point farming from the same victim.
Economy Integration - Supports Vault, XP, PlayerPoints, CoinsEngine, and ItemStack.
PlaceholderAPI Support - 20+ placeholders including relational placeholders for displaying clan data relative to other players.
Multi-Language - Ships with 5 language files (English, Polish, German, Spanish, French).

howyouse

Install NClan into your server's plugins folder.
(Optional) Install the economy plugin you want to use with NClan.
Start the server to generate the plugin files.
Open and configure the generated files:

plugins/NClan/config.yml
plugins/NClan/economy.yml
plugins/NClan/upgrades.yml
plugins/NClan/lang/en.yml

Set up clan options such as tag rules, member limits, PvP settings, points, chat formatting, and upgrades in config.yml.
Configure the clan creation payment system in config.yml > settings.payment.
Set up the supported currency types in economy.yml.
Configure the clan upgrade shop in upgrades.yml.
Reload the plugin after making changes:

/nclan reload

commands

Command	Description
`/clan create <tag>`	Creates a new clan. (Permission: `nclan.clan.create`)
`/clan delete`	Deletes your clan. (Permission: `nclan.clan.delete`)
`/clan info [tag]`	Displays information about your clan or the selected clan. (Permission: `nclan.clan.info`)
`/clan join <tag>`	Joins a clan if the player has been invited. (Permission: `nclan.clan.join`)
`/clan leave`	Leaves the current clan. (Permission: `nclan.clan.leave`)
`/clan invite <player>`	Invites a player to the clan. (Permission: `nclan.clan.invite`)
`/clan kick <player>`	Removes a player from the clan. (Permission: `nclan.clan.kick`)
`/clan setowner <player>`	Transfers clan ownership to another player. (Permission: `nclan.clan.setowner`)
`/clan deputy <player>`	Promotes a player to deputy. (Permission: `nclan.clan.deputy`)
`/clan removedeputy <player>`	Removes the deputy role from a player. (Permission: `nclan.clan.removedeputy`)
`/clan alliance <tag>`	Creates an alliance with another clan. (Permission: `nclan.clan.alliance`)
`/clan removealliance <tag>`	Removes an alliance with another clan. (Permission: `nclan.clan.removealliance`)
`/clan pvp`	Enables or disables clan PvP. (Permission: `nclan.clan.pvp`)
`/clan upgrades`	Opens the clan upgrades GUI. (Permission: `nclan.clan.upgrades`)

Clan Chat

Prefix	Description
`!<message>`	Sends a message visible only to clan members.
`!!<message>`	Sends a message visible to clan members and all allied clans.

Admin Commands

Command	Description
`/nclan reload`	Reloads all plugin configuration files. (Permission: `nclan.admin.reload`)
`/nclan deleteclan <tag>`	Deletes the selected clan. (Permission: `nclan.admin.deleteclan`)
`/nclan setleader <tag> <player>`	Sets the leader of the selected clan. (Permission: `nclan.admin.setleader`)
`/nclan join <tag> <player>`	Adds a player to the selected clan. (Permission: `nclan.admin.join`)
`/nclan kick <tag> <player>`	Removes a player from the selected clan. (Permission: `nclan.admin.kick`)
`/nclan setpoints <player> <amount>`	Sets the player's points. (Permission: `nclan.admin.setpoints`)
`/nclan addpoints <player> <amount>`	Adds points to the player. (Permission: `nclan.admin.addpoints`)
`/nclan removepoints <player> <amount>`	Removes points from the player. (Permission: `nclan.admin.removepoints`)
`/nclan setlimit <tag> <members\|alliance> <amount>`	Sets the member or alliance limit for a clan. (Permission: `nclan.admin.setlimit`)
`/nclan setboost <tag> <multiplier>`	Sets the kill points multiplier for a clan (e.g. `1.5` = +50%). (Permission: `nclan.admin.setboost`)
`/nclan setupgrade <tag> <upgrade> <level>`	Sets the upgrade level for a clan. (Permission: `nclan.admin.setupgrade`)
`/nclan economy set <id>`	Saves the item in hand as an `ITEMSTACK` currency entry. (Permission: `nclan.admin.economy`)

Player Info Command

Command	Description
`/player <nick>`	Shows the clan and points of the selected online player. (Permission: `nclan.player.info`)

placeholders

Placeholder	Description
`%nclan_tag%`	Displays the player's clan tag.
`%nclan_tag_upper%`	Displays the player's clan tag in uppercase.
`%nclan_tag_formatted%`	Displays the clan tag using the configured format.
`%nclan_tag_formatted_<nick>%`	Displays another player's formatted clan tag based on relation.
`%nclan_player_has_clan%`	Shows whether the player has a clan.
`%nclan_player_points%`	Displays the player's points.
`%nclan_player_points_formatted%`	Displays the player's points with formatting.
`%nclan_clan_points%`	Displays the total points of the player's clan.
`%nclan_clan_members%`	Displays the number of clan members.
`%nclan_clan_members_online%`	Displays the number of online clan members.
`%nclan_clan_pvp%`	Shows whether clan PvP is enabled.
`%nclan_clan_pvp_formatted%`	Displays the formatted clan PvP status.
`%nclan_clan_max_members%`	Displays the maximum member limit of the clan.
`%nclan_clan_free_slots%`	Displays the number of free clan slots.
`%nclan_clan_can_invite%`	Shows whether the player can invite others.
`%nclan_clan_can_join%`	Shows whether the clan can accept more members.
`%nclan_clan_is_owner%`	Shows whether the player is the clan owner.
`%nclan_clan_is_deputy%`	Shows whether the player is a clan deputy.
`%nclan_clan_upgrade_<id>%`	Displays the current level of the specified clan upgrade.

Relational Placeholders

These placeholders compare two players and are supported in plugins like TAB.

Placeholder	Description
`%rel_nclan_tag%`	Displays the other player's clan tag.
`%rel_nclan_tag_upper%`	Displays the other player's clan tag in uppercase.
`%rel_nclan_tag_formatted%`	Displays the other player's formatted clan tag based on relation.

cfg

config.yml

lang: en

default:
  default-points: 500
  # Permission: nclan.alliancelimit.<val>
  default-alliance: 3
  default-clan-pvp: true
  # Permission: nclan.memberlimit.<val>
  default-clan-member-limit: 4

settings:
  antiabuse:
    enabled: true
    cooldown: 300
  payment:
    enabled: true
    # VAULT / XP / PLAYERPOINTS / COINSENGINE / ITEMSTACK
    type: VAULT
    id: 1
    cost: 10.0
  tag:
    min: 2
    max: 6
    format:
      no-clan: 'None'
      clan-member: '<green>[TAG]'
      clan-alliance: '<green>[TAG]'
      others: '<gray>[TAG]'
  clan:
    upgrades:
      title: '<gold>Clan Upgrades'
      rows: 3
    player:
      online-color: '<green>'
      offline-color: '<red>'
    deputy:
      no-deputy: 'No deputy'
    pvp:
      format:
        on: '<green>ON'
        off: '<red>OFF'
  points:
    format:
      player: '<green>([POINTS])'
      clan: '<yellow>([POINTS])'
    kill-system:
      enabled: true
      base-change: 20
      difference-divisor: 50
      min-change: 3
      max-change: 30
      same-loss-as-gain: false
      victim-min-points: 0
      title:
        enabled: true
        fade-in: 300
        stay: 1500
        fade-out: 500
  chat:
    message:
      # !<MESSAGE>
      clan: '<green>[PLAYER] -> [MESSAGE]'
      # !!<MESSAGE>
      alliance: '<blue>[PLAYER] -> [MESSAGE]'

upgrades.yml

upgrades:
  members:
    slot: 10
    levels:
      1:
        max-value: 5
        cost:
          type: VAULT
          id: 1
          amount: 10.0
      2:
        max-value: 5
        cost:
          type: VAULT
          id: 1
          amount: 25.0
      # ...up to level 5
  alliance:
    slot: 16
    levels:
      1:
        max-value: 2
        cost:
          type: VAULT
          id: 1
          amount: 50.0
      # ...up to level 5
  points-boost:
    slot: 13
    levels:
      1:
        multiplier: 1.1
        cost:
          type: VAULT
          id: 1
          amount: 100.0
      # ...up to level 10 (2.0x multiplier)

messages.yml

messages:
  only-player: '<red>✖ <gray>This command is only available to <white>players<gray>.'
  user-not-loaded: '<red>✖ <gray>Your data has not been loaded yet.'
  target-user-not-loaded: '<red>✖ <gray>The specified player''s data is not loaded.'
  only-online-target: '<red>✖ <gray>The specified player must be <green>online<gray>.'
  no-permission-action: '<red>✖ <gray>You do not have permission: <white>[PERMS]<gray>.'
  invalid-number: '<red>✖ <gray>The specified value is not a valid <white>number<gray>.'

  player:
    usage: '<yellow>💡 <gray>Usage: <white>/player <nick>'
    no-clan-value: '<red>No clan'
    info:
      - '<gradient:#00c6ff:#0072ff><strikethrough>--------------------------------</strikethrough></gradient>'
      - ' <gray>Player: <white>[PLAYER]'
      - ' <gray>Points: <aqua>[POINTS]'
      - ' <gray>Clan: <gold>[TAG]'
      - '<gradient:#00c6ff:#0072ff><strikethrough>--------------------------------</strikethrough></gradient>'

  clan:
    help:
      - '<gradient:#ffb347:#ffcc33><strikethrough>--------------------------------</strikethrough></gradient>'
      - ' <gold>⭐ <bold>CLAN MANAGEMENT</bold> ⭐'
      - ' <yellow>◆ <white>/clan create <gray><tag>'
      - ' <yellow>◆ <white>/clan delete'
      - ' <yellow>◆ <white>/clan info <gray>[tag]'
      - ' <yellow>◆ <white>/clan join <gray><tag>'
      - ' <yellow>◆ <white>/clan leave'
      - ' <yellow>◆ <white>/clan invite <gray><nick>'
      - ' <yellow>◆ <white>/clan kick <gray><nick>'
      - ' <yellow>◆ <white>/clan setowner <gray><nick>'
      - ' <yellow>◆ <white>/clan deputy <gray><nick>'
      - ' <yellow>◆ <white>/clan removedeputy <gray><nick>'
      - ' <yellow>◆ <white>/clan alliance <gray><tag>'
      - ' <yellow>◆ <white>/clan removealliance <gray><tag>'
      - ' <yellow>◆ <white>/clan pvp'
      - ' <yellow>◆ <white>/clan upgrades'
      - '<gradient:#ffb347:#ffcc33><strikethrough>--------------------------------</strikethrough></gradient>'
    create-usage: '<yellow>💡 <gray>Usage: <white>/clan create <tag>'
    already-in-clan: '<red>✖ <gray>You are already in a clan!'
    tag-length: '<red>✖ <gray>The clan tag must be from <white>[MIN] <gray>to <white>[MAX] <gray>characters long.'
    tag-exists: '<red>✖ <gray>A clan with this tag already exists.'
    created: '<green>✔ <gray>Successfully created the clan: <gold>[TAG]'
    no-clan: '<red>✖ <gray>You currently do not have a clan.'
    only-leader: '<red>✖ <gray>Only the <gold>Leader <gray>can perform this action.'
    deleted: '<green>✔ <gray>Your clan has been deleted.'
    not-found: '<red>✖ <gray>The specified clan was not found.'
    info:
      - '<gradient:#ffb347:#ffcc33><strikethrough>--------------------------------</strikethrough></gradient>'
      - ' <gray>Clan: <gold>[TAG]'
      - ' <gray>Points: <yellow>[POINTS]'
      - ' <gray>Members: <white>[MEMBERS]'
      - ' <gray>Leader: <white>[LEADER]'
      - ' <gray>Deputy: <white>[DEPUTY]'
      - ' <gray>Member list: <white>[MEMBER_LIST]'
      - ' <gray>Alliances: <white>[ALLIANCES]'
      - '<gradient:#ffb347:#ffcc33><strikethrough>--------------------------------</strikethrough></gradient>'
    join-usage: '<yellow>💡 <gray>Usage: <white>/clan join <tag>'
    must-leave-first: '<red>✖ <gray>You must leave your current clan first.'
    no-invite: '<red>✖ <gray>You do not have an invite to this clan.'
    joined: '<green>✔ <gray>You have joined the clan <gold>[TAG]<gray>!'
    leader-cannot-leave: '<red>✖ <gray>As the leader, you cannot leave the clan. Hand over leadership or delete the clan first.'
    left: '<green>✔ <gray>You have successfully left the clan.'
    invite-usage: '<yellow>💡 <gray>Usage: <white>/clan invite <nick>'
    invited: '<green>✔ <gray>Invited player <white>[PLAYER] <gray>to the clan.'
    invited-target: '<yellow>✉ <gray>You have received an invite to the clan <gold>[TAG]<gray>. Use <white>/clan join [TAG] <gray>to join!'
    kick-usage: '<yellow>💡 <gray>Usage: <white>/clan kick <nick>'
    member-not-found: '<red>✖ <gray>This player is not in your clan.'
    cannot-kick-leader: '<red>✖ <gray>You cannot kick the clan leader.'
    kicked: '<green>✔ <gray>Kicked player <white>[PLAYER] <gray>from the clan.'
    setowner-usage: '<yellow>💡 <gray>Usage: <white>/clan setowner <nick>'
    owner-changed: '<green>✔ <gray>Transferred Leadership to player <white>[PLAYER]<gray>.'
    deputy-usage: '<yellow>💡 <gray>Usage: <white>/clan deputy <nick>'
    deputy-set: '<green>✔ <gray>Granted Deputy role to player <white>[PLAYER]<gray>.'
    removedeputy-usage: '<yellow>💡 <gray>Usage: <white>/clan removedeputy <nick>'
    deputy-removed: '<green>✔ <gray>Revoked Deputy role from player <white>[PLAYER]<gray>.'
    alliance-usage: '<yellow>💡 <gray>Usage: <white>/clan alliance <tag>'
    alliance-added: '<green>✔ <gray>Formed an alliance with the clan <gold>[TAG]<gray>.'
    removealliance-usage: '<yellow>💡 <gray>Usage: <white>/clan removealliance <tag>'
    alliance-removed: '<green>✔ <gray>Broken the alliance with the clan <gold>[TAG]<gray>.'
    pvp-off: '<red>🛡 <gray>Disabled PvP between clan members.'
    pvp-on: '<green>⚔ <gray>Enabled PvP between clan members.'
    member-limit: '<red>✖ <gray>This clan has already reached the maximum member limit (<white>[LIMIT]<gray>).'
    alliance-limit: '<red>✖ <gray>The maximum alliance limit has already been reached (<white>[LIMIT]<gray>).'
    payment-not-enough: '<red>✖ <gray>You lack <white>[COST] [ECONOMY] <gray>to create a clan.'
    upgrades:
      not-found: '<red>✖ <gray>The specified upgrade was not found.'
      disabled: '<red>✖ <gray>This upgrade is currently disabled.'
      max-level: '<red>✖ <gray>This upgrade is already at its maximum level.'
      not-enough: '<red>✖ <gray>You lack the required resources to purchase this upgrade.'
      bought: '<green>✔ <gray>Successfully purchased the upgrade!'

  admin:
    help: '<dark_gray>» <gray>Available commands: <white>/nclan reload, /nclan deleteclan <tag>, /nclan setleader <tag> <nick>, /nclan join <tag> <nick>, /nclan kick <tag> <nick>, /nclan setpoints <nick> <amount>, /nclan addpoints <nick> <amount>, /nclan removepoints <nick> <amount>, /nclan setlimit <tag> <members|alliance> <amount>, /nclan setboost <tag> <multiplier>, /nclan setupgrade <tag> <upgrade> <level>, /nclan economy set <id>'
    reloaded: '<green>✔ <gray>Successfully reloaded configuration files.'
    unknown: '<red>✖ <gray>Unknown admin command.'
    clan-deleted: '<green>✔ <gray>Deleted clan <gold>[TAG]<gray>.'
    leader-set: '<green>✔ <gray>Set player <white>[PLAYER] <gray>as the new leader.'
    player-added: '<green>✔ <gray>Added player <white>[PLAYER] <gray>to the clan <gold>[TAG]<gray>.'
    player-kicked: '<green>✔ <gray>Admin kicked player <white>[PLAYER] <gray>from the clan.'
    points-changed: '<green>✔ <gray>Changed player <white>[PLAYER]<gray>''s points to <yellow>[POINTS]<gray>.'
    setlimit-usage: '<yellow>💡 <gray>Usage: <white>/nclan setlimit <tag> <members|alliance> <amount>'
    member-limit-set: '<green>✔ <gray>Set the member limit for clan <gold>[TAG] <gray>to <white>[LIMIT]<gray>.'
    alliance-limit-set: '<green>✔ <gray>Set the alliance limit for clan <gold>[TAG] <gray>to <white>[LIMIT]<gray>.'
    setboost-usage: '<yellow>💡 <gray>Usage: <white>/nclan setboost <tag> <multiplier>'
    boost-set: '<green>✔ <gray>Set the points boost for clan <gold>[TAG] <gray>to <white>[MULTIPLIER]x<gray>.'
    setupgrade-usage: '<yellow>💡 <gray>Usage: <white>/nclan setupgrade <tag> <upgrade> <level>'
    setupgrade-invalid-level: '<red>✖ <gray>The specified upgrade level is invalid.'
    upgrade-set: '<green>✔ <gray>Set upgrade <white>[UPGRADE] <gray>for clan <gold>[TAG] <gray>to level <white>[LEVEL]<gray>.'
    economy-usage: '<yellow>💡 <gray>Usage: <white>/nclan economy set <id>'
    economy-hold-item: '<red>✖ <gray>You must hold an item in your main hand.'
    economy-set: '<green>✔ <gray>Set item <white>ITEMSTACK <gray>with ID <aqua>[ID]<gray>.'

  death:
    player-kill-broadcast: '<dark_gray>» <white>[KILLER] <gray>defeated player <white>[VICTIM] <dark_gray>(<green>+[PLUS_POINTS]🏆 <red>-[MINUS_POINTS]🏆<dark_gray>)'
    killer-null-broadcast: '<dark_gray>» <white>[VICTIM] <gray>died <dark_gray>(<red>-[MINUS_POINTS]🏆<dark_gray>)'
    fall-broadcast: '<dark_gray>» <white>[VICTIM] <gray>fell from a height <dark_gray>(<red>-[MINUS_POINTS]🏆<dark_gray>)'
    fire-broadcast: '<dark_gray>» <white>[VICTIM] <gray>burned to death <dark_gray>(<red>-[MINUS_POINTS]🏆<dark_gray>)'
    void-broadcast: '<dark_gray>» <white>[VICTIM] <gray>fell into the void <dark_gray>(<red>-[MINUS_POINTS]🏆<dark_gray>)'
    magic-broadcast: '<dark_gray>» <white>[VICTIM] <gray>was killed by magic <dark_gray>(<red>-[MINUS_POINTS]🏆<dark_gray>)'
    default-broadcast: '<dark_gray>» <white>[VICTIM] <gray>died <dark_gray>(<red>-[MINUS_POINTS]🏆<dark_gray>)'
    title:
      killer:
        title: '<green>+[PLUS_POINTS] 🏆'
        subtitle: '<gray>You defeated <white>[VICTIM]'
      victim:
        title: '<red>-[MINUS_POINTS] 🏆'
        subtitle: '<gray>You were defeated by <white>[KILLER]'

support

Support & Community

Need help, found a bug, or want to suggest a feature?

Join the Discord server below. Feedback and suggestions are reviewed, and improvements are included in future updates.

Join our Discord

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators