*********************************************************************
* Bienvenue dans le fichier "Lisezmoi.txt" du projet Artisamine 3D. *
*********************************************************************


Qu'est-ce que le projet Artisamine 3D ?
***************************************

Artisamine 3D est un jeu vidéo à la première personne codé en C# (avec la
librairie Monogame, la suite non-officielle du projet XNA de Microsoft).


Quand a démarré le projet, et qu'est-ce qui l'a motivé ?
********************************************************

Le projet a débuté en janvier 2026. Il a été créé dans le but d'expérimenter
la programmation d'environnements en 3 dimensions. En effet, j'avais débuté
sur XNA en 2012, mais je n'avais pas obtenu de résultats très convaincants.
Malgré tout, cette année, j'ai décidé de reprendre ça depuis zéro avec l'aide
de ChatGPT. J'aime beaucoup le jeu Minecraft, et j'ai voulu faire un jeu
similaire. Même s'il n'est pas très avancé, c'est chose faite.

Existait-il une version en 2D ?
*******************************

Absolument, elle était faite en Visual Basic .NET 2010. Mais je l'ai faite
il y a une quinzaine d'années, elle était assez travaillée, mais je ne
l'évoquerai pas davantage ici.


Quelles sont les fonctionnalités du jeu Artisamine 3D?
******************************************************

Il s'agit d'un jeu en 3D de type sandbox. Vous pouvez poser des cubes où
vous voulez, dans les limites de la map. Artisamine 3D est inspiré de
Minecraft dans son époque "classique", où l'environnement était clairement
limité, et où les blocs étaient peu nombreux. Bref, c'est un jeu de cubes
très sobre, assez rudimentaire, mais également assez jouable.


Comment l'utiliser, du coup ?
*****************************

Pour déplacer le personnage en vue subjective, vous devez utiliser les touches
fléchées du clavier. Je n'ai pas implémenté Q, Z, S, D, car ces touches sont
complètement dans un autre ordre sur les claviers américains (A, W, S, D) et
je suis gaucher. Vivent les gauchers.

Une fois que vous ouvrez le jeu, vous pouvez explorer tous le recoins de la
carte, dont la limite est fixée à 192 blocs de long sur 192 blocs de large,
et 64 blocs de profondeur. Un peu comme Minecraft Classic, en somme. Mais en
moins stable, moins gai, et moins étoffé.

Une mer entoure la map, vous pouvez nager dedans, mais au-delà d'un certain seuil,
ce n'est plus la map, mais un endroit où nager, jusqu'à un certain point où les
mouvements du joueur sont contenus. Si vous tombez trop loin sous la map, le
personnage sera téléporté au point de spawn.

Les actions de la souris:
* Clic gauche: Casser un bloc.
* Clic droit: Poser un bloc (celui qui sera posé est affiché dans le coin supérieur droit de l'écran)
* Scroll de la souris: Changer de bloc parmi une dizaine disponibles.
* Mouvements de la souris: Bouger le point de vue du personnage.

Les actions du clavier:
* ESCAPE: Libérer la souris, ou la capturer. En mode plein écran, ferme le jeu instantanément (comme dans FNAF).
* Flèches: Bouger le personnage à gauche, à droite, devant, et derrière.
* ESPACE: Pour sauter et nager.
* G: Réapparaître au point de départ. Utile si vous vous paumez, ou si vous êtes coincé dans la map.
* H, J: Sélectionner un bloc différent. Utile si vous n'avez pas de roulette sur votre souris, ni de raccourcis, comme sur certains PC portables.
* R: Régénérer la map. Attention, aucun préavis non plus.
* C: Afficher le débugger (compteur FPS, localisation, touches clavier, etc.)
* O: Ouvrir la carte précédemment sauvegardée.
* P: Sauvegarder la carte actuellement ouverte. Aucun message de confirmation, cette touche écrasera l'éventuelle ancienne sauvegarde.

Fonctionnalités expérimentales:
* N: Active le mode nuit. Tout paraîtra plus sombre. Vous pouvez le désactiver à tout moment.
* B: Retire toute l'eau de la map. En gros, elle deviendra une île flottante.
* F11: Plein écran. Je le mets en fonction expérimentale, car j'ai beau appuyer à nouveau, impossible de revenir en mode fenêtré.
* Touches numériques 1, 2, 4, 5, 7, et 8: Permettent de régler la couleur de la mer lointaine. C'est purement décoratif, et je m'en suis servi pour adapter la couleur.


Quels blocs sont disponibles ?
******************************

Pour changer le bloc à poser, il suffit d'actionner la roulette de la souris, ou
d'appuyer sur les touches H ou J. Le bloc sélectionné est affiché en haut à droite
de l'écran, sous la forme d'un pictogramme isométrique, précédé d'un intitulé.
Les blocs implémentés sont les suivants:

* Pelouse
* Terre
* Roche
* Roc terreux (transitionne entre la terre et la roche, ce bloc n'existe pas dans Minecraft)
* Sable
* Tronc
* Feuillage
* Eau (se répand très rapidement!)
* Bosquet fleuri (feuillage mais avec des fleurs, très décoratif)
* Parterre fleuri (généré de façon aléatoire sur la map)
* Planches de bois
* Verre

Il y a deux blocs qui ne sont pas accessibles à l'utilisateur :
* Air (là où aucun bloc n'est, et quand on détruit un bloc, on "pose" un bloc d'air, en fin de compte)
* Adminium (alias Obsidienne dans les versions post-Classic de Minecraft, ce bloc permet de délimiter la zone constructible, et on ne peut pas le détruire).

Nota: En raison de problèmes d'ordre de profondeur, les blocs de feuille ou de
verre peuvent apparaître mystérieusement à travers les arbres. Ce n'est qu'un
petit artefact, et c'est totalement de ma faute. Le sable n'est pas encore
soumis à la gravité.


Disclaimer:
***********

Il s'agit d'un projet freeware. C'est la première fois que je code un jeu vidéo
en 3D de façon sérieuse. Ainsi, aucune garantie n'est livrée avec ce produit.
En cas de dommage logiciel ou matériel, l'auteur ne sera pas tenu pour responsable.
Le produit ne peut être vendu.

Copyright (c) 2026 Monokeros, tous droits réservés.



