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

Command	Permission	Description
/nation create <name>	sovereignnation.create	Establish a new nation with your team as the capital.
/nation invite <team>	sovereignnation.use	Invite another BetterTeams clan to federate.
/nation join <nation>	sovereignnation.use	Accept a pending federation invitation.
/nation leave	sovereignnation.use	Withdraw your clan from a federated nation.
/nation kick <team>	sovereignnation.use	Remove a member team (Capital owner only).
/nation deposit <amount>	sovereignnation.use	Deposit personal funds into the nation treasury.
/nation withdraw <amount>	sovereignnation.use	Withdraw funds from the treasury (Capital owner only).
/nation ally <nation>	sovereignnation.use	Propose or finalize a mutual alliance.
/nation enemy <nation>	sovereignnation.use	Declare another nation as an enemy.
/nation neutral <nation>	sovereignnation.use	Reset diplomatic relations to neutral.
/nation info [name]	sovereignnation.use	View detailed overview of a nation.
/nation list	sovereignnation.use	List all registered nations on the server.
/nation disband	sovereignnation.use	Dissolve the nation permanently (Capital owner only).

---

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.