Kyvera Clans — V1.2.2

By Kyvera Studios

Clan progression and bank

• Added persistent clan XP, configurable levels and level-up events.
• Added a virtual clan bank with configurable balance limits, transaction limits and withdrawal permissions.
• Added /clan progress to view clan progression, balance and linked plots.

Configurable clan costs

• Added individual prices for clan creation, renaming, color changes, display tags, descriptions, recruitment changes and invitations.
• Added an admin costs menu under /kyveraclans features.
• Added economy-provider selection and optional exemptions for admin management.
• All prices default to zero.
• Invalid or unchanged actions are not charged.
• Paid actions require a custom economy integration using the new ClanEconomy API.

Clan management

• Added clan renaming for leaders and administrators.
• Renaming preserves the clan ID, members, XP, bank balance and linked plots.
• The display tag remains independently configurable.

Developer API and integrations

• Added a public ClanApi service for clan information, XP rewards, bank transactions and plot associations.
• Added immutable clan snapshots, cancellable request events and change notifications.
• Added durable operation IDs to detect duplicate and conflicting API requests.
• Added a separate API SDK for developers.
• Added payment reservations and recovery records for compatible economy providers.

Plot settings

• Added configurable plot associations, level-based plot limits and permission policies.
• Added settings for building, containers, PvP and explosions.
• Administrators can configure default policies and individual clan overrides.

Languages and documentation

• Expanded English and German translations for the new features.
• English remains the default language.
• Expanded config.yml with English explanations while preserving existing configured values.
• Included English README and API documentation in the JAR.
• Added step-by-step API setup and economy integration examples.

Storage and validation

• Updated clan data to schema 4, with support for reading older schemas.
• Added persistent recovery records for unfinished fee transactions.
• Passed 52 standalone regression tests and compilation against Paper 26.2 with Java 25.

Integration notes: The clan bank is virtual. Paid player actions require a custom economy provider; no direct Vault adapter is included. Plot generation and terrain protection require a compatible bridge. Live testing across Paper 26.1.2–26.2 and with external providers remains pending.