Features
Team Management
- Create, disband, rename, and manage teams, invitations, members, and leadership
- Invite expiry and optional Vault economy costs for invitations and team renames
- Promote or demote members according to role priorities
- Toggle teammate PvP, change team colors, and view team information and levels
- Team chat, alliance chat, member muting, and trust status
Homes and Warps
- Set, teleport to, list, and delete named team homes and warps
/team homes and /team warps open clickable destination menus
- Team-level home limits, shared per-player teleport cooldowns, and optional warmups
- Warmups are cancelled when the player moves or takes damage
- Homes and warps can be disabled in selected worlds
Shared Team Storage
/team echest opens shared team storage with size based on team level
- Role permissions separately control access, deposits, and withdrawals
- Role withdrawal limits can scale with team level
- Storage can be disabled in selected worlds and is saved automatically
Land Claims
- Claim or release the chunk you are standing in with
/team claim and /team unclaim
- Claim limits can scale with team level and claims can be disabled by world
- Other teams cannot break or place blocks or interact with blocks in claimed chunks
- Explosions do not break blocks in claimed chunks
Alliances and Progression
- Invite, accept, decline, break, and list team alliances
- Share ally chat and optionally prevent allied friendly fire
- Team level is calculated from member-count thresholds
- Team level can affect home, alliance, vault, claim, and withdrawal limits
Diagnostics and Backups
- Routine diagnostics and save/loading details are hidden unless
debug is enabled
- Errors and plugin enable/disable notices are always logged
- Automatic backups include team data and shared storage, with configurable interval and retention
- Authorized administrators can list and restore backups
Roles, Colors, and Integrations
- Leader, Co-Leader, and Member roles have configurable permissions and priorities
- Starting role for new members is configurable; custom-role commands are unavailable
- 15 team colors; colors are available through messages and PlaceholderAPI
- PlaceholderAPI is optional and uses
%teams999_*%
- Vault is optional and is used for configured invite/rename costs
- Direct name formatting and public chat formatting are opt-in to reduce conflicts with other plugins
Commands
Team Commands
| Command |
Description |
/team |
Show team help |
/team create <name> |
Create a team |
/team disband |
Disband your team |
/team invite <player> |
Invite an online player |
/team accept |
Accept a pending invitation |
/team decline |
Decline a pending invitation |
/team cancelinvite <player> |
Cancel an invitation you sent to an online player |
/team leave |
Leave your team (the leader must transfer leadership or disband) |
/team kick <player> |
Remove a team member |
/team promote <player> / /team demote <player> |
Change a member's role by priority |
/team transfer <player> |
Transfer leadership to a team member |
/team rename <name> |
Rename your team |
/team info |
Open team information and member GUI |
/team level |
View team level and progress |
/team list |
List server teams and members |
/team online |
List online team members |
/team sethome <name> |
Set a named team home |
/team home [name] |
Teleport to a home or list homes |
/team homes |
Open the team homes menu |
/team delhome <name> |
Delete a team home |
/team setwarp <name> |
Set a named team warp |
/team warp [name] |
Teleport to a warp or list warps |
/team warps |
Open the team warps menu |
/team delwarp <name> |
Delete a team warp |
/team warplist |
List team warps |
/team chat [message] |
Toggle team chat or send one team message |
/team ally <subcommand> |
Use an alliance command under /team |
/team echest |
Open shared team storage |
/team pvp |
Toggle teammate PvP |
/team trust <player> |
Toggle a member's trusted status |
/team mute <player> |
Mute or unmute a member in team chat |
/team color <color> |
Change the team color |
/team colors |
List available colors |
/team claim / /team unclaim |
Claim or release your current chunk |
/team backup [list|restore <id>] |
List or restore backups; requires team999.reload |
/team reload |
Save data and reload configuration; requires team999.reload |
/team is also available as /t. Team creation is available by default; servers can deny it with their permission manager.
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 |
/ally chat [message] |
Toggle ally chat or send one ally message |
/ally list |
List your team's alliances |
/ally help |
Show alliance help |
/ally is also available as /a. Alliance commands are also available under /team ally.
Legacy /team motd, /team role, and /team showrole commands report that those features are unavailable.
Permissions
Team-role permissions are configured in roles.defaults.<role>.permissions. They are internal to the team system; they are not server permission nodes. The Leader has all internal permissions. Co-Leader and Member default permissions are shown in the configuration.
External server permissions use team999.* and can be granted through Bukkit-compatible permission plugins. team999.create is granted to all players by default; team999.reload defaults to operators. Each internal team.* permission has a corresponding external team999.* node. The team999.* parent grants the declared Teams999 nodes.
Configuration
Maps below are keyed by team level. World names are matched without regard to letter case. Defaults shown are the shipped defaults.
Team Settings
| Option |
Default |
Description |
team.max-size |
10 |
Maximum team members; values below 2 are raised to 2 |
team.invite-expiry |
5 |
Invitation lifetime in minutes |
team.invite-cost |
0 |
Cost per invitation; requires a Vault economy provider |
team.max-homes |
3 |
Base home limit when no level override applies |
team.rename-cost |
1000 |
Rename cost; requires a Vault economy provider |
team.rename-cooldown |
60 |
Minutes between renames; 0 disables the cooldown |
team.home-teleport-cooldown-seconds |
0 |
Per-player cooldown shared by home and warp teleports |
team.name-format |
^[a-zA-Z0-9_]{3,16}$ |
Regular expression for team names |
team.display-brackets |
false |
Deprecated; this option no longer changes formatted team names |
team.default-pvp-enabled |
false |
Initial teammate PvP setting for new teams |
team.random-colors |
false |
Give new teams a random color instead of blue |
Display, Chat, Alliance, and Vault Settings
| Option |
Default |
Description |
display.apply-team-prefixes |
false |
Directly edits player display, tab-list, and custom name-tag names |
display.show-team-name |
true |
Include the team name when direct prefix formatting is enabled |
display.team-name-brackets |
true |
Show brackets around the formatted team name |
chat.format-public-chat |
false |
Add a team prefix to public chat |
alliances.friendly-fire |
false |
Allow allied players to damage each other when enabled |
alliances.max-alliances |
3 |
Base alliance limit without a level override |
alliances.break-cooldown-minutes |
0 |
Minutes before the team can break another alliance |
vault.base-size |
54 |
Base shared storage size; valid size is 9–54 in multiples of 9 |
Role Defaults
| Option |
Default |
Description |
roles.starting-role |
member |
Default role assigned to invited members |
roles.defaults.<role>.display-name |
Per role |
Role name displayed in messages and menus |
roles.defaults.<role>.color |
Per role |
Bukkit color name for the role |
roles.defaults.<role>.priority |
Per role |
Higher priority roles can manage lower priority roles |
roles.defaults.<role>.can-be-kicked |
Per role |
Whether the role can be kicked |
roles.defaults.<role>.can-be-modified |
Per role |
Whether the role configuration can be modified |
roles.defaults.<role>.daily-withdraw-limit |
Per role |
Daily storage withdrawal limit; -1 means unlimited |
roles.defaults.<role>.permissions |
Per role |
Internal permissions; * grants every internal permission |
Team Levels and Limits
| Option |
Default |
Description |
team-levels.member-thresholds |
1: 1, 2: 4, 3: 7, 4: 10 |
Member-count requirement for each level |
limits.homes.by-level |
1: 3, 2: 4, 3: 5, 4: 6 |
Maximum homes at each level |
limits.alliances.by-level |
1: 2, 2: 3, 3: 4, 4: 5 |
Maximum alliances at each level |
limits.vault-size.by-level |
1: 27, 2: 36, 3: 45, 4: 54 |
Shared storage size at each level |
limits.daily-withdrawals.team-level-multiplier |
1: 1.0, 2: 1.25, 3: 1.5, 4: 2.0 |
Multiplier applied to the role withdrawal limit |
World Toggles, Teleports, Claims, and Backups
| Option |
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 shared storage is disabled |
world-toggles.pvp-protection-disabled-worlds |
[] |
Worlds where teammate/allied PvP protection is disabled |
debug |
false |
Show routine diagnostics and data-save/load messages |
teleport.warmup-seconds |
0 |
Home/warp delay; movement or damage cancels the teleport |
claims.enabled |
true |
Enable chunk claiming and claim protection |
claims.base-limit |
3 |
Base number of chunks each team can claim |
claims.by-level |
1: 3, 2: 5, 3: 8, 4: 12 |
Claim limit at each team level |
claims.disabled-worlds |
[] |
Worlds where claims and claim protection are inactive |
backups.enabled |
true |
Enable automatic team and shared-storage snapshots |
backups.interval-minutes |
360 |
Minutes between backups; minimum is 1 |
backups.retention |
10 |
Maximum number of newest backups to retain; minimum is 1 |
Level-map keys are team levels and values are the configured threshold, limit, size, or multiplier for that level. The shipped defaults are listed above.
Available Team Colors
RED, BLUE, GREEN, YELLOW, GOLD, AQUA, LIGHT_PURPLE, WHITE, DARK_RED, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_PURPLE, DARK_GRAY, and GRAY.
Data Storage
Team membership, role assignments, claims, homes, warps, alliances, and trust status are saved by the plugin. Shared team storage is saved separately and is included in automatic backups. Data is saved when the server stops.