CoreClans

!Cover

**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

Features

• 3 war objectives: Capture / Beacon / Crystal
• 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

War Objectives

• Capture: hold objective area to fill progress
• Beacon: 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

!maincmd

Main Commands

/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 /clan bank withdraw /clan bank history

/clan level /clan tax info /clan tax pay

/clan ally /clan enemy /clan neutral /clan truce [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 <capture|beacon|crystal> [stake] /clan war accept /clan war deny /clan war info /clan war forfeit /clan war requests /clan war log /clan war history

/clan siege window set /clan siege window view /clan siege window clear

/clan bounty create /clan bounty info

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

!Perm
## Permissions
- `coreclans.user`
- `coreclans.admin`
- `coreclans.bypass`

!comb
## 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
## 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

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