SomeClans

SomeClans is a clan plugin for Paper / Purpur 1.16.5+ with economy, GUI, clan upgrades, clan effects, wallet support, placeholders, MySQL / SQLite storage, and admin tools.

Features

• Clan creation, invitations, roles, clan chat, and clan management
• GUI-based clan menus
• Clan wallet with:
  • coin deposit / withdraw
  • PlayerPoints deposit / withdraw
• Clan upgrades:
  • member slots
  • effect slots
  • clan chest size
• Clan effects and active / purchased effect logic
• Clan chest with shared storage
• Configurable friendly-fire between clan members
• Clan armor color selection in GUI
• PlaceholderAPI support
• MySQL / SQLite / local storage mode
• Admin cache sync from database
• Admin and member action logs in database:
  • adminlogs
  • memberlogs

Requirements

• Java 17+
• Paper / Purpur 1.16.5 - 1.20.x

Optional plugins:

• Vault
• CMI or another economy provider through Vault
• PlaceholderAPI
• PlayerPoints

Installation

1. Build the plugin:

mvn -U -q -DskipTests package

1. Put the built jar from target/ into your server plugins/ folder.
2. Start the server.
3. Configure the generated files in the plugin folder.

Generated files

On first launch the plugin creates:

plugins/SomeClans/
├── config.yml
├── messages.yml
├── gui.yml
├── upgrades.yml
├── effects.yml
└── data/

If SQLite is enabled, the database file is stored in plugins/SomeClans/data/.

Storage

Supported storage modes:

• MYSQL
• SQLITE
• LOCAL

Database tables:

• clans
• members
• adminlogs
• memberlogs

Main commands

Player commands

• /clan
• /clan create <name>
• /clan tag <tag>
• /clan invite <player>
• /clan accept
• /clan deny
• /clan leave
• /clan disband
• /clan deposit <amount>
• /clan withdraw <amount>
• /clan chat <message>
• /clan togglechat
• /clan members
• /clan upgrades
• /clan effects

Admin commands

• /clanadmin reload
• /clanadmin delete <clan>
• /clanadmin setlevel <clan> <level>
• /clanadmin addmoney <clan> <amount>
• /clanadmin info <player>
• /clanadmin look <clan>
• /clanadmin updatebydatabase

Permissions

• someclans.use
• someclans.create
• someclans.invite
• someclans.join
• someclans.leave
• someclans.chat
• someclans.admin

Placeholders

Requires PlaceholderAPI.

• %someclans_name%
• %someclans_tag%
• %someclans_level%
• %someclans_role%
• %someclans_members%
• %someclans_balance%
• %someclans_points%

Behavior:

• %someclans_name% returns clan tag if set
• if tag is empty, it returns the clan name
• if the player has no clan, it returns the configured fallback value

Economy

Supported economy sources:

• Vault
• CMI

Clan wallet supports two separate balances:

• coins
• PlayerPoints

Clan chest

• Shared clan chest
• Upgrade-based size growth
• Shift-click is allowed in the clan chest
• Number key hotbar transfer is allowed in the clan chest
• Fast item transfer is blocked in other GUI menus

Visual armor mode

Clan armor color is visual for clan members.

Important:

• real armor items and stats are not changed
• viewers in the same clan receive a colored visual equipment update
• other players still see the real armor

Build notes

If mvn package fails during shading with an error similar to:

Could not replace original artifact with shaded artifact

it usually means the previous jar in target/ is locked by the server or another process.

Project

• Language: Java 17
• API: Paper 1.16.5
• Build tool: Maven