> For the complete documentation index, see [llms.txt](https://docs.settlers-united.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.settlers-united.com/s4-lua-api-de/su-library-functions/su.game/su.game.getplayersofteam.md).

# SU.Game.GetPlayersOfTeam

## SU.Game.GetPlayersOfTeam(playerIDs, teamID)

Gibt die Anzahl an Teams zurück.

**Achtung: funktioniert NICHT in "new\_game"!**\
⇒ stattdessen **"**Events.FIRST\_TICK\_OF\_NEW\_GAME" o.ä. (siehe [Broken mention](broken://spaces/auUjVOZHHg4G6b8lVuXs/pages/qLOzOsgkiRbVIll0itCg))

#### Parameter

* `playerIDs`: **Ziel-Tabelle**: Eine vor dem Funktionsaufruf erstellte Tabelle (z. B. `local playerIDs = {}`, siehe Beispiel unten), die dann von dieser Funktion mit den gefundenen IDs befüllt wird. **Achtung**: Bereits enthaltene Daten in dieser Tabelle werden dabei überschrieben!
* `teamID`: ID des Teams

#### Rückgabewert

* `number` (Anzahl): Anzahl der Spieler im angegebenen Team
* **Hinweis***:* Die eigentlichen Entity-IDs werden nicht als Rückgabewert geliefert, sondern direkt in die als ersten Parameter übergebene Ziel-Tabelle geschrieben.

#### Beispiel

```lua
local playerIDs = {}
local numPlayers = SU.Game.GetPlayersOfTeam(playerIDs, 2)    -- liefert Spieler-IDs vom Team 2
```