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 home lists 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 warp lists 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 color to change color and /team colors to 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
/team can also be used as /t/ally can 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
暂无评论，抢个沙发吧~