|
|
@@ -1,212 +1,59 @@
|
|
|
-# Planet Survival Game - Proof of Concept Point and Click, Turn Based Strategy Game.
|
|
|
+<u>Supported o3de versions</u> : **23.10**
|
|
|
|
|
|
-# By Starr Shaw
|
|
|
-
|
|
|
-Project Or Game Description:
|
|
|
-
|
|
|
-Planet Survival Game is a Proof of concept Point and Click Turn Based Strategy Game. We start by landing on planet environment tile, with limited fuel, our first mission is to recharge are ship with locating a natural power on the planet in the form of Power Crystals. The Local residence of this area might not like this and attempt to stop this energy collection grab. We must explore the planet and find resources. The Planet is made of of procedural crafted squares with a variety of enemy encounters, puzzles, and task to perform. If you run out of power completely, or attack and loose an enemy fight, the game ends.
|
|
|
-
|
|
|
-https://user-images.githubusercontent.com/87207603/201387109-4a65bdb9-7f70-43f3-8ab0-f47d8416ba1f.mp4
|
|
|
-
|
|
|
-## The Project Includes
|
|
|
+# Planet Survival Game: Point and Click, Turn Based Strategy Game (By Starr Shaw)
|
|
|
|
|
|
|
|
|
|
|
|
-- **Planet environment**, includes Many Size Rocks, Plants, Lava Spouts and Main Playing Island Grid.
|
|
|
-- **Alien Explorer**, a ready to use character model, with multiple character animations such as, walk and attack. Is modular with Many Skin Attachments.
|
|
|
-- **AI Player**, The Buggy AI Character will use the Nav Mesh to seek and move toward your Player character.
|
|
|
-- **Script Canvas Visual Scripts,** editable Script Canvas visual scripts for main and in game menu interaction, gameplay and player movement.
|
|
|
-
|
|
|
-
|
|
|
-- Main Player
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-- In-Game Screen Shot 1
|
|
|
-
|
|
|
-- In-Game Screen Shot 2
|
|
|
-
|
|
|
-- In-Game Screen Shot 3
|
|
|
-
|
|
|
-
|
|
|
+This game is a proof of concept for a 3D Point and Click, Turn Based Strategy Game.
|
|
|
|
|
|
-https://user-images.githubusercontent.com/87207603/201387317-6cfdab7f-df73-40d4-98ed-80b477a3d8bb.mp4
|
|
|
-
|
|
|
-
|
|
|
-## Build Levels Dynamically
|
|
|
-Build dynamic levels with O3DE Vegetation System
|
|
|
-
|
|
|
-https://user-images.githubusercontent.com/87207603/201395614-0cf91fd3-a144-44f2-90f2-0d5e771826d2.mp4
|
|
|
-
|
|
|
-## Game Levels
|
|
|
-
|
|
|
-- **Main**, a start level and main gameplay level for a full game loop.
|
|
|
-
|
|
|
-## Requirements
|
|
|
-
|
|
|
-### Platforms
|
|
|
+We start by landing on planet environment tile, with limited fuel, our first mission is to recharge are ship with locating a natural power on the planet in the form of Power Crystals. The Local residence of this area might not like this and attempt to stop this energy collection grab. We must explore the planet and find resources. The Planet is made of of procedural crafted squares with a variety of enemy encounters, puzzles, and task to perform. If you run out of power completely, or attack and loose an enemy fight, the game ends.
|
|
|
|
|
|
-The project supports the following platforms:
|
|
|
+## Prerequisites
|
|
|
|
|
|
-- **Windows 10 version 1809 (10.0.17763)** or later is required.
|
|
|
+You need to build or [install O3DE engine](https://o3de.org/download/).
|
|
|
|
|
|
-## O3DE Installation
|
|
|
+## How to run
|
|
|
|
|
|
-1. Refer to the [O3DE System Requirements](https://www.o3de.org/docs/welcome-guide/requirements/) documentation to make sure that the system/hardware requirements are met.
|
|
|
-2. Please follow the instructions to [set up O3DE from GitHub](https://o3de.org/docs/welcome-guide/setup/setup-from-github/).
|
|
|
-3. **Use the development branch**: git checkout development.
|
|
|
+1. Download (green "Code" button, then "Download ZIP") or clone the github repository (`git clone https://github.com/o3de/PlanetSurvivalGame.git`)
|
|
|
+2. Launch O3DE. It will open the Project manager. Click on the **New Project** button then **Open Existing Project** option.
|
|
|
+3. Navigate to your download (and make sure it is unzipped). Open the **Project** folder. The project should now be registered.
|
|
|
|
|
|
-# Building the project
|
|
|
-
|
|
|
-## Build Steps
|
|
|
-
|
|
|
-1. Clone the PlanetSurvivalGame game project from the following repo:
|
|
|
- 1. git clone https://github.com/o3de/PlanetSurvivalGame
|
|
|
-2. Within the Project manager locate and click on the **New Project** button. Then from the drop down menu select the **Open Existing Project** option.
|
|
|
-3. Once Windows Explorer opens, navigate to and select the **Planet_Survival_Game** folder. Once selected click on the **Select Folder** button.
|
|
|
-4. This will load the **Planet_Survival_Game** project into the **Project Manager**.
|
|
|
|
|
|
-6. In order to build the project, locate and click on the **Build Project** button, located on the **Planet_Survival_Game** icon.
|
|
|
-
|
|
|
-
|
|
|
-## Launching the Project
|
|
|
-
|
|
|
-1. Once the project has been built sucessfully, the **Build Project** button will disappear and an **Open Editor** button should be the only option you can select.
|
|
|
-2. Click on the **Open Editor** button this will open the **Planet_Survival_Game** project.
|
|
|
-
|
|
|
-## Opening the Gameplay Level
|
|
|
-
|
|
|
-1. Once the Asset Processor has completed importing and processing a signifgance portion of the assets the O3DE Editor will open.
|
|
|
-2. In the **Welcome to O3DE** splash screen select the **Open** button to open a new level.
|
|
|
-3. This will open the **Open a Level** window
|
|
|
-4. Select the Main level and click the open level to launch the level.
|
|
|
-5. Once the level opens, the menu splash screen will ask you to mouse click to start the game.
|
|
|
-
|
|
|
-**Controlling the Main Player**
|
|
|
|
|
|
-**Navigation**
|
|
|
+4. Click on the **Build Project** button, located on the **Planet_Survival_Game** image.
|
|
|
+5. Once the project has been built sucessfully, use the **Open Editor** button.
|
|
|
+6. The asset pre-processor will run for a bit. Once it is over you will be welcomed with the **Open a Level** window, simply pick the first one.
|
|
|
|
|
|
-1. **The Main Player model can be moved around the level using Left Mouse Clicks.**
|
|
|
+## Controls
|
|
|
|
|
|
-**Ending Turn**
|
|
|
+The Main Player model can be moved around the level using Left Mouse Clicks.
|
|
|
+The Main Player UI next to the helmet will show how many moves are left. Once all moves are out the End Turn on the upper left will turn green.
|
|
|
|
|
|
-1. The Main Player UI next to helment will show how many moves are left. Once all moves are out the End Turn on the upper left will turn green.
|
|
|
+## Project Highlights
|
|
|
|
|
|
-**License**
|
|
|
+<video controls src="https://user-images.githubusercontent.com/87207603/201387109-4a65bdb9-7f70-43f3-8ab0-f47d8416ba1f.mp4" title="## "></video>
|
|
|
|
|
|
-For terms please see the LICENSE\*.TXT files at the root of this repository.
|
|
|
-
|
|
|
-For the sake of clarification licensing information can be also be found below.
|
|
|
-
|
|
|
-| OPEN 3D ENGINE LICENSING |
|
|
|
-| ------------------------ |
|
|
|
-| |
|
|
|
-
|
|
|
-| The default license for Open 3D Engine is the Apache License, Version 2.0 |
|
|
|
-| ------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| (see LICENSE_APACHE2.TXT); you may elect at your option to use the Open 3D |
|
|
|
-| -------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| Engine under the MIT License (see LICENSE_MIT.TXT). Contributions must be |
|
|
|
-| ------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| made under both licenses. |
|
|
|
-| ------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| |
|
|
|
-| --- |
|
|
|
-| |
|
|
|
-
|
|
|
-| THIRD PARTY COMPONENTS |
|
|
|
-| ---------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| Open 3D Engine requires the use of (and in some cases makes available to you) |
|
|
|
-| ----------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| software and assets that have been developed by third parties and are subject |
|
|
|
-| ----------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| to separate license terms (such as code licensed under other open source |
|
|
|
-| ------------------------------------------------------------------------ |
|
|
|
-| |
|
|
|
-
|
|
|
-| licenses). It is your responsibility to comply with the applicable licenses. |
|
|
|
-| ---------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| Information on third party materials, and the applicable license terms, are |
|
|
|
-| --------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| referenced in or included with the materials, such as in separate LICENSE.txt |
|
|
|
-| ----------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| files accompanying the materials. |
|
|
|
-| --------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| |
|
|
|
-| --- |
|
|
|
-| |
|
|
|
-
|
|
|
-| Please note that certain materials are subject to "copyleft" licenses, which |
|
|
|
-| ---------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| require distribution of source code, including: |
|
|
|
-| ----------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| |
|
|
|
-| --- |
|
|
|
-| |
|
|
|
-
|
|
|
-| - Qt Toolkit https://github.com/qtproject/, which is subject to the GNU |
|
|
|
-| ----------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| Lesser General Public License version 3 (with certain exceptions). A copy of |
|
|
|
-| ---------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
-
|
|
|
-| the source code for Qt Toolkit may be found at |
|
|
|
-| ---------------------------------------------- |
|
|
|
-| |
|
|
|
+- **Planet environment**, includes Many Size Rocks, Plants, Lava Spouts and Main Playing Island Grid.
|
|
|
+- **Alien Explorer**, a ready to use character model, with multiple character animations such as, walk and attack. Is modular with Many Skin Attachments.
|
|
|
+- **AI Player**, The Buggy AI Character will use the Nav Mesh to seek and move toward your Player character.
|
|
|
+- **Script Canvas Visual Scripts,** editable Script Canvas visual scripts for main and in game menu interaction, gameplay and player movement.
|
|
|
+- **Build dynamic levels with O3DE Vegetation System**
|
|
|
|
|
|
-| https://s3-us-west-2.amazonaws.com/ly-legal/LicenseConformance/Qt/Src.zip |
|
|
|
-| ------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
+### Screenshots
|
|
|
|
|
|
-| |
|
|
|
-| --- |
|
|
|
-| |
|
|
|
+
|
|
|
|
|
|
-| - The AWS Python SDK uses Chardet https://chardet.github.io/, which is |
|
|
|
-| ---------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
+
|
|
|
|
|
|
-| subject to the GNU Lesser General Public License version 2.1. A copy of the |
|
|
|
-| --------------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
+
|
|
|
|
|
|
-source code may be found at https://github.com/chardet/chardet.
|
|
|
+
|
|
|
|
|
|
-| - recastnavigation |
|
|
|
-| ------------------- |
|
|
|
-| |
|
|
|
+https://user-images.githubusercontent.com/87207603/201387317-6cfdab7f-df73-40d4-98ed-80b477a3d8bb.mp4
|
|
|
|
|
|
-| recastnavigation/recastnavigation is licensed under the zlib License |
|
|
|
-| -------------------------------------------------------------------- |
|
|
|
-| |
|
|
|
+https://user-images.githubusercontent.com/87207603/201395614-0cf91fd3-a144-44f2-90f2-0d5e771826d2.mp4
|
|
|
|
|
|
-https://github.com/recastnavigation/recastnavigation/blob/master/License.txt
|
|
|
+## License
|
|
|
|
|
|
+For terms please see the LICENSE\*.TXT files at the root of this repository.
|
|
|
+Recastnavigation is licensed under the [zlib License](https://github.com/recastnavigation/recastnavigation/blob/master/License.txt)
|
guillaume-haerinck