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


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. Vous pouvez aussi utiliser 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 à 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 vingtaine de blocs 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.
* Z, Q, S, D: Pareil.
* 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. Appuyer une seconde fois vous fera revenir au mode fenêtré.

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.

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.

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. D'autre part, 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 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.



