====== 1. Les lieux ======

Pour notre première version de //Bienvenue chez MeuhCorp//, l’usine tient sur **trois lieux** : le hall d’accueil, l’atelier d’assemblage, et le banc qualité.

===== Le scénario minimum =====

Un scénario Donjon FI est un simple fichier texte. Chaque phrase se termine par un point. Pour avoir un jeu jouable, il suffit d’**un seul lieu**.

<code donjon>
Le hall est un lieu.
Sa description est "Bienvenue à MeuhCorp, leader mondial de la boîte à meuh depuis 1947. L’air sent le carton neuf et le caoutchouc tiède.".
</code>

[[djnc>wiki_tuto-usine_01_a_un_lieu|tester cet exemple]]

Lancez ce scénario : vous arrivez automatiquement dans le **premier lieu défini** (ici, le hall) et sa description s’affiche.

📚 Pour aller plus loin : [[reference:definitions:lieux|Créer des lieux]].

===== Titre, auteur et autres infos =====

Avant le démarrage de la partie, un écran d’accueil peut afficher le titre du jeu, l’auteur, une version, une licence, etc. Ces //informations du jeu// sont toutes optionnelles.

<code donjon>
Le titre du jeu est "Bienvenue chez MeuhCorp".
L’auteur du jeu est "Stagiaire du jour".
</code>

[[djnc>wiki_tuto-usine_01_b_cartouche|tester cet exemple]]

📚 Pour aller plus loin : [[reference:divers:informations_sur_le_jeu|Informations sur le jeu]] (titre, auteur, version, licence, …).

===== Plusieurs lieux reliés =====

Pour relier deux lieux, on indique leur **position relative**. Le moteur établit la connexion dans les deux sens automatiquement : pas besoin de la déclarer deux fois.

<code donjon>
Le hall est un lieu.
L’atelier est un lieu à l’est du hall.
Le banc qualité est un lieu au nord de l’atelier.
</code>

[[djnc>wiki_tuto-usine_01_c_trois_lieux|tester cet exemple]]

Une fois en jeu, vous pouvez essayer :

<code>
> est
> nord
> sud
> ouest
</code>

Les directions disponibles : ''nord'', ''sud'', ''est'', ''ouest'', les diagonales (''nord-est'', ''sud-ouest'', …), ainsi que ''monter'' / ''descendre'' et ''entrer'' / ''sortir''.

Chacune a aussi une **forme abrégée** d’une à trois lettres — pratique pour les joueurs pressés :

^ Direction      ^ Abrégés                ^
| nord           | ''n''                  |
| sud            | ''s''                  |
| est            | ''e''                  |
| ouest          | ''o''                  |
| nord-est       | ''n-e'', ''ne''        |
| sud-est        | ''s-e''                |
| sud-ouest      | ''s-o''                |
| nord-ouest     | ''n-o'', ''no''        |
| monter         | ''mo''                 |
| descendre      | ''de''                 |
| entrer         | ''en''                 |
| sortir         | ''so''                 |

<WRAP tip>
Quand un lieu n’a qu’**une seule sortie**, le joueur peut taper simplement ''sortir'' (ou ''so'') sans préciser la direction : le moteur prend la seule sortie disponible.
</WRAP>

==== Afficher les lieux pas encore visités ====

Par défaut, les lieux adjacents que le joueur n’a pas encore visités s’affichent sous forme de ''?''. Si vous préférez révéler leur nom dès le départ — par exemple parce que les ''?'' cassent l’ambiance —, ajoutez :

<code donjon>
Activer l’affichage des lieux inconnus.
</code>

📚 Pour aller plus loin : [[reference:definitions:lieux|Créer des lieux]] (toutes les directions, les positions multiples) et [[reference:divers:configurations:sorties|Configuration des sorties]] (masquer les sorties, masquer les directions, …).

===== Démarrer ailleurs que dans le premier lieu =====

Par défaut, le joueur arrive dans le **premier lieu déclaré** — ici, le hall. C’est l’option naturelle pour la plupart des scénarios. Mais on peut aussi décider explicitement de le placer ailleurs :

<code donjon>
Le hall est un lieu.
L’atelier est un lieu à l’est du hall.
Le banc qualité est un lieu au nord de l’atelier.

Le joueur se trouve dans le banc qualité.
</code>

[[djnc>wiki_tuto-usine_01_e_position_joueur|tester cet exemple]]

Au démarrage, vous arrivez directement au banc qualité — pratique pour ouvrir le jeu sur l’endroit dramatique de l’histoire plutôt que sur l’entrée. Cette phrase peut apparaître n’importe où dans le scénario : le moteur la lit au démarrage et place le joueur.

===== Donner de l’ambiance =====

Sans description, le moteur affiche un texte minimal (« Vous êtes dans l’atelier. »). Ajoutons une description à chaque lieu pour planter le décor — et un soupçon d’humour MeuhCorp au passage.

<code donjon>
Le hall est un lieu.
Sa description est "Bienvenue à MeuhCorp, leader mondial de la boîte à meuh depuis 1947. L’air sent le carton neuf et le caoutchouc tiède.".

L’atelier est un lieu à l’est du hall.
Sa description est "L’atelier d’assemblage. Tout sent la sciure, le métal froid et l’huile de meuh.".

Le banc qualité est un lieu au nord de l’atelier.
Sa description est "Le banc qualité, sanctuaire absolu de MeuhCorp. C’est ici que chaque boîte est testée. Un meuh franc par retournement, et surtout pas le moindre coin-coin.".
</code>

[[djnc>wiki_tuto-usine_01_d_descriptions|tester cet exemple]]

📚 Pour aller plus loin : [[reference:definitions:description_et_apercu|Description et aperçu]].

===== Récapitulatif =====

  * Un lieu se déclare en une ligne : ''Le X est un lieu.''
  * On lui attache une description avec ''Sa description est "..."''.
  * Pour relier deux lieux : ''Le X est un lieu à l’est du Y.'' La connexion est bidirectionnelle.
  * Les directions ont une forme longue (''nord'', ''sud-ouest'', ''sortir'', …) et une forme abrégée (''n'', ''s-o'', ''so'', …).
  * Le titre et l’auteur du jeu se déclarent avec ''Le titre du jeu est "..."'' et ''L’auteur du jeu est "..."''.

Au prochain chapitre, on peuple les lieux d’**objets manipulables**.

Suite : [[tutoriels:meuhcorp:partie2_objets|2. Les objets]]