> ## Documentation Index
> Fetch the complete documentation index at: https://luau.limerence.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> api.players: the same kind of info as api.client, but for everyone else.

The same kind of info as [api.client](/client/overview), but for every **other** player in the match, teammates and enemies alike. You're not in this list; use `api.client` for yourself.

Use `get(player)` to grab a handle for one player, then call methods on it like `:getHealth()` or `:isReloading()`. Or use the signals to react when anyone's state changes. A handle has the shared methods plus whatever extras the current game adds, so guard the game-specific ones with `if handle.x then`. See [Game support](/game-support).

`api.players` is there in Bloxstrike, Rivals, Apocalypse Rising 2, and [universal mode](/universal/overview).

## Looking up players

| Call          | Returns         | What it does                                                                                              |
| ------------- | --------------- | --------------------------------------------------------------------------------------------------------- |
| `getAll()`    | `{ Player }`    | A list of every other player currently in the match.                                                      |
| `get(player)` | `PlayerHandle?` | A handle you can read state from. `nil` if you pass yourself; use [api.client](/client/overview) instead. |

## Example

```luau theme={null}
for _, player in api.players.getAll() do
    local handle = api.players.get(player)
    if handle and handle:isAlive() then
        print(player.Name, handle:getHealth(), handle:getItemName())
    end
end
```

<CardGroup cols={2}>
  <Card title="Shared" icon="globe" href="/players/shared">
    Handle methods and signals that work in every game.
  </Card>

  <Card title="Bloxstrike" icon="bomb" href="/players/bloxstrike">
    Plant/defuse, armor, hostages, money, backtrack.
  </Card>

  <Card title="Rivals" icon="swords" href="/players/rivals">
    Duel, movement, level, ELO.
  </Card>

  <Card title="Apocalypse Rising 2" icon="radiation" href="/players/apocalypse-rising-2">
    Ammo, velocity, healing.
  </Card>

  <Card title="Types" icon="brackets-curly" href="/reference/types#players-types">
    PlayerHandle.
  </Card>
</CardGroup>