docs: Sphinx manuel joueur/admin/dev + build HTML

Manuel complet DauphinCraft v0.1.0 : 14 pages RST (joueur, admin,
dev, annexes), conf.py rtd-theme, Makefile/make.bat, build HTML propre.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Floppyrj45
2026-04-19 17:57:47 +02:00
parent 9429360966
commit cafdb7d27e
128 changed files with 14093 additions and 0 deletions

View File

@@ -0,0 +1,86 @@
Mécaniques de jeu
=================
Jauges du joueur
----------------
Trois jauges sont visibles en permanence dans le HUD (en bas de l'écran) :
**Oxygène (jauge bleue)**
Représente l'air restant dans les poumons du dauphin. Elle diminue lorsque vous évoluez
sous l'eau sans remonter à la surface. À zéro, vous perdez de la vie rapidement.
Remontez à la surface pour la recharger instantanément.
**Vie (jauge rouge)**
Points de vie du dauphin. Diminue en cas d'attaque par un mob hostile ou de manque
d'oxygène prolongé. Se régénère lentement en nageant sans contrainte, ou plus vite
en consommant de la nourriture.
**Faim (jauge orange)**
Représente la satiété. Diminue au fil du temps et lors d'actions intenses (boost, écholocation).
Si la jauge de faim atteint zéro, la régénération de vie s'arrête.
Gestion de l'oxygène
--------------------
Votre dauphin a besoin de respirer. La surface de l'eau correspond à la limite supérieure
du monde. Remontez régulièrement pour éviter de vous noyer.
- Sous **50 % d'oxygène** : la jauge clignote doucement.
- Sous **20 % d'oxygène** : la jauge clignote rapidement et un son d'alerte retentit.
- À **0 %** : vous perdez 1 PV par seconde jusqu'à la remontée.
.. tip::
Craftez une **Bulle d'air** (voir :doc:`craft`) pour obtenir une réserve d'oxygène
supplémentaire d'urgence.
Biomes sous-marins
------------------
Le monde est généré de façon procédurale et comporte quatre biomes principaux :
**Récif corallien**
Zone peu profonde (030 m), lumineuse, riche en coraux et poissons. Idéal pour débuter.
On y trouve du **Corail Bleu** et du **Corail Rouge**.
**Forêt de kelp**
Zone intermédiaire (2060 m). Grandes algues offrant une visibilité réduite.
Source principale de **Kelp** et de **Kelp_Food**.
**Abysses**
Zone profonde (80 m et plus). Obscurité totale sans lampe bio. Ressources rares
mais mobs dangereux (Requins).
**Épaves**
Zones ponctuelles à toutes profondeurs. Recèlent de la **Roche** et de l'**Épave**
(matériaux pour recettes avancées). Attention aux Requins patrouillant les épaves.
Mobs
----
Trois types de créatures peuplent les océans de DauphinCraft :
**Bancs de poissons (FishSchool)**
Neutres. Nagent en groupe de manière aléatoire. Source de nourriture si attaqués.
Comportement de fuite à l'approche du joueur.
**Méduses (Jellyfish)**
Passives mais infligent des dégâts de contact si on les touche (1 PV par contact).
Lumineuses, elles sont utiles comme repères dans les abysses.
**Requin (Shark)**
Hostile. Attaque le joueur à vue dans un rayon de 15 unités. Inflige 3 PV par morsure.
Peut être repoussé avec une **impulsion d'écholocation** (touche E).
Mort et respawn
---------------
Quand vos points de vie atteignent zéro, vous mourez. Un écran de mort s'affiche.
- Vos blocs posés dans le monde restent en place.
- Votre inventaire est conservé.
- Vous réapparaissez au point de spawn initial (centre du monde, en surface).
En multijoueur, les autres joueurs continuent de jouer pendant votre respawn. Le délai
de respawn est de **3 secondes**.