?
Host a serverModrinth App
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
DaClans

DaClans

Clans Plugin made in Kotlin with full configuration to it's configs, messages and settings and NexoMC support for item configs.

3downloads
0followers
3downloads
0followers

Compatibility

Minecraft: Java Edition

26.3
26.2
26.1.x
1.21.11

Platforms

Links

Report issues View source Join Discord server

Tags

Creators

Details

Licensed ARR
Published 52 minutes ago
Updated 4 days ago

DaClans

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

Version Platform Minecraft Language Java

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 <name> Create a clan Anyone not in a clan
/clan disband Delete your clan Leader
/clan rename <name> Rename your clan Minimum rank set for rename
/clan invite <player> 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 <player> Raise a member one rank Leader
/clan demote <player> Lower a member one rank Leader
/clan setowner <player> Hand leadership to another member Leader
/clan kick <player> 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 <clan> Send, accept or end an alliance Leader
/clan enemy <clan> Toggle a clan as your enemy Leader
/clan warn <player> <message> Send a warning to a member Minimum rank set for warn
/clan deposit <amount> 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 <name> daclans.command.create
/clan disband daclans.command.disband
/clan rename <name> daclans.command.rename
/clan invite <player> daclans.command.invite
/clan join [clan] daclans.command.join
/clan leave daclans.command.leave
/clan promote <player> daclans.command.promote
/clan demote <player> daclans.command.demote
/clan setowner <player> daclans.command.setowner
/clan kick <player> daclans.command.kick
/clan settings daclans.command.settings
/clan ally <clan> daclans.command.ally
/clan enemy <clan> daclans.command.enemy
/clan warn <player> <message> daclans.command.warn
/clan deposit <amount> 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_<n>_name% Name of the clan in position n on the leaderboard
%daclans_top_<n>_value% Leaderboard value of that clan (bank or members)
%daclans_top_<n>_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: "<yellow>Officer"
    material: GOLD_INGOT
    nexoId: ""           # use a Nexo item instead of the material
    glowing: false
    lore:
      - "<dark_gray>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 https://github.com/malusic23354/DaClans.git
cd DaClans
./gradlew build

The plugin jar is written to build/libs/DaClans-<version>.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.