> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dotouch-emu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getFighter

> Récupère les données en combat du compagnon. Disponible uniquement pendant un combat.

Récupère les données en combat du compagnon. Disponible uniquement pendant un combat.

#### 🎮 Méthode

```lua theme={null}
companion:getFighter()
```

#### 💎 Valeur de retour

| Type          | Description                                                                |
| ------------- | -------------------------------------------------------------------------- |
| `object\|nil` | Objet de données du combattant, ou `nil` si hors combat ou sans compagnon. |

L'objet retourné possède les champs suivants :

| Champ           | Type     | Description                                     |
| --------------- | -------- | ----------------------------------------------- |
| `id`            | `int`    | Identifiant d'instance du combattant.           |
| `companionId`   | `int`    | Identifiant de définition du compagnon.         |
| `name`          | `string` | Nom du compagnon.                               |
| `level`         | `int`    | Niveau du compagnon.                            |
| `cellId`        | `int`    | Position de la cellule actuelle dans le combat. |
| `lifePoints`    | `int`    | Points de vie actuels.                          |
| `maxLifePoints` | `int`    | Points de vie maximum.                          |

#### 💡 Exemple

```lua theme={null}
local fighter = companion:getFighter()
if fighter then
  global:printMessage(fighter.name .. " PV : " .. fighter.lifePoints .. "/" .. fighter.maxLifePoints)
end
```