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

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

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