Teams999
No reviews yet
A Minecraft plugin that lets players create, manage, and join teams with roles, invites, and team homes.
Paper is a fork of Spigot that adds its own plugin API on top of the Bukkit API. All Spigot plugins are compatible with paper, not all paper plugins are compatible with Spigot.
Spigot is a popular software for running dedicated servers that can load Plugins created with the Bukkit API.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Compatibility
Supported Environments
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description
Features
Team Management
- Create and disband teams
- Invite players to your team, with configurable expiry and optional economy cost
- Kick players, promote/demote members, and transfer leadership
- Rename your team with optional cost and cooldown
- Set a team message of the day (MOTD)
- View team info in a GUI (level, members, homes, warps, MOTD)
- List all teams and see online team members
- Check team level progress with
/team level
Team Levels and Limits
- Team level is based on member-count thresholds
- Level-based limits for homes, alliances, and vault size
- Role daily withdrawal limits can scale by team level
Team Homes
- Set, teleport to, and delete named team homes
/team homelists homes when no name is provided- Base max homes with optional level-based overrides
- Per-world toggles for homes
- Per-player teleport cooldown (shared with warps)
Team Warps
- Shared warps that are separate from homes
/team warplists warps when no name is provided- Uses the same world toggle and teleport cooldown as homes
- By default, only the team owner can set or delete warps, while members can use and list them
Team Vault
- Shared storage with size based on config and team level
- Permission-based access for open, deposit, and withdraw
- Role daily withdrawal limits with team-level multipliers
- Per-world vault toggle
- Auto-saves vault contents
Team Chat
- Toggle team-only chat and ally chat
- Mute or unmute members in team chat
- Optional role prefix display in player name tags and tab list (
/team showrole) - Per-world chat toggles
Alliance System
- Invite, accept, decline, break, and list alliances
- Ally chat for cross-team communication
- Friendly-fire protection when enabled
- Configurable max alliances with level-based overrides
- Configurable cooldown after breaking an alliance
Role System
- Default roles with configurable permissions and priorities
- Custom roles per team
- Starting role for new members is configurable
- Role priority enforces promotion, demotion, and management rules
- Internal permissions are not server permissions
Team Colors
- 15 available team colors
- Random color on creation or default green
- Team colors show in chat, player list, and name tags
/team colorto change color and/team colorsto list options
Trust System
- Toggle a trusted flag for members
- Stored with team data (no extra permissions by default)
Economy Integration
- Invite cost and rename cost use Vault economy if enabled
Commands
Team Commands
| Command | Description |
|---|---|
/team create <name> |
Create a new team |
/team disband |
Disband your team |
/team invite <player> |
Invite a player to your team |
/team accept |
Accept a team invitation |
/team leave |
Leave your current team |
/team kick <player> |
Kick a player from the team |
/team promote <player> |
Promote a player to a higher role |
/team demote <player> |
Demote a player to a lower role |
/team transfer <player> |
Transfer leadership to another member |
/team info |
View team information in a GUI |
/team level |
Show team level and progress to next level |
/team list |
List all teams on the server |
/team online |
List online team members |
/team sethome <name> |
Set a named team home |
/team home [name] |
Teleport to a team home or list homes |
/team delhome <name> |
Delete a team home |
/team setwarp <name> |
Set a named team warp |
/team warp [name] |
Teleport to a team warp or list warps |
/team delwarp <name> |
Delete a team warp |
/team warplist |
List all team warps |
/team rename <name> |
Rename your team |
/team motd <message> |
Set the team message of the day |
/team chat |
Toggle team-only chat |
/team vault |
Open the team vault |
/team trust <player> |
Toggle trusted status for a player |
/team mute <player> |
Mute or unmute a player in team chat |
/team showrole |
Toggle role prefix display in name tags and tab list |
/team role |
Role management subcommands |
/team color <color> |
Change your team's display color |
/team colors |
List available team colors |
/team reload |
Reload config and save data (requires teams999.reload) |
Role Commands
| Command | Description |
|---|---|
/team role create <name> |
Create a custom role |
/team role delete <name> |
Delete a custom role |
/team role list |
List all roles in your team |
/team role info <name> |
View details about a role |
/team role assign <player> <role> |
Assign a role to a player |
/team role perm add <role> <perm> |
Add a permission to a custom role |
/team role perm remove <role> <perm> |
Remove a permission from a custom role |
Alliance Commands
| Command | Description |
|---|---|
/ally invite <team> |
Invite a team to form an alliance |
/ally accept |
Accept an alliance invitation |
/ally decline |
Decline an alliance invitation |
/ally break <team> |
Break an alliance with a team |
/ally chat |
Toggle alliance-only chat |
/ally list |
List your team's alliances |
Command Aliases
/teamcan also be used as/t/allycan also be used as/a
Internal Permissions
These permissions control what team members can do based on their role. They are NOT server permissions and do not work with permission plugins like LuckPerms.
Member Management
| Permission | Description |
|---|---|
team.invite |
Invite players to the team |
team.kick |
Kick players from the team |
team.promote |
Promote players to higher roles |
team.demote |
Demote players to lower roles |
team.role.assign |
Assign roles to players |
team.role.create |
Create custom roles |
team.role.delete |
Delete custom roles |
Team Settings
| Permission | Description |
|---|---|
team.motd.set |
Set the message of the day |
team.name.change |
Rename the team |
team.color.change |
Change the team's display color |
team.disband |
Disband the team |
team.transfer |
Transfer leadership to another player |
Vault
| Permission | Description |
|---|---|
team.vault.open |
Open the team vault |
team.vault.deposit |
Put items into the vault |
team.vault.withdraw |
Take items from the vault |
Chat
| Permission | Description |
|---|---|
team.chat.toggle |
Toggle between chat modes |
team.chat.team |
Send messages in team chat |
team.chat.ally |
Send messages in ally chat |
team.chat.moderate |
Mute and unmute team members |
Alliances
| Permission | Description |
|---|---|
team.ally.invite |
Send alliance invitations |
team.ally.accept |
Accept alliance invitations |
team.ally.break |
Break alliances |
Homes
| Permission | Description |
|---|---|
team.home.set |
Set team home locations |
team.home.delete |
Delete team home locations |
team.home.use |
Teleport to team homes |
Warps
| Permission | Description |
|---|---|
team.warp.set |
Set team warp locations |
team.warp.delete |
Delete team warp locations |
team.warp.use |
Teleport to team warps and list them |
Other
| Permission | Description |
|---|---|
team.info.view |
View team information |
team.trust |
Toggle trusted status for members |
Reserved (No Effect Yet)
| Permission | Description |
|---|---|
team.vault.lockedSlots |
Reserved for future vault slot locking |
team.claim |
Reserved for future land claim features |
team.unclaim |
Reserved for future land claim features |
team.war.start |
Reserved for future war features |
team.war.accept |
Reserved for future war features |
Role Permission Matrix
This table reflects the default role permissions from config.yml. The Leader has all internal permissions.
| Permission | Leader | Co-Leader | Officer | Member | Recruit |
|---|---|---|---|---|---|
team.invite |
Yes | Yes | Yes | No | No |
team.kick |
Yes | Yes | Yes | No | No |
team.promote |
Yes | Yes | No | No | No |
team.demote |
Yes | Yes | No | No | No |
team.role.assign |
Yes | Yes | No | No | No |
team.role.create |
Yes | Yes | No | No | No |
team.role.delete |
Yes | Yes | No | No | No |
team.motd.set |
Yes | Yes | No | No | No |
team.name.change |
Yes | No | No | No | No |
team.color.change |
Yes | No | No | No | No |
team.disband |
Yes | No | No | No | No |
team.transfer |
Yes | No | No | No | No |
team.vault.open |
Yes | Yes | Yes | Yes | No |
team.vault.deposit |
Yes | Yes | Yes | Yes | No |
team.vault.withdraw |
Yes | Yes | Yes | No | No |
team.chat.toggle |
Yes | Yes | Yes | Yes | No |
team.chat.team |
Yes | Yes | Yes | Yes | Yes |
team.chat.ally |
Yes | Yes | Yes | Yes | No |
team.chat.moderate |
Yes | Yes | Yes | No | No |
team.ally.invite |
Yes | Yes | No | No | No |
team.ally.accept |
Yes | Yes | No | No | No |
team.ally.break |
Yes | Yes | No | No | No |
team.home.set |
Yes | Yes | Yes | No | No |
team.home.delete |
Yes | Yes | Yes | No | No |
team.home.use |
Yes | Yes | Yes | Yes | No |
team.warp.set |
Yes | No | No | No | No |
team.warp.delete |
Yes | No | No | No | No |
team.warp.use |
Yes | Yes | Yes | Yes | No |
team.info.view |
Yes | Yes | Yes | Yes | Yes |
team.trust |
Yes | Yes | No | No | No |
Configuration
Team Settings
| Setting | Default | Description |
|---|---|---|
team.max-size |
10 | Maximum players allowed in a team (minimum 2 enforced) |
team.invite-expiry |
5 | Minutes before an invitation expires |
team.invite-cost |
0 | Economy cost to send a team invitation (Vault required) |
team.max-homes |
3 | Base maximum team homes if no level override applies |
team.rename-cost |
1000 | Economy cost to rename a team (Vault required) |
team.rename-cooldown |
60 | Minutes between team renames |
team.home-teleport-cooldown-seconds |
0 | Per-player cooldown for home and warp teleports |
team.name-format |
^[a-zA-Z0-9_]{3,16}$ |
Regex for valid team names |
team.random-colors |
true | Assign random colors to new teams |
Alliance Settings
| Setting | Default | Description |
|---|---|---|
alliances.friendly-fire |
false | If false, allies cannot damage each other where PvP protection is enabled |
alliances.max-alliances |
3 | Base maximum alliances if no level override applies |
alliances.break-cooldown-minutes |
0 | Minutes before a team can break another alliance |
Vault Settings
| Setting | Default | Description |
|---|---|---|
vault.base-size |
54 | Base vault size (multiple of 9, min 9, max 54) |
Role Defaults
| Setting | Description |
|---|---|
roles.starting-role |
Role assigned to new members when they accept an invite |
roles.defaults.<role>.display-name |
Display name shown in GUI and chat |
roles.defaults.<role>.color |
ChatColor name for the role prefix |
roles.defaults.<role>.priority |
Role priority (higher can manage lower) |
roles.defaults.<role>.can-be-kicked |
Whether members with this role can be kicked |
roles.defaults.<role>.can-be-modified |
Whether this role can be modified |
roles.defaults.<role>.daily-withdraw-limit |
Base daily vault withdrawal limit (-1 for unlimited) |
roles.defaults.<role>.permissions |
Internal permissions list, * grants all |
Team Levels
| Setting | Default | Description |
|---|---|---|
team-levels.member-thresholds |
map | Member count thresholds for each team level |
Level-Based Limits
| Setting | Default | Description |
|---|---|---|
limits.homes.by-level |
map | Max homes by team level |
limits.alliances.by-level |
map | Max alliances by team level |
limits.vault-size.by-level |
map | Vault size by team level |
limits.daily-withdrawals.team-level-multiplier |
map | Multiplier applied to role daily withdrawal limits |
World Toggles
| Setting | Default | Description |
|---|---|---|
world-toggles.team-chat-disabled-worlds |
[] | Worlds where team and ally chat are disabled |
world-toggles.homes-disabled-worlds |
[] | Worlds where homes and warps are disabled |
world-toggles.vault-disabled-worlds |
[] | Worlds where team vault is disabled |
world-toggles.pvp-protection-disabled-worlds |
[] | Worlds where allied PvP protection is disabled |
Available Team Colors
- RED
- BLUE
- GREEN
- YELLOW
- GOLD
- AQUA
- LIGHT_PURPLE
- WHITE
- DARK_RED
- DARK_BLUE
- DARK_GREEN
- DARK_AQUA
- DARK_PURPLE
- DARK_GRAY
- GRAY
Custom Roles
You can create custom roles for your team with specific permissions.
Creating a Custom Role
- Create the role:
/team role create Builder - Add permissions:
/team role perm add Builder team.home.set - Add more permissions:
/team role perm add Builder team.warp.use - Assign to a player:
/team role assign PlayerName Builder
Managing Custom Roles
- View all roles:
/team role list - View role details:
/team role info Builder - Remove a permission:
/team role perm remove Builder team.home.set - Delete a role:
/team role delete Builder
Custom Role Notes
- Custom roles have priority 40 by default
- Custom roles can be modified, default roles cannot
- When a custom role is deleted, members with that role become Members
- You can only assign roles with lower priority than your own
How Role Hierarchy Works
- Each role has a priority number
- Higher priority roles can manage lower priority roles
- You cannot kick, promote, demote, or assign roles to someone with equal or higher priority
- Leader and Co-Leader cannot be kicked from the team
- Only the Leader can transfer leadership or disband the team
Data Storage
- Team data (members, roles, homes, warps, MOTD, trust list) is saved to
data.yml - Vault contents are saved to
teamvaults.yml - Data auto-saves periodically
- Data saves when the server stops
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources