CoreClans

Fair clan wars plugin with objective battles, siege windows, anti-zerg balance, clan progression, admin clan GUI, and JSON storage.

Why CoreClans

CoreClans is built for survival and competitive servers that want wars to be fair, scheduled, and transparent instead of random 24/7 chaos.

Features

- 3 war objectives: JSON - Siege windows (scheduled war availability) - Anti-zerg balance (online advantage penalties) - Optional attacker queue + attacker cap - War replay summary + MVP stats - Clan bank + stake pot system - Bounty contracts - Clan levels + EXP + perk bonuses - Weekly clan tax + war freeze on unpaid cycles - Bank history log - Admin clan browser/management GUI - PlaceholderAPI placeholders - Configurable GUI menus from files - Local JSON storage (no MySQL/SQLite required)

War Objectives

- Crystal: hold objective area to fill progress - Crystal: hold-mode on separate beacon objective - Crystal: destroy enemy crystal core

Current Rewards

- Winner: `+100` season points - Winner: `+100` clan bank - Winner receives full stake pot (if war had stake) - Loser: `-30` season points

Main Commands

```text /clan menu [main|war|objectives|members|bank|bank_history|war_requests|war_history|admin] /clan create <name> /clan disband confirm /clan info [clan] /clan list /clan top /clan online

/clan invite <player> /clan join <name> /clan leave /clan kick <player> /clan promote <player> /clan demote <player> /clan owner <player> confirm

/clan chat <message> /clan chat toggle /clan sethome /clan home /clan claim set [radius]

/clan bank /clan bank deposit <amount> /clan bank withdraw <amount> /clan bank history

/clan level /clan tax info /clan tax pay

/clan ally <clan> /clan enemy <clan> /clan neutral <clan> /clan truce <clan> [minutes]

/clan objective set <capture|beacon|crystal> /clan objective remove <capture|beacon|crystal> /clan objective preview [capture|beacon|crystal] /clan objective validate /clan objective list

/clan war challenge <clan> <capture|beacon|crystal> [stake] /clan war accept <id> /clan war deny <id> /clan war info /clan war forfeit /clan war requests /clan war log /clan war history

/clan siege window set <day> <start> <end> /clan siege window view /clan siege window clear <day>

/clan bounty create <targetClan> <reward> /clan bounty info

/clanadmin menu [admin|main|war|objectives] /clanadmin reload /clanadmin war stop <clan> /clanadmin war start <attacker> <defender> <capture|beacon|crystal> /clanadmin season reset [name] /clanadmin points set <clan> <value> /clanadmin debug path <clan> <capture|beacon|crystal> ```

Permissions

- `coreclans.user` - `coreclans.admin` - `coreclans.bypass`

Compatibility

- Minecraft: `1.16.5+` - Cores: `Spigot` / `Paper` / `Purpur` - Java: compiled for `Java 8` (works on newer Java, including `Java 17/21`) - Optional dependencies: `Vault`, `PlaceholderAPI`

GUI Customization

All menus are editable in: ```text plugins/CoreClans/menus/ - main.yml - war.yml - objectives.yml - admin.yml - admin_clans.yml - admin_clan_manage.yml - members.yml - member_manage.yml - bank.yml - bank_history.yml - war_requests.yml - war_history.yml ```

Storage

```text plugins/CoreClans/coreclans-data.json plugins/CoreClans/war-history.json ```

Placeholders

You can view all placeholders on GitHub. ##

Bugs / Suggestions

- If you found a bug or want a feature, please open an issue/discussion with: - CoreClans version - Server core + Minecraft version - Java version - Steps to reproduce