SomeClans

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:

```bash mvn -U -q -DskipTests package ```

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

Generated files

On first launch the plugin creates:

```text 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:

```text 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`