Add documentation for entities

docs/entities/items.rst

@@ -1,2 +1,50 @@
 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.
+
+
+Deux types d'objets sont pour l'instant présents :
+
+
+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 lâcher la bombe, qui fera alors
+3 dégâts à toutes les `entités attaquantes`_ situées à moins de une case.
+
+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 ``💣``.
+
+.. note::
+
+  La gestion de l'inventaire n'ayant pas encore été implémentée, il n'est à
+  l'heure actuelle pas possible de lancer une bombe.
+
+
+Cœur
+----
+
+Une cœur est un objet que l'on ne peut pas ramasser. Dès que le joueur s'en
+approche, il est régénéré automatiquement de 3 points de vie, et le cœur disparaît.
+
+Elle est représentée dans le `pack de textures`_ ASCII par le caractère ``❤``
+et dans le `pack de textures`_ écureuil par l'émoji ``💜``.