DaClans

DaClans

A simple, configurable clans plugin for Paper servers, with ranks, alliances, a clan bank and anti-teaming.

DaClans lets players form clans, invite friends, climb a rank ladder, ally with other clans and pool money in a shared bank. Server owners get a fully configurable rank system, damage rules between teammates and an anti-teaming check against neutral players.

Built on the Paper Brigadier command API and Paper plugin descriptor (paper-plugin.yml).

Features

Clans

• Create, rename, disband and leave clans
• Invite players (invites expire) or leave the clan open so anyone can join
• Configurable name pattern and member limit
• Transfer ownership with /clan setowner

Ranks and permissions

• Four default ranks: Member, Officer, Co-Leader and Leader
• Add more ranks or change the default ones in config.yml, ordered by level
• Per-clan minimum rank for inviting, kicking, renaming, settings and warning, set by the leader in-game
• Custom display name, material, lore and glow for each rank

Diplomacy

• Alliances with expiring requests, accepted by running the command from the other clan
• Mark other clans as enemies
• Optional damage reduction between clan members and between allies

Economy

• Clan bank with /clan deposit and /clan withdraw
• Buy extra member slots from the settings menu
• Uses Vault, so it works with any Vault-compatible economy

Moderation

• Anti-teaming: warns clans and allies that gang up on a player with no clan
• Staff notifications through a permission node
• Optional BountyLite integration that blocks bounties on teammates

Interface and extras

• Chest GUI for clan settings, rank permissions and member promotions
• Clan leaderboard sorted by bank or member count
• PlaceholderAPI placeholders
• Nexo custom items for GUI and rank icons
• MiniMessage formatting for every message and menu item
• SQLite by default, MySQL optional

Requirements

Requirement · Details
Server · Paper or Purpur 1.21.11 or newer
Java · 21 or newer
Vault · Optional, needed for /clan deposit and /clan withdraw
Economy plugin · Optional, any Vault-compatible provider
PlaceholderAPI · Optional, enables the placeholders below
Nexo · Optional, enables custom item icons
BountyLite · Optional, enables teammate bounty blocking

Installation

1. Download the latest release from Modrinth.
2. Drop the jar into your server's plugins folder.
3. Start the server once to generate the default files, then edit them in plugins/DaClans/.
4. Restart the server to apply configuration changes.

config.yml and settings.yml are generated on first start and are never overwritten by updates.

Commands

The main command is /clan, with the aliases /clans and /daclans.

Command · Description · Who can use it
/clan create · Create a clan · Anyone not in a clan
/clan disband · Delete your clan · Leader
/clan rename · Rename your clan · Minimum rank set for rename
/clan invite · Invite an online player · Leader, or the minimum rank set for invite if invites are open to ranks
/clan join [clan] · Join a clan you were invited to, or any open clan · Anyone not in a clan
/clan leave · Leave your clan · Members (leaders cannot leave)
/clan promote · Raise a member one rank · Leader
/clan demote · Lower a member one rank · Leader
/clan setowner · Hand leadership to another member · Leader
/clan kick · Remove a member of a lower rank · Minimum rank set for kick
/clan settings · Open the settings menu · Minimum rank set for settings
/clan ally · Send, accept or end an alliance · Leader
/clan enemy · Toggle a clan as your enemy · Leader
/clan warn · Send a warning to a member · Minimum rank set for warn
/clan deposit · Add money to the clan bank · Members
/clan withdraw [amount] · Take money from the bank, or everything if no amount is given · Leader
/clan top [page] · Show the clan leaderboard · Anyone

Permissions

All daclans.command.* permissions are granted to players by default. In-game rank checks apply on top of them.

Command · Permission
/clan create · daclans.command.create
/clan disband · daclans.command.disband
/clan rename · daclans.command.rename
/clan invite · daclans.command.invite
/clan join [clan] · daclans.command.join
/clan leave · daclans.command.leave
/clan promote · daclans.command.promote
/clan demote · daclans.command.demote
/clan setowner · daclans.command.setowner
/clan kick · daclans.command.kick
/clan settings · daclans.command.settings
/clan ally · daclans.command.ally
/clan enemy · daclans.command.enemy
/clan warn · daclans.command.warn
/clan deposit · daclans.command.deposit
/clan withdraw [amount] · daclans.command.withdraw
/clan top [page] · daclans.command.top

Permission · Description · Default
daclans.antiteam.notify · Receive a staff notice when clan members are teaming on a player · op

Settings menu

/clan settings opens a chest menu. Anyone who meets the settings rank can open it and toggle clan access. Everything else is leader only.

Button · Action · Who
Clan access · Switch between open and invite only · Settings rank or higher
Who can invite · Switch between leader only and rank based invites · Leader
Rank permissions · Left click raises, right click lowers the minimum rank for each action · Leader
Promote / Demote · Left click promotes, right click demotes a member · Leader
Upgrade clan size · Spend bank money to add member slots · Leader

New clans start invite only, and only the leader can invite until that setting is changed.

Placeholders

Requires PlaceholderAPI. The identifier is daclans.

Placeholder list

Placeholder · Description
%daclans_name% · The player's clan name
%daclans_leader% · Name of the clan leader
%daclans_members% · Current member count
%daclans_max_members% · Member limit
%daclans_bank% · Bank balance
%daclans_rank% · The player's rank key (for example officer)
%daclans_allies% · Number of allied clans
%daclans_top__name% · Name of the clan in position n on the leaderboard
%daclans_top__value% · Leaderboard value of that clan (bank or members)
%daclans_top__members% · Member count of that clan

Placeholders return an empty string when the player has no clan, or when there is no clan at the requested leaderboard position.

Configuration

File · Contents
config.yml · Storage, hooks, clan limits, ranks, default rank permissions, damage rules, anti-teaming, leaderboard, bounty blocking and every message
settings.yml · Size, title and items of the settings menu, including slots, materials, upgrade cost and size

Configuration options

Key options in config.yml:

clan:
name-regex: "[A-Za-z0-9_]{3,16}"
max-members: 10
invite-expiry-seconds: 60
ally-request-expiry-seconds: 120

default-permissions: # minimum rank required for each action
invite: member
kick: officer
rename: leader
settings: coleader
warn: officer

damage-reduction: # percent, 0 to 100
clan: 0
allies: 0

anti-teaming:
enabled: true
threshold: 2 # attackers from one clan group within the window
window-seconds: 15

leaderboard:
enabled: true
sort: bank # bank or members
page-size: 10
refresh-seconds: 60

Ranks are ordered by level. The lowest rank is given to new members, and the rank with the key leader is reserved for the clan owner:

ranks:
officer:
level: 2
displayname: "Officer"
material: GOLD_INGOT
nexoId: "" # use a Nexo item instead of the material
glowing: false
lore:

• "Trusted clan rank"

Each integration can be switched off under hooks:

hooks:
placeholderapi: true
nexo: true
bountylite: true
vault: true

BountyLite

When BountyLite is installed and hooks.bountylite is on, players cannot place bounties on clan members or allies. The commands and subcommands that are checked are configurable:

bounty:
allow-on-teammates: false
commands:

• bounty

blocked-subcommands:

• set
• bet

Storage

Clans are stored in SQLite by default, in plugins/DaClans/clans.db. To use MySQL, change the storage section in config.yml and restart:

storage:
type: mysql
mysql:
host: localhost
port: 3306
database: daclans
username: root
password: ""

The clans and members tables are created automatically on first start. The database itself must already exist when using MySQL.

Building from source

git clone github.com/malusic23354/DaClans.git
cd DaClans
./gradlew build

The plugin jar is written to build/libs/DaClans-.jar. Java 21 is required.

Support

Found a bug or have a suggestion? Open an issue on the issue tracker. Please include your server software and version, the DaClans version and any relevant console log output.