Teams999

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