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


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, en raison de son aspect très expérimental,
si je puis me permettre l'usage de ce mot.


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 très 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 décidée dans le créateur de cartes. Les dimensions sont
les suivantes: 64x64 blocs, 128x128 blocs, 256x256 blocs et 512x512 blocs (notez
que cette dernière dimension peut exiger un PC véloce). Vous pouvez aussi choisir
le biome de l'environnement, entre île flottante, île maritime, et terrain vague.
Un peu comme dans Minecraft Classic, somme toute. Grâce à une case à cocher, vous
pouvez également choisir de créer des archipels (l'algorithme génèrera des petites
îles individuelles) et/ou des plantations.

Dans le biome "île maritime", 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. Il y a un sol marin. Mais dans le mode île flottante, il n'y a ni
sol, ni mer. 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: Lorsque le jeu est démarré, lance l'écran de pause. Sinon, revient d'un écran en arrière. Sur l'écran titre, cela fermera le jeu.
* Flèches: Bouger le personnage à gauche, à droite, devant, et derrière.
* ESPACE: Pour sauter et nager. Dans le mode fly, permet de voler vers le haut. Ne pas maintenir ESPACE tout en activant le mode fly, sinon le personnage va s'envoler sans cesse.
* MAJ: En mode fly, permet de redescendre vers le sol.
* G: Réapparaître au point de départ. Utile si vous vous paumez, ou si vous êtes coincé dans la map.
* F: Active ou désactive le mode fly (mode pour voler sur la map).
* +, -: 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.
* F2: Afficher le débugger (compteur FPS, localisation, touches clavier, etc.)
* F11: Plein écran.

Fonctionnalités expérimentales:
* N: Active le mode nuit. Tout paraîtra plus sombre. Vous pouvez le désactiver à tout moment.
* 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 décelez un bug avec le 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 + ou -. 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
* Bloc GM (similaire à ceux visibles dans Game Maker)

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


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

* La luminosité est recalculée à chaque pose/destruction de blocs ;
* Ajout du bloc nommé "Bloc GM". Il s'agit d'un bloc inspiré de Game Maker ;
* Ecran titre, avec des boutons cliquables ;
* Gestionnaire de cartes (liste, possibilité de renommer, supprimer, etc.) ;
* Nouveau format de map qui prend en charge la taille de la carte, le type de biome et une entête unique ;
* Le bloc de feuilles est désormais opaque, pour éviter des bugs d'affichage ;
* Mode fly ;
* Outil de création de cartes ;
* Correction d'autres divers bugs.

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 :
**************************************

* Correction d'autres bugs (certains sont encore à trouver !)
* Sélecteur de blocs plus précis lors de la pose
* Mode multijoueurs
* Format de map avec compression
* 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.



