Teams999

Features

Team Management

• Create and disband teams
• Invite players to your team
• Kick players from your team
• Leave your current team
• View team information
• List all teams on the server
• See online team members
• Rename your team (with optional cost and cooldown)
• Set a team message of the day (MOTD)
• Transfer team leadership to another member

Team Colors

• Each team has its own display color
• 15 available colors: RED, BLUE, GREEN, YELLOW, GOLD, AQUA, LIGHT_PURPLE, WHITE, DARK_RED, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_PURPLE, DARK_GRAY, GRAY
• Teams can start with a random color or default green
• Team color shows in chat, player list, and name tags

Role System

• 5 default roles with different permission levels
• Role hierarchy prevents lower roles from managing higher roles
• Custom role creation for your team
• Assign roles to team members
• Add or remove permissions from custom roles
• Role prefixes can be displayed in chat

Default Roles

Leader (Priority 100)

• Team owner, one per team
• Has all permissions
• Cannot be kicked
• Can transfer leadership
• Can disband the team

Co-Leader (Priority 90)

• Second in command
• Cannot be kicked
• Can invite, kick, promote, demote members
• Can manage roles, MOTD, homes, alliances
• Full vault access
• Cannot disband or transfer leadership

Officer (Priority 70)

• Moderation role
• Can invite members
• Can kick lower ranked members
• Can set and delete homes
• Can mute players in team chat
• Vault access with daily withdrawal limit

Member (Priority 50)

• Standard team member
• Can use team chat and ally chat
• Can deposit to vault (cannot withdraw)
• Can use team homes
• Can view team info

Recruit (Priority 10)

• Trial role for new members
• Can use team chat
• Can view team info
• No vault access
• No home access

Team Homes

• Set multiple named home locations
• Teleport to any team home
• Delete homes you no longer need
• Configurable maximum number of homes

Team Vault

• Shared storage for your team
• 54 slots of storage space
• Permission-based access (open, deposit, withdraw)
• Auto-saves regularly

Team Chat

• Toggle between public and team-only chat
• Only team members see your messages
• Mute members who abuse chat
• Role prefixes shown in team chat

Alliance System

• Form alliances with other teams
• Alliance chat to communicate with allies
• Friendly fire protection between allies
• Break alliances when needed
• Configurable maximum number of alliances

Trust System

• Grant trust privileges to specific members
• Trusted members can set and delete homes
• Toggle trust on and off

---

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 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
/team delhome <name>	Delete a team home
/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 trust for a player
/team mute <player>	Mute or unmute a player in team chat
/team showrole	Toggle role prefix display in chat
/team color <color>	Change your team's display color

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

Other

Permission	Description
team.info.view	View team information
team.trust	Grant trust privileges to members

---

Role Permission Matrix

Permission	Leader	Co-Leader	Officer	Member	Recruit
team.invite	✓	✓	✓	✗	✗
team.kick	✓	✓	✓	✗	✗
team.promote	✓	✓	✗	✗	✗
team.demote	✓	✓	✗	✗	✗
team.role.assign	✓	✓	✗	✗	✗
team.role.create	✓	✓	✗	✗	✗
team.role.delete	✓	✓	✗	✗	✗
team.motd.set	✓	✓	✗	✗	✗
team.name.change	✓	✗	✗	✗	✗
team.color.change	✓	✗	✗	✗	✗
team.disband	✓	✗	✗	✗	✗
team.transfer	✓	✗	✗	✗	✗
team.vault.open	✓	✓	✓	✓	✗
team.vault.deposit	✓	✓	✓	✓	✗
team.vault.withdraw	✓	✓	✓	✗	✗
team.chat.toggle	✓	✓	✓	✓	✗
team.chat.team	✓	✓	✓	✓	✓
team.chat.ally	✓	✓	✓	✓	✗
team.chat.moderate	✓	✓	✓	✗	✗
team.ally.invite	✓	✓	✗	✗	✗
team.ally.accept	✓	✓	✗	✗	✗
team.ally.break	✓	✓	✗	✗	✗
team.home.set	✓	✓	✓	✗	✗
team.home.delete	✓	✓	✓	✗	✗
team.home.use	✓	✓	✓	✓	✗
team.info.view	✓	✓	✓	✓	✓
team.trust	✓	✓	✗	✗	✗

---

Configuration

Team Settings

Setting	Default	Description
team.max-size	10	Maximum players allowed in a team
team.invite-expiry	5	Minutes before an invitation expires
team.max-homes	3	Maximum team home locations
team.rename-cost	1000	Cost to rename (requires Vault)
team.rename-cooldown	60	Minutes between renames
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	Whether allies can damage each other
alliances.max-alliances	3	Maximum alliances per team

---

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.home.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 is saved to data.yml
• Vault contents are saved to teamvaults.yml
• Data auto-saves periodically
• Data saves when the server stops

---