View source for Team command

The '''TEAM''' command creates and manages persistent player teams in classic Galactic Empire and standard ge-next. For team scoring, shared planet access, persistence, and version-specific implementation changes, see [[Teams]]. The command is disabled in ge-arena.

== Commands ==

{| class="wikitable"
! Command
! Action
|-
| <code>TEAM START number founder-secret password name</code>
| Create a team and join it.
|-
| <code>TEAM JOIN number password</code>
| Join an existing team.
|-
| <code>TEAM UNJOIN</code>
| Leave the current team.
|-
| <code>TEAM SCORE</code>
| Display team standings.
|-
| <code>TEAM MEMBERS</code>
| List members of your current team.
|-
| <code>TEAM KICK founder-secret user</code>
| Remove a member.
|-
| <code>TEAM NEWPASS founder-secret password</code>
| Change the joining password.
|-
| <code>TEAM NEWNAME founder-secret name</code>
| Rename the team.
|}

As with other GE commands, most subcommands can be abbreviated to their first three letters. The full forms above are easier to recognize.

== Creating and joining ==

For example:

<syntaxhighlight lang="text">
TEAM START 12345 founderkey memberpass Example Team
TEAM JOIN 12345 memberpass
</syntaxhighlight>

The team number must be five digits and represent a nonzero code. The founder secret authorizes <code>KICK</code>, <code>NEWPASS</code>, and <code>NEWNAME</code>; the separate member password is used with <code>JOIN</code>. Each credential can have up to ten characters, and the team name can have up to 30. Starting a team automatically joins its creator.

The founder secret is not tied to the founder's account: any member who knows it can perform founder operations. Treat both credentials as game passwords, not as substitutes for BBS or other account passwords.

ge-next 0.3 additionally requires a team name of at least five characters beginning with a letter. It does not allow a player to join or start another team while still on a valid team; use <code>TEAM UNJOIN</code> first. Classic does not consistently enforce these restrictions.

The game supports up to 50 team records. The sysop's <code>TEAMMAX</code> option limits membership in one team; its default is ten. See [[Teams]] for how ge-next handles empty teams and retired team numbers.

== Leaving and founder actions ==

<code>TEAM UNJOIN</code> removes your membership. A member who knows the founder secret can kick another member, change the joining password, or rename the team. For example:

<syntaxhighlight lang="text">
TEAM KICK founderkey OtherPlayer
TEAM NEWPASS founderkey newpass
TEAM NEWNAME founderkey New Team Name
</syntaxhighlight>

<code>TEAM KICK</code> can target an offline player and sends an in-game mail notice to the removed member; see [[Classic bug: TEAM KICK mail classification]] for a classic mailbox-class error corrected in ge-next 0.3.3. ge-next applies the same name rules to <code>TEAM NEWNAME</code> as to <code>TEAM START</code> and rejects a name already used by another active team.

== Viewing teams ==

<code>TEAM MEMBERS</code> lists the members of your current team. <code>TEAM SCORE</code> lists active teams in score order. The standings use member planet and kill scores plus a per-member bonus; the formula and the differences between classic and ge-next are explained in [[Teams#Team scoring|Team scoring]].

== Undocumented classic command ==

Classic GE also accepts <code>TEAM DUMPITOUT</code>, although it is not listed in the command help. It prints the internal team table, including each team's joining password and founder secret, to the player who enters it. Because those credentials should not be public, ge-next 0.3 removed this subcommand from <code>TEAM</code> and made the diagnostic dump available only through the privileged [[Sys command|<code>SYS TEAMDUMP</code>]] command.

== ge-arena ==

ge-arena does not use the persistent team database, so <code>TEAM</code> is disabled. Planned arena team modes will assign match-specific teams in memory rather than use this command.

== See also ==

* [[MBMGEHLP.MSG#HELP_TEAM|Classic HELP TEAM]]
* [[Teams]]
* [[Send command]]
* [[Report command]]
* [[Classic bug: Team state inconsistency]]
* [[Classic bug: Reused deleted team identifiers]]
* [[Classic bug: Unterminated team-creation fields]]

{{GE navigation}}
[[Category:Commands]]