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`