**The universal bridge between team plugins and everything else.**<\/p>\n
TeamsAPI is a passive, server-side bridge plugin for Paper, Spigot, Purpur, and Folia servers, inspired by Vault. It provides a single, stable interface for team operations, so any plugin that needs team data can work with any compatible team plugin, without either plugin knowing about the other.<\/p>\n
Implemented in Factions fork: https:\/\/www.spigotmc.org\/resources\/pvpindex-factions.135055\/<\/p>\n
Suggest it as suggestion to teams plugins, they can send me a message so I can make a list.<\/p>\n
## How it works<\/p>\n
“`text
\nYour Plugin (consumer) -> TeamsAPI (bridge) -> Team Plugin (provider)
\n“`<\/p>\n
– **Providers** — faction, clan, guild, or custom team plugins `implement TeamsService`
\n and register with TeamsAPI during `onEnable()`.
\n– **Consumers** — scoreboard plugins, chat formatters, quest plugins, or any plugin that
\n needs team data call `TeamsAPI.getService()` and use the returned interface.
\n– **Server owners** — install `TeamsAPI.jar` and one compatible team plugin. Done.<\/p>\n
No two plugins need to know about each other. When the team plugin changes, every
\nconsumer plugin keeps working without a recompile.<\/p>\n
## Features<\/p>\n
– **Provider-agnostic**: works with any team plugin that ships a `TeamsService` implementation.
\n– **Graceful fallback**: if no provider is present, `TeamsAPI.isAvailable()` returns `false`; consumers can disable their team features cleanly instead of crashing.
\n– **Read-only snapshots**: `Team` and `TeamMember` are immutable interfaces; providers own the backing data.
\n– **Role hierarchy**: built-in `OWNER > ADMIN > MEMBER` with `outranks()` and `canManage()` helpers.
\n– **Optional invite service**: providers can expose `TeamsInviteService` for invitation workflows.
\n– **Optional warp service**: providers can expose `TeamsWarpService` for named team warps.
\n– **Optional claim service**: providers can expose `TeamsClaimService` for chunk-claim management.
\n– **Optional power service**: providers can expose `TeamsPowerService` for player and team power values.
\n– **Cancellable events**: twelve Bukkit events that providers can fire so other plugins can react to or cancel team operations.
\n– **Lightweight**: a single shaded JAR with no runtime dependencies beyond the Bukkit API.
\n– **JitPack-ready**: depend on just the API module at compile time; no transitive dependencies leak into your plugin.
\n– **Velocity bridge** *(experimental)*: optional `teams-api-velocity` plugin for querying team data from the Velocity proxy. Supports multi-proxy networks via Redis.
\n– **BungeeCord bridge** *(experimental)*: optional `teams-api-bungeecord` plugin for querying team data from BungeeCord \/ Waterfall proxies. Supports multi-proxy networks via Redis.<\/p>\n
## Requirements<\/p>\n
| Requirement | Value |
\n|————-|——-|
\n| Server software | Paper \/ Spigot \/ Purpur \/ Folia 1.16+ |
\n| Java | 17+ (25 recommended) |
\n| Plugin dependencies | None |<\/p>\n
## Installation (server owners)<\/p>\n
1. Download `teams-api-plugin-VERSION.jar` from the **Files** tab of this listing or
\n from GitHub Releases.
\n2. Drop it into your server’s `plugins\/` directory.
\n3. Install a compatible team plugin that provides a `TeamsService` implementation.
\n4. Restart the server.<\/p>\n
TeamsAPI has no configuration files.<\/p>\n
## For developers<\/p>\n
Add the API artifact to your project via JitPack:<\/p>\n
### Maven<\/p>\n
“`xml ### Gradle<\/p>\n “`groovy ### Consumer quick-start<\/p>\n Declare the dependency in `plugin.yml` (use `softdepend` if team support is optional):<\/p>\n “`yaml Then use the API at runtime:<\/p>\n “`java \/\/ In a command or listener: ### Provider quick-start<\/p>\n Declare a soft-dependency in `plugin.yml`:<\/p>\n “`yaml Register your implementation when the plugin loads:<\/p>\n “`java @Override ## API surface<\/p>\n ### Team lifecycle & lookup<\/p>\n | Method | Returns | Description | ### Membership management<\/p>\n | Method | Returns | Description | ### Invite service (optional)<\/p>\n Register alongside `TeamsService` if your plugin supports invitations:<\/p>\n “`java | Method | Returns | Description | Consumers check availability with `TeamsAPI.isInviteAvailable()` before calling `TeamsAPI.getInviteService()`.<\/p>\n ### Warp service (optional)<\/p>\n Register alongside `TeamsService` if your plugin supports team warps:<\/p>\n “`java | Method | Returns | Description | Consumers check availability with `TeamsAPI.isWarpAvailable()` before calling `TeamsAPI.getWarpService()`.<\/p>\n ### Claim service (optional)<\/p>\n Register alongside `TeamsService` if your plugin supports chunk claims:<\/p>\n “`java | Method | Returns | Description | Consumers check availability with `TeamsAPI.isClaimAvailable()` before calling `TeamsAPI.getClaimService()`.<\/p>\n ### Power service (optional)<\/p>\n Register alongside `TeamsService` if your plugin exposes power values:<\/p>\n “`java | Method | Returns | Description | Consumers check availability with `TeamsAPI.isPowerAvailable()` before calling `TeamsAPI.getPowerService()`.<\/p>\n ### Events<\/p>\n All events live in `com.skyblockexp.teamsapi.event`. Providers are encouraged but not required to fire them.<\/p>\n | Event | Cancellable | Fired when | ### Roles<\/p>\n | Role | Priority | Description | ## Links<\/p>\n – GitHub — source code & issue tracker —<\/p>\n *MIT License – free to use in any project, open- or closed-source.*<\/p>\n","protected":false},"excerpt":{"rendered":" TeamsAPI is a passive, server-side bridge plugin for Paper servers, inspired by Vault<\/p>\n","protected":false},"featured_media":152458,"template":"","meta":{"_minecraft_slug":"teams-api","_minecraft_project_id":"2NJKwgXC","_minecraft_author":"Shadow48402","_minecraft_license":"MIT","_minecraft_downloads":60,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"teams-api.zip","_minecraft_size_bytes":6039983,"_minecraft_version_count":12,"_minecraft_updated_at":"2026-05-15T21:21:00.689805Z","_minecraft_date_created":"2026-04-29T23:47:18.403163Z","_minecraft_date_modified":"2026-05-16T12:46:47.270450Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/teams-api","_minecraft_icon_attachment_id":152458,"_minecraft_imported_at":"2026-06-09T05:17:58+00:00","_minecraft_import_hash":"22d9ffc107b341be8ec23f92f19e97d6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,125,89,873,126,127,128,129,92,985,992],"mod_loader":[130,895,131,132,133,134,986,993],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-152457","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-folia","mod_category-game-mechanics","mod_category-library","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_category-velocity","mod_category-waterfall","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-velocity","mod_loader-waterfall","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n
\n
\n
\n
\n <\/repository>
\n<\/repositories><\/p>\n
\n
\n
\n
\n
\n<\/dependency>
\n“`<\/p>\n
\nrepositories {
\n maven { url ‘https:\/\/jitpack.io’ }
\n}
\ndependencies {
\n compileOnly ‘com.github.ez-plugins:teams-api:1.4.0’
\n}
\n“`<\/p>\n
\ndepend:
\n – TeamsAPI
\n“`<\/p>\n
\n@Override
\npublic void onEnable() {
\n if (!TeamsAPI.isAvailable()) {
\n getLogger().warning(“No team plugin found. Team features disabled.”);
\n return;
\n }
\n getLogger().info(“TeamsAPI found. Team features enabled.”);
\n}<\/p>\n
\nTeamsService teams = TeamsAPI.getService();
\nOptional
\nteam.ifPresent(t -> player.sendMessage(“Your team: ” + t.getDisplayName()));
\n“`<\/p>\n
\nsoftdepend:
\n – TeamsAPI
\n“`<\/p>\n
\n@Override
\npublic void onEnable() {
\n TeamsAPI.registerProvider(this, new MyTeamsService(this));
\n}<\/p>\n
\npublic void onDisable() {
\n TeamsAPI.unregisterProvider(teamsService);
\n}
\n“`<\/p>\n
\n|——–|———|————-|
\n| `createTeam(name, ownerUUID)` | `Optional
\n| `deleteTeam(teamId)` | `boolean` | Deletes a team by UUID |
\n| `getTeam(teamId)` | `Optional
\n| `getTeamByName(name)` | `Optional
\n| `getPlayerTeam(playerUUID)` | `Optional
\n| `getAllTeams()` | `Collection
\n| `getTeamCount()` | `int` | Total number of teams |<\/p>\n
\n|——–|———|————-|
\n| `addMember(teamId, playerUUID, role)` | `boolean` | Adds a player with a given role |
\n| `removeMember(teamId, playerUUID)` | `boolean` | Removes a player from the team |
\n| `setMemberRole(teamId, playerUUID, role)` | `boolean` | Changes a member’s role |
\n| `getMemberRole(teamId, playerUUID)` | `Optional
\nTeamsAPI.registerInviteProvider(this, inviteService);
\n“`<\/p>\n
\n|——–|———|————-|
\n| `invitePlayer(teamId, inviterUUID, inviteeUUID)` | `boolean` | Sends an invitation |
\n| `acceptInvite(teamId, playerUUID)` | `Optional
\n| `declineInvite(teamId, playerUUID)` | `boolean` | Declines an invitation |<\/p>\n
\nTeamsAPI.registerWarpProvider(this, warpService);
\n“`<\/p>\n
\n|——–|———|————-|
\n| `setWarp(teamId, name, location, creatorUUID)` | `boolean` | Creates or updates a named warp |
\n| `removeWarp(teamId, name)` | `boolean` | Deletes a warp by name |
\n| `getWarp(teamId, name)` | `Optional
\n| `getWarps(teamId)` | `Collection
\nTeamsAPI.registerClaimProvider(this, claimService);
\n“`<\/p>\n
\n|——–|———|————-|
\n| `claimChunk(teamId, playerUUID, world, x, z)` | `boolean` | Claims a chunk for the team |
\n| `unclaimChunk(teamId, playerUUID, world, x, z)` | `boolean` | Removes the claim |
\n| `unclaimAll(teamId)` | `boolean` | Removes all claims for the team |
\n| `getClaimAt(world, x, z)` | `Optional
\n| `getTeamClaims(teamId)` | `Collection
\n| `getClaimCount(teamId)` | `int` | Number of claimed chunks |
\n| `isClaimed(world, x, z)` | `boolean` | Whether the chunk is claimed by anyone |
\n| `isClaimedBy(teamId, world, x, z)` | `boolean` | Whether the chunk is claimed by this team |
\n| `getTeamMaxClaims(teamId)` | `int` | Claim limit (-1 means unlimited) |<\/p>\n
\nTeamsAPI.registerPowerProvider(this, powerService);
\n“`<\/p>\n
\n|——–|———|————-|
\n| `getPlayerPower(playerUUID)` | `double` | Current power of the player |
\n| `getPlayerMaxPower(playerUUID)` | `double` | Maximum power the player can hold |
\n| `setPlayerPower(playerUUID, power)` | `boolean` | Sets the player’s power |
\n| `getTeamPower(teamId)` | `double` | Combined power of all team members |
\n| `getTeamMaxPower(teamId)` | `double` | Maximum combined power the team can hold |<\/p>\n
\n|——-|————-|————|
\n| `TeamCreateEvent` | Yes | Before a team is created |
\n| `TeamDeleteEvent` | Yes | Before a team is deleted |
\n| `TeamJoinEvent` | Yes | Before a player joins a team |
\n| `TeamLeaveEvent` | Yes | Before a player leaves a team |
\n| `TeamRoleChangeEvent` | Yes | Before a member’s role changes |
\n| `TeamInviteEvent` | Yes | Before an invitation is sent |
\n| `TeamInviteAcceptEvent` | No | After a player accepts an invitation |
\n| `TeamInviteDeclineEvent` | No | After a player declines an invitation |
\n| `TeamWarpSetEvent` | Yes | Before a warp is created or updated |
\n| `TeamWarpDeleteEvent` | Yes | Before a warp is deleted |
\n| `TeamClaimEvent` | Yes | Before a chunk is claimed |
\n| `TeamUnclaimEvent` | Yes | Before a chunk is unclaimed |<\/p>\n
\n|——|———-|————-|
\n| `OWNER` | 100 | Full control; cannot be removed by others |
\n| `ADMIN` | 50 | Can manage members with a lower priority |
\n| `MEMBER` | 10 | Regular team member |<\/p>\n
\n– Developer Guide — full integration walkthrough
\n– API Reference — complete method tables
\n– JitPack — Maven \/ Gradle dependency<\/p>\n