Clan Forge

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 — 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.