*********************************************************************
* 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).

Il nécessite impérativement .NET 9.0 pour fonctionner.

La version actuelle est l'Alpha 0.0.8.


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 si le mien 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. Vous pouvez utiliser aussi les touches Z, Q, S, D.

Une fois que vous ouvrez le jeu, vous pouvez explorer tous le recoins de la
carte, dont la limite est fixée à 128 blocs de long sur 128 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, et les mouvements du joueur sont contenus. Dans cette version,
il y a un sol marin. Mais 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, revient au mode fenêtré.
* 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.
* J, K: 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.
* F11: Plein écran.

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.
* X: Active le mode rayon X (ou "XRay mode" en anglais). Permet de voir les galeries à travers le sol.
* L: Force le recalcul de la lumière. Peut être utile si vous ouvrez une map sauvegardée, ou si vous galérez avec le nouveau système d'éclairage.


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

Pour changer le bloc à poser, il suffit d'actionner la roulette de la souris, ou
d'appuyer sur les touches J ou K. 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
* Fleur violette
* Fleur rouge
* Fleur bleue
* Blocs rouge, orange, jaune, vert, cyan, bleu, violet, et blanc.
* Blocs d'or et d'argent
* Lanterne
* Balise rouge
* Grillage

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 Bedrock 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. D'autre part, le sable n'est
pas encore soumis à la gravité.


Nouveautés par rapport à l'Alpha 0.0.7 :
******************************************

* Intégration d'un système d'éclairage linéaire sur 16 valeurs (0 à 15).
* Ajout des blocs en or, en argent.
* Ajout du bloc lanterne, balise rouge, et grillage.
* Correction de gros bugs qui pouvaient faire planter le jeu aux limites de la map
* Correction de bugs liés à la fonction "B" pour vider l'eau de la map
* Ajout d'un fond marin sur la map. Il tapisse le fond de la mer, la map ne donne plus sur un ciel infini (moi j'aimais bien mais bon)
* Passage au format de carte 128x128x64 au lieu de 192x192x64.
* Mise à jour du mode nuit, il règle la luminosité sur 7 et permet de voir les lanternes en action.
* Il y a des chances que chaque début de tunnel tracé par l'ordinateur soit orné de deux balises rouges.
* Les maps générées ne sont plus en forme de cube, mais affichent un terrain irrégulier avec des arrondis.
* Génération de plages submergées.
* Les blocs cassés lâchent des particules aux couleurs de leur couleur dominante.


Prévisions pour les futures versions :
**************************************

* Choix de la taille de la map
* Choix du type de la map (île flottante, île maritime, terrain vague, cuve, etc.)
* Interface plus conviviale, écran titre
* Correction d'autres bugs (certains sont encore à trouver !)
* Sélecteur de blocs plus précis lors de la pose
* Multijoueurs
* Fly mode
* Etc.


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 impliquée. Ainsi, comprenez que ce n'est pas aussi abouti et stable
que Minecraft. 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 peut
être redistribué, mais ne peut être vendu.

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



