SovereignNation

SovereignNation is a high-performance political federation and diplomacy plugin designed to expand BetterTeams into full geopolitical gameplay. It allows clan owners to federate multiple teams under a unified sovereign banner, manage shared treasuries, and handle diplomatic relations without interfering with existing land-claim plugins.

Built natively for modern Paper and Spigot ecosystems (1.21+), SovereignNation operates purely as an administrative and political overlay with zero performance overhead.

Dependencies

• BetterTeams (Required): Core team management, team data access, and player rank validation.
• Vault (Optional): Required only if you want to use the /nation deposit and /nation withdraw treasury commands.
• PlaceholderAPI (Optional): Required to display nation variables in TAB, scoreboards, or chat plugins.

Key Features

• Team Federation: Band multiple BetterTeams together under one nation. A founding team acts as the capital, while member clans retain their internal identities and rosters.
• Shared Nation Treasury: Fully integrated with Vault. Federated teams can pool money into a national bank account for major projects or military expenses.
• Diplomatic Relations: Forge mutual alliances or unilaterally declare enemy states with real-time status tracking.
• PlaceholderAPI Support: Native expansion (%sovereign_*%) to easily display nation tags, capital cities, member counts, and balances in TAB, scoreboards, and chat plugins.
• Asynchronous Persistence: All data is automatically saved to disk (nations.json) both upon command execution and via periodic background autosaves.
• Claim-Engine Friendly: Non-intrusive architecture designed to run seamlessly alongside claim systems like RedProtect and LandClaimPlus.

Commands & Subcommands

PlaceholderAPI Integration

Use the following placeholders anywhere PAPI is supported:

• %sovereign_nation_name% — Displays the player's nation name (or None).
• %sovereign_nation_capital% — Displays the capital team of the player's nation.
• %sovereign_nation_balance% — Returns the current nation treasury balance.
• %sovereign_nation_teams_count% — Total count of federated member teams.
• %sovereign_nation_allies_count% — Number of allied nations.
• %sovereign_nation_enemies_count% — Number of hostile/enemy nations.
• %sovereign_is_capital% — Returns true if the player's team is the nation's capital.