squirrel-battle/docs/entities/items.rst

Objets
======

.. _joueur: player.html
.. _pack de textures: ../texture_pack.html

Un objet est une entité présente sur la carte que le joueur_ peut ramasser.
Il lui suffit pour cela de s'approcher, et une fois sur la case de l'objet,
celui-ci est placé dans l'inventaire.

Un objet dispose de deux paramètres :

* ``held: bool``

  Indique si l'objet est placé dans l'inventaire ou s'il est au sol.

* ``held_by: Optional[Player]``

  Si l'objet est dans l'inventaire, renvoie son propriétaire.


Il y a plusieurs types d'objets :


Bombe
-----

.. _entités attaquantes: index.html#entite-attaquante

Une bombe est un objet que l'on peut ramasser. Une fois ramassée, elle est placée
dans l'inventaire. Le joueur peut ensuite utiliser la bombe, via l'inventaire
ou après l'avoir équipée, qui fera alors 3 dégâts à toutes les
`entités attaquantes`_ situées à moins de trois cases au bout de 4 ticks de jeu.

Elle est représentée dans le `pack de textures`_ ASCII par le caractère ``o``
et dans le `pack de textures`_ écureuil par l'émoji ``💣``. Lors de l'explosion,
la bombe est remplacée par un symbole ``%`` ou l'émoji ``💥`` selon le pack de
textures utilisé.

La bombe coûte 4 Hazels auprès des marchands.


Cœur
----

Un cœur est un objet que l'on ne peut pas ramasser. Dès que le joueur s'en
approche ou qu'il l'achète auprès d'un marchand, il est régénéré automatiquement
de 3 points de vie, et le cœur disparaît.

Il est représenté dans le `pack de textures`_ ASCII par le caractère ``❤``
et dans le `pack de textures`_ écureuil par l'émoji ``💜``.

Le cœur coûte 3 Hazels auprès des marchands.


Potion d'arrachage de corps
---------------------------

Cette potion permet, une fois utilisée, d'échanger toutes ses caractéristiques
avec une autre entité aléatoire sur la carte. Cela inclut la force, la position,
l'icône, ...

Elle est représentée par les caractères ``I`` et ``🔀``

Cette potion coûte 14 Hazels auprès des marchands.


Épée
----

L'épée est un objet que l'on peut trouver uniquement par achat auprès d'un
marchand pour le coût de 20 Hazels. Une fois équipée, l'épée ajoute 3 de force
à son porteur.

Elle est représentée par les caractères ``†`` et ``🗡️``.


Bouclier
--------

Le bouclier est un objet que l'on peut trouver uniquement par achat auprès d'un
marchand pour le coût de 16 Hazels. Il s'équippe dans la main secondaire.
Une fois équipé, le bouclier ajoute 1 de
constitution à son porteur, lui permettant de parer mieux les coups.

Il est représenté par les caractères ``D`` et ``🛡️``.

Casque
------

Le casque est un objet que l'on peut trouver uniquement par achat auprès d'un
marchand pour le coût de 18 Hazels. Il s'équippe sur la tête.
Une fois équipé, le casque ajoute 2 de
constitution à son porteur, lui permettant de prendre moins de dêgats.

Il est représenté par les caractères ``0`` et ``⛑️``.

Plastron
--------

Le plastron est un objet que l'on peut trouver uniquement par achat auprès d'un
marchand pour le coût de 30 Hazels. Il s'équippe sur le corps.
Une fois équipé, le casque ajoute 4 de
constitution à son porteur, lui permettant de prendre moins de dêgats.

Il est représenté par les caractères ``(`` et ``🦺``.

Anneau
------

L'anneau est un objet que l'on peut trouver uniquement par achat auprès d'un
marchand. Il s'équippe sur la main secondaire.
Une fois équipé, l'anneau ajoute un bonus à une ou plusieurs statistiques du
joueur, améliorant sa capacité à se débarasser des monstres.

Il y a plusieurs types d'anneaux :

* **Anneau de coup critique**, qui augmente la chance de coup critique de 20%. Il coute 15 Hazels.
* **Anneau de gain d'expérience amélioré**, qui multiplie le gain d'expérience du joueur par 2. Il coûte 25 Hazels.

Un anneau est représenté par les caractères ``o`` et ``💍``.