ClanForge is a modern, modular clans plugin for Spigot/Paper (1.20+). It focuses on fair PvP, community building, and server-friendly management tools. ClanForge provides flexible ranks and permissions, economy integration, land sharing hooks, wars, chat channels, leaderboards, and a clean API for developers. It aims to be feature-rich while remaining configurable and performant.

Key Features

- Clan management with default ranks (leader, trusted, member) and custom roles.
- Economy support via Vault : banks, upkeep, member fees, and kill rewards.
- Land sharing integrations: WorldGuard , PlotSquared , GriefPrevention .
- Wars, alliances, rivalries, friendly fire controls, and regroup/home.
- KDR tracking, leaderboards via commands or GUI, bulletin boards.
- Clan and alliance chat with spy mode, PlaceholderAPI placeholders.
- Storage support for MySQL and SQLite (configurable).
- Developer-friendly API with 25+ planned events.
- Voting flows, tamable mobs sharing rules, vitals/coordinates sharing.
- Smart tab completions and polished UX.
Current State (honest overview)

- Implemented: base plugin, /clan command ( create , info , leave , list ), in-memory clan manager, config and soft-dependencies, Vault hook, basic PlaceholderAPI expansion, storage scaffolding (MySQL/SQLite).
- In progress/planned: full persistence (schema/CRUD), GUI menus, war management, land sharing rules, moderation commands, extended API events, Discord integration, and web stats.
Integrations

- Optional dependencies: Vault , PlaceholderAPI , WorldGuard , PlotSquared , GriefPrevention .
- ClanForge detects and hooks these when present, with feature toggles in config.yml .
Commands (initial)

- /clan create <name> — create a new clan.
- /clan info — show your clan details.
- /clan leave — leave your current clan.
- /clan list — list existing clans.
- Additional commands (ranks, wars, bank, chat, alliances) are being added as modules mature.
Configuration & Storage

- config.yml lets you enable/disable modules, set economy values, and choose mysql or sqlite .
- Default is lightweight, in-memory operation; production servers should configure persistence.
Why Choose ClanForge

- Balanced, server-friendly design with clear toggles for every system.
- Clean codebase and API to extend or integrate with your ecosystem.
- Roadmap-driven development with transparency about what’s implemented vs planned.