Merge branch 'master' of https://github.com/bladecoder/bladecoder-adventure-engine

Author: bladecoder

README.md

@@ -1,20 +1,59 @@
 Bladecoder Adventure Engine
 ===========================
 
-Bladecoder Adventure Engine is a set of tools to create interactive graphic adventures (classical point ant click games).
+The **Bladecoder Adventure Engine** is a set of tools to create interactive graphic adventures (classical point ant click games).
 
 I think that this type of games is a great medium to tell stories and the new mobile devices provides a big opportunity to rebird and evolve them.
 
 By creating Bladecoder Adventure Engine, I want to create a platform to tell stories. Interactive stories with modern graphics, animations and music.
 
+The Bladecoder Adventure Engine is composed by the following subprojects:
+
+* **adventure-composer**: It ss the graphical editor for creating point and click games.
+* **blade-engine**: It is the engine to run the games creates with the adventure-composer.
+ 
+The **Bladecoder Adventure Engine** is developped using the [LibGDX](http://libgdx.badlogicgames.com/) framework and the projects generates a layout similar to any LibGDX project, this lowers the learning curve and ease the development and deploy in several platforms.
+
+### Adventure Composer
+The Adventure Composer is a graphical editor to create full point and click games with minimal programming.
+
+![adventure composer 2014-09-26](https://cloud.githubusercontent.com/assets/6229260/4420346/1d3a1b8a-4578-11e4-8eec-415f5e27c005.png)
+
+### Blade Engine
+The Engine has the following features:
+* Multi platform support: Android, IOS, Desktop (windows, OSX, Linux) and HTML
+* Several animation techniques: sprite/atlas animation, Spine (cutout) animation and 3d model animation
+* 3d character support
+* Multiresolution to deal with differents densities and screen sizes
+* Multilanguaje support
+
 ### The Goddess Robbery
 
-Bladecoder Adventure Engine is currently under development and it is not ready for production. The Goddess Robbery is a test game created to show the features of the Engine.
+The **Bladecoder Adventure Engine** is currently under continous development and it is almost ready for production. The Goddess Robbery is a test game created to show the features of the Engine.
+
+The source of **The Goddess Robbery** can be downloaded  [here](https://github.com/bladecoder/bladecoder-adventure-tests/tree/master/venus) and it is useful to learn how to use the **Adventure Composer**. 
 
-The Goddess Robbery is currently available for Android devices at the Google Play Store.
+The Goddess Robbery is also available for Android devices at the Google Play Store.
 
 [![The Goddess Robbery on Google Play](http://developer.android.com/images/brand/en_app_rgb_wo_60.png)](http://play.google.com/store/apps/details?id=org.bladecoder.engine)
 
+### Building and running
+In order to compile, build and run the engine, the Java platform is necessary. The project uses Gradle to build and package.
+
+Build:
+
+    $ ./gradlew build
+
+Run the Adventure Composer:
+
+    $ ./gradlew run
+
+Create a distribution package for the Adventure Composer:
+
+    $ ./gradlew distZip
+
+A zip package ready for distribution is created in the folder 'bladecoder-adventure-engine/adventure-composer/build/distributions'
+
 ### License
 Bladecoder Adventure Engine is licensed under the [Apache 2 License](http://www.apache.org/licenses/LICENSE-2.0.html), meaning you
 can use it free of charge, without strings attached in commercial and non-commercial projects.