Updates README

README.md

@@ -1 +1,97 @@
-# Project-Liliments
+# Project Liliments
+
+## What is project Liliments
+
+Project Liliments (little elements) is a spiritual successor of Sonic Adventure "Chaos Garden". The liliments are little creatures that the user will nurture, see evolve and play with.
+
+An additional difficulty of the project is to be cross-save between mobile , PC/console and VR space. Enabling players to take care of their critter on one platform then move to another.
+
+## Description
+
+### What are Liliments
+
+Liliments are little creatures that can't take care of themselves.
+
+They live in a garden.
+
+They have an archetype which decide what their main form is.
+
+They have a color scheme with a main and secondary color.
+
+They have an element which can be controlled by the player.
+
+They have a combination of two forms that is also controlled by the player. 
+
+The forms are set by the statistics of the liliment which contains the following (others can be added during development) : speed strength fly power stamina
+
+An example : a goblin teal/brown icy speed/power type would:
+
+Look like a goblin
+
+Have a mainly a teal body with some brown parts
+
+Resonate with an ice element, either by being made of ice or invoking freezing breezes
+
+Would have a lean physic or have ice-skates (speed) with some visible muscles or ice pads (power)
+
+These creatures will also have :
+
+- A personality type
+
+- Preferred hobby / behaviors
+
+- Attachments to the player
+
+- Stats Gene pool
+
+- Luck
+
+- Care markers (indication of good/bad care)
+
+### Main gameplay
+
+The main gameplay of the game will be a tamagochi-like game. The player will have to hatch some liliment and take care of them. To take care of them the player must : 
+
+- Feed them
+
+- Give them Inscence
+
+- Pet them
+
+- Play with them
+
+### Getting resources
+
+To get the resources to take care of the liliments, the player must do some minigames. Some minigame will test the player rewarding him with incense that reflects the skill needed for the minigame, theses minigames are platform dependent . Some minigames will test the liliments, giving them some personal growth or global items, theses minigames will be adapted to platforms but will be similar. A shop will also be accessible to buy new liliments / gears/ food / etc.
+
+## Technical features
+
+### The project
+
+This project is to be created in subsequent iterations : a mobile 2d version a PC/console 3d version a VR experience
+
+The savegame must be cross-compatible between all versions and a same "garden" could be visited by multiple players with a different representation.
+
+### The Architecture (Draft)
+
+Clients will connect to an API to access their garden.
+
+The API will communicate the state of the garden and all the information about the liliments.
+
+Once a player login, a service instance is allocated to the user loading his garden in real time (and time-skipping some stats to current time).
+
+The API will update the states of the liliments and update the game client about events happening in the garden instance.
+
+Once the user logs out, the instance validate possible events to send to the player, notify the API and close.
+
+
+### Definition of the Minimum Viable Project
+
+The minimally viable project would be a web interface containing the statistic of a garden.
+
+This would let : 
+
+- Select a liliment
+- Customize the liliment stats using a made-up shop containing incense
+- Customize the liliment using activity (pet -> simple prompt)
+- See all stats ( even the ones normally not shown )