Overview#
FTB Teams is a foundational utility mod developed by the Feed The Beast team, designed to provide a unified teaming system for Minecraft. Primarily serving as a library for other mods like FTB Chunks and FTB Quests, it allows players to group together to share progress, coordinate efforts, and manage collective permissions.
In version 1.20.1, the mod features a sophisticated graphical user interface (GUI) and a deep command-based backend. It eliminates the need for manual whitelisting between friends by allowing 'Allies' and 'Members' to interact with each other's claimed areas and quest lines automatically. The mod is essential for multiplayer environments where collaborative play or organized competition is desired.
Team Types#
FTB Teams categorizes groups into three distinct types, each serving a different purpose within the server environment:
- Player Teams: Every player is technically in their own 'Player Team' by default upon joining a world. This allows for individual settings and property management even before joining a larger group.
- Party Teams: These are created when a player invites others to join them. Party teams allow for shared questing and chunk management. They have a designated 'Owner' and can have multiple 'Officers'.
- Server Teams: Created and managed by server administrators. These teams are typically used to protect spawn areas or create community zones. Players cannot join or leave these teams unless permitted by an admin.
User Interface#
The mod is primarily interacted with through its custom GUI, which can be accessed in two ways:
- Keybind: Pressing the 'T' key (default) while in-game.
- Inventory Button: Clicking the 'My Team' icon located at the top-left of the player's inventory screen.
The Team Dashboard
From the dashboard, players can view their current team members, pending invites, and team properties. Owners can change the team's name, color, and description directly from this menu. If FTB Chunks is installed, additional permission toggles for block interaction and mob griefing will appear here.
Commands#
While the GUI is preferred for most users, the /ftbteams command offers full control over the system. Below is a list of essential commands:
| Command | Description | Permission |
|---|---|---|
/ftbteams create <name> |
Creates a new party team with the specified name. | Player |
/ftbteams join <team> |
Joins a team that is set to 'Free to Join' or one you have an invite for. | Player |
/ftbteams leave |
Leaves your current party team. | Player |
/ftbteams invite <player> |
Sends an invitation to another player. | Officer/Owner |
/ftbteams kick <player> |
Removes a player from the team. | Officer/Owner |
/ftbteams transfer_ownership <player> |
Hands over team ownership to another member. | Owner |
/ftbteams settings <key> <value> |
Manages team properties via command line. | Owner |
/ftbteams msg <text> |
Sends a message to the private team chat channel. | Member |
/ftbteams info [team] |
Displays detailed information about a specific team. | Player |
/ftbteams server create <name> |
Creates a server-managed team. | Operator |
/ftbteams force-disband <team> |
Forcibly deletes a team from the server. | Operator |
Team Properties#
Teams have several configurable properties that define how they appear and function. These can be modified in the GUI or via the /ftbteams settings command.
| Property | Type | Description |
|---|---|---|
ftbteams:display_name |
String | The name of the team as seen in chat and menus. |
ftbteams:description |
String | A short bio or description of the team's goals. |
ftbteams:color |
Hex/Color | The color associated with the team (used for chat and map icons). |
ftbteams:free_to_join |
Boolean | If true, any player can join without an invite. |
ftbteams:max_party_size |
Integer | Limits the number of players allowed in the party. |
Integration Properties (with FTB Chunks)
If FTB Chunks is present, the following properties become available to manage claimed land:
ftbchunks:allow_explosions: Toggles whether TNT and creepers damage blocks in claims.ftbchunks:allow_mob_griefing: Toggles whether mobs (like Endermen) can move blocks.ftbchunks:block_edit_mode: Defines who can break/place blocks (Members, Allies, or Everyone).ftbchunks:block_interact_mode: Defines who can use chests, doors, and machines.
Permissions and Ranks#
FTB Teams uses a hierarchy system to manage what players can do within a group:
- Owner: Has total control over the team, including the ability to disband it or transfer ownership.
- Officer: Can invite new players, kick members (of lower rank), and change most team settings.
- Member: Standard team participant. Shares quest progress and has full access to team-claimed chunks.
- Ally: A trusted player from another team. They can be granted specific permissions (like opening chests) without being a full member of the team.
- Enemy: A player or team explicitly marked as hostile. This is primarily used for PvP-oriented modpacks to restrict access or trigger specific mod behaviors.
Mechanics#
Team Chat
FTB Teams adds a dedicated chat channel for your group. You can use /ftbteams msg <message> to send a private note, or toggle your chat mode in the GUI so that all your messages go to the team by default. Team messages are prefixed with the team's name in their chosen color.
Shared Progress
When used with FTB Quests, any quest completed by a team member is completed for the entire team. Rewards can be configured to be claimed once per team or once per player, depending on the modpack's settings.
Data Storage
Team data is stored on the server in the world/data/ftbteams folder. Each team has a unique ID (UUID) and a corresponding .snbt file. Administrators can manually edit these files to fix issues, though using the in-game commands is recommended to prevent data corruption.
Configuration#
The mod's global behavior is controlled via configuration files located in the config folder of the Minecraft instance.
ftbteams-server.snbt: Contains settings for the maximum party size, whether players are allowed to create their own teams, and default permissions for new teams.ftbteams-client.snbt: Contains UI-specific settings, such as the position of the 'My Team' button in the inventory and notification preferences.
For modpack creators, default team settings can be placed in defaultconfigs/ftbteams-server.snbt to ensure every new world starts with the same team rules.
Items and Blocks#
FTB Teams is a utility and library mod; it does not add any physical blocks or items to the game world. All of its functionality is handled through the GUI and the command system. It does not add new mobs, biomes, or dimensions.
If you are looking for team-based blocks (like the 'Team Assembly Table' or 'Claiming Tools'), those are provided by companion mods such as FTB Chunks or FTB Quests, which utilize the FTB Teams API to function.
