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

1. Create the role: /team role create Builder
2. Add permissions: /team role perm add Builder team.home.set
3. Add more permissions: /team role perm add Builder team.warp.use
4. 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