Merge pull request #26 from kristoferssolo/readme

README.md

@@ -1,12 +1,41 @@
 # Maze Ascension: The Labyrinth of Echoes
 
-"Maze Ascension: The Labyrinth of Echoes" is a minimalist maze exploration
-game built using the Bevy engine. The game features simple visuals with
-hexagonal tiles forming the maze structure on a white background with black
-borders, and a stickman-style player character. Players navigate through
-multiple levels of increasing difficulty, progressing vertically as they
-climb up through levels. The game includes power-ups and abilities hidden
-throughout the maze, and later introduces the ability to move between levels
-freely. This unique blend of puzzle-solving, exploration, and vertical
-progression offers a fresh twist on traditional maze gameplay, presented in
-an accessible and clean visual style.
+A procedurally generated 3D maze game built with Rust and Bevy game engine.
+Navigate through hexagonal maze levels that become progressively more
+challenging as you ascend.
+[Play on itch.io](https://kristoferssolo.itch.io/maze-ascension)
+
+## Features
+
+- Procedurally generated hexagonal mazes
+- Multiple floor levels with increasing difficulty
+- Smooth floor transitions and animations
+- Power-up system (WIP)
+- Custom hexagonal grid library implementation
+
+## Installation
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/kristoferssolo/maze-ascension.git
+cd maze-ascension
+```
+
+2. Build and run:
+
+```bash
+just native-release
+# or
+cargo run --release --no-default-features
+```
+
+## License
+
+This project is licensed under the GPLv3 License - see the [LICENSE](./LICENSE) file for details.
+
+## Acknowledgments
+
+- [Bevy Game Engine](https://bevyengine.org/)
+- [Red Blob Games' Hexagonal Grids](https://www.redblobgames.com/grids/hexagons/) article for hexagonal grid mathematics
+- [hexx](https://github.com/ManevilleF/hexx) for hexagonal grid inspiration

README.norg

@@ -1,11 +0,0 @@
-* Maze Ascension: The Labyrinth of Echoes
-  "Maze Ascension: The Labyrinth of Echoes" is a minimalist maze exploration
-  game built using the Bevy engine. The game features simple visuals with
-  hexagonal tiles forming the maze structure on a white background with black
-  borders, and a stickman-style player character. Players navigate through
-  multiple levels of increasing difficulty, progressing vertically as they
-  climb up through levels. The game includes power-ups and abilities hidden
-  throughout the maze, and later introduces the ability to move between levels
-  freely. This unique blend of puzzle-solving, exploration, and vertical
-  progression offers a fresh twist on traditional maze gameplay, presented in
-  an accessible and clean visual style.