Skip to main content

​
Your First Clan

This guide will walk you through creating and managing your first clan in ClansPlus.
Make sure you have completed the installation before proceeding.

​
Creating a Clan

1

Check Requirements

Before creating a clan, ensure you have:
  • Sufficient currency (default: $1000 if Vault is enabled)
  • Not already in another clan
  • A unique clan name in mind
Clan names must be 3-20 characters and cannot contain spaces or special characters (except in custom names).
2

Create Your Clan

Use the create command with your desired clan name:
/clan create MyClan
Successful Output:
[CLAN] | Successfully created clan MyClan!
The server will broadcast your clan creation to all players (if enabled in config).
Prohibited Names: Some names like “admin”, “staff”, “moderator” are blocked by default. Check config.yml to modify the prohibited list.
3

Access Clan Menu

Open your clan’s management interface:
/clan menu
This opens an interactive GUI where you can:
  • View clan information
  • Manage members
  • Configure settings
  • Upgrade skills
  • Manage allies
  • Access clan storage
4

Customize Your Clan

Set a custom name with color codes (requires clanplus.setcustomname permission):
/clan setcustomname &b&lElite &6&lWarriors
Set a clan announcement message:
/clan setmessage Welcome to the best clan on the server!
Custom names support hex colors: &#3498ebBlue Clan

​
Essential Commands

Here are the most important commands you’ll use:

​
Clan Management

/clan create <name>
# Creates a new clan with the specified name
# Costs currency if enabled in config

​
Member Management

/clan invite <player>
# Invite a player to join your clan
# They have 30 seconds to accept (configurable)

​
Clan Features

/clan setspawn
# Set the clan spawn point at your location
# Requires clanplus.setspawn permission

​
Rank Management (Leaders Only)

/clan setmanager <player>
# Promote a member to manager rank
# Managers have elevated permissions

​
Inviting Members

Grow your clan by inviting other players:
1

Invite a Player

/clan invite PlayerName
The invited player receives a notification:
[CLAN] | PlayerName invited you to join clan MyClan
You have 30 seconds to decide
/clan accept to accept
/clan reject to reject
2

Player Accepts or Rejects

The invited player chooses:To Accept:
/clan accept
To Reject:
/clan reject
3

Manage Your Members

View and manage members through the GUI:
/clan menu
Click “Members” to:
  • View all members and their ranks
  • Check online/offline status
  • Promote/demote members
  • Kick members
Member Limits: Default is 5 members. Upgrade your clan to increase the maximum member count.

​
Understanding Ranks

ClansPlus has a three-tier rank system:
Highest Rank - Full control over the clanPermissions:
  • All member and manager permissions
  • Set clan permissions
  • Transfer ownership
  • Disband clan
  • Cannot be kicked or demoted
Only one leader per clan. Transfer ownership with /clan setowner.

​
Setting Up Clan Spawn

1

Go to Desired Location

Navigate to where you want your clan spawn point to be (e.g., your clan base).
2

Set the Spawn Point

/clan setspawn
Output:
[CLAN] | Successfully set clan spawn to (X, Y, Z) (World: world)
Some worlds may be blacklisted in config.yml. Check the set-spawn-settings section.
3

Test Teleportation

Members can now teleport to the spawn:
/clan spawn
By default, there’s a 5-second countdown. Players must stand still during the countdown:
[CLAN] | You will be teleported in 5 seconds, please do not move.

​
Using Clan Chat

Communicate privately with your clan members:
1

Enable Clan Chat

/clan chat
Output:
[CLAN] | Clan chat enabled.
2

Send Messages

All your messages now go to clan chat only:
Hello clan members!
Only your clan members see this message.
3

Disable Clan Chat

Return to global chat:
/clan chat
Output:
[CLAN] | Clan chat disabled.
You can also type the cancel word (default: ?cancel) to quickly exit clan chat mode.

​
Upgrading Your Clan

Enhance your clan’s capabilities through upgrades:
1

Open Upgrade Menu

/clan upgrade
Or through the clan menu GUI.
2

Choose an Upgrade

Available upgrades include:
  • Maximum Members: Increase member slots
  • Critical Hit: Boost damage output
  • Dodge: Chance to avoid damage
  • Life Steal: Heal when dealing damage
  • Boost Score: Increase score gain rate
  • Max Storages: Add more clan storage slots
3

Purchase Upgrade

Click the upgrade in the GUI to purchase with currency or war points.
Skills have level requirements. You must upgrade level 1 before level 2, etc.

​
Initial Configuration Tips

Optimize ClansPlus for your server:

​
For Small Servers (< 50 players)

config.yml
database:
  type: YAML  # Simpler setup
  
clan-settings:
  creating-clan-settings:
    currency-requirement:
      enabled: false  # Free clan creation
    maximum-member-default: 10  # Allow larger clans

​
For Large Servers (50+ players)

config.yml
database:
  type: H2  # Better performance
  smart-loading:
    enabled: true  # Faster startup
  auto-save:
    enabled: true
    seconds: 600  # Save every 10 minutes
    
clan-settings:
  creating-clan-settings:
    currency-requirement:
      enabled: true
      type: VAULT
      value: 5000  # Higher cost to prevent spam
    maximum-member-default: 5

​
Customize Clan Creation Cost

clan-settings:
  creating-clan-settings:
    currency-requirement:
      enabled: true
      type: VAULT
      value: 1000  # $1000 to create clan

​
Configure Permissions

Set default permissions for new clans:
config.yml
clan-settings:
  creating-clan-settings:
    permission-default:
      INVITE: MANAGER        # Managers+ can invite
      KICK: MANAGER          # Managers+ can kick
      SETCUSTOMNAME: LEADER  # Only leader can set custom name
      SETICON: LEADER        # Only leader can set icon
      SPAWN: MEMBER          # Everyone can use /clan spawn
      SETSPAWN: LEADER       # Only leader can set spawn
      SETMESSAGE: MANAGER    # Managers+ can set message
      CHAT: MEMBER           # Everyone can use clan chat
      UPGRADE: MANAGER       # Managers+ can upgrade
      MANAGEALLY: MANAGER    # Managers+ can manage allies
      OPENSTORAGE: MEMBER    # Everyone can access storage
Permission Hierarchy: LEADER > MANAGER > MEMBER. If MEMBER has a permission, MANAGER and LEADER automatically have it too.

​
Command Aliases

ClansPlus supports multiple command aliases: 
/clan = /clansplus = /clanplus = /clans = /guild = /guilds = /team = /teams
Use whichever fits your server theme!

​
Next Steps

Now that you’ve created your first clan, explore more features:

Commands Reference

Complete list of all player and admin commands

Configuration Guide

Detailed configuration options and customization

Clan Skills

Learn about the clan skill system and upgrades

API Reference

Develop plugins that integrate with ClansPlus

​
Need Help?

If you encounter issues or have questions:

Join Discord Community

Get support from the ClansPlus community and developer

Build docs developers (and LLMs) love

Get started for freeTalk to us