New: Official Provider Extensions

TeamsAPI 2.2.0 introduces three ready-to-use provider extensions. Each extension is bundled inside the main teams-api-plugin JAR and is automatically provisioned to:

plugins/TeamsAPI/extensions/

on first startup.

BetterTeams
teams-api-extension-betterteams

• Exposes teams, members, invites, warps, and ally/neutral relations through TeamsAPI.
• Invite support: invitePlayer and declineInvite work for offline players.
• acceptInvite requires the invitee to be online at the time of the call.
• Relation support covers ALLY and NEUTRAL.
• BetterTeams does not model enemies or truces.
• Supported relation constants: MEMBER, ALLY, NEUTRAL.

Towny Advanced
teams-api-extension-towny

• Maps Towny towns to TeamsAPI teams.
• Maps residents to members.
• Maps nation relationships such as allies and enemies to TeamsAPI relation constants.
• Claim lookup is fully supported.
• Claim and unclaim mutations are not exposed, because Towny manages its own chunk lifecycle.
• Supported relation constants: MEMBER, ALLY, ENEMY, NEUTRAL.
• TRUCE is normalized to NEUTRAL.

KingdomsX
teams-api-extension-kingdomsx

• Maps KingdomsX kingdoms to TeamsAPI teams.
• Maps KingdomsX members to TeamsAPI members.
• Maps diplomatic relations to TeamsAPI relation constants.
• Claim lookup is supported.
• Claim and unclaim mutations return false, because they require a live KingdomPlayer context that is not available through TeamsAPI.
• Power is read-only.
• getPlayerMaxPower and getTeamMaxPower always return 0.0, because KingdomsX does not expose a per-player power ceiling through its public API.
• Supported relation constants: MEMBER, ALLY, TRUCE, ENEMY, NEUTRAL.
• Relations are applied symmetrically.

New: Extension Management Commands

Command	Permission	Description
/teamsapi install <extension>	teamsapi.install - OP	Copies a bundled extension JAR to plugins/TeamsAPI/extensions/. Valid names: betterteams, towny, kingdomsx.
/teamsapi load <file>.jar	teamsapi.load - OP	Loads and enables an extension from plugins/TeamsAPI/extensions/ without requiring a server restart.

Installation Quick-Start

1. Install TeamsAPI and start the server once.
2. TeamsAPI automatically copies the bundled extension JARs to plugins/TeamsAPI/extensions/.
3. Make sure the matching team plugin is installed, such as BetterTeams, Towny Advanced, or KingdomsX.
4. Run /teamsapi install betterteams, /teamsapi install towny, or /teamsapi install kingdomsx to stage a provider extension.
5. Restart the server, or load the extension immediately with a command such as:
   /teamsapi load teams-api-extension-betterteams-2.2.0.jar

Documentation

Full details, supported features, and the complete provider feature matrix are available in the official Provider Catalog:

https://ez-plugins.github.io/teams-api/provider-catalog.html