Welcome to my tech demo :). A procedurally generated map where AI agents move and behave according to their agenda/behaviour tree.
This project is made as part of ECS7016P - Interactive Agents and Procedural Generation Module. This unity coursework procedurally generates underwater caves and simulates agents navigating through these caves. The cave generation is based on cellular automata, and the navigation and behaviour of agents are achieved using MovementAI and NPBehave packages, respectively. The project is composed of two main components: the underwater cave generator and the agents.
- The version of Unity: 2021.3.23f1 ( SILICON - LTS)
- Video Demonstration Link YouTube: https://www.youtube.com/watch?v=xqP1vbGIiIs
- Video Demonstration Link OneDrive: https://1drv.ms/v/s!AvMx0xMGq3SagmdbOrs1R5_tBoHs
- Project Repository Link: https://github.com/HuseynG/ECS7016P_TechDemo
To set up the project, follow these steps:
- Download the project file from the GitHub repository. If you are not already on the repository page, use the link provided in this README.md file.
- If the downloaded file/folder is compressed, unzip it.
- Open Unity and ensure that you have the compatible version mentioned above.
- Open the project folder (ECS7016P_TechDemo > Interactive_Agents_CW_UnderSeaExplorers_Huseyn_Gorbani) with Unity where you have saved the downloaded file.
- Within the project folder, navigate to the "Assets" folder and click on the "Main.unity" file.
- You should now see the project hierarchy, similar to the picture below.
The Underwater Cave system is generated using four scripts:
- UnderwaterCaveGenerator.cs
- MeshGenerator.cs
- CustomSpawner.cs
- CaveConnector.cs. These scripts work together to create a procedurally generated underwater cave environment.
Please Note: During the development of MeshGenerator.cs and CaveConnector.cs, the repository of Sebastian Lague (available at: https://github.com/SebLague/Procedural-Cave-Generation) was studied and re-used partially to achieve a more realistic cave.
Inside the unity project, located in the Generators folder (Assets > Generators > UnderwaterCaveGenerator.cs), this script is responsible for generating the cave structure using a cellular automata approach to manage the overall map generation and game map logic. It initialises the cave with random tiles (soil or water) and iteratively smooths the cave structure based on the surrounding tiles. The generated cave structure is represented as a grid of integers, where 0 represents water, and 1 represents soil. Additionally, it handles the placement of prefabs, including agents (Diver, Mermaid, and Shark) and the Treasure Chest.
Inside the unity project, located in the Generators folder (Assets > Generators > MeshGenerator.cs), this script generates the mesh for the cave environment based on the grid created by the UnderwaterCaveGenerator.cs script. It processes the grid to create vertices and triangles in both the soil and water layers. This script handles the generation of the mesh for the water layer, which is placed slightly below the soil layer.
Inside the unity project, located in the Generators folder (Assets > Generators > CustomSpawner.cs), this script is responsible for spawning MovementAI obstacle game objects based on soil cells within the generated cave environment. The script takes the generated grid as input and places obstacle objects at suitable locations, but not for every soil cell; instead, it places them only in every 10th soil cell. These obstacles are used to establish hiding behaviour for the agents, utilizing the MovementAI library.
Located in the Generators folder (Assets > Generators > CaveConnector.cs), this script identifies and connects separate cave rooms generated by the cellular automata process. It identifies rooms by performing a Flood-Fill algorithm and then finds the closest rooms to each other. Finally, it creates corridors between the rooms to connect them, ensuring that the whole cave system is interconnected and navigable for the agents.
Together, these four scripts work in tandem to create a procedurally generated underwater cave environment, complete with interconnected rooms and various agents and objects placed within it.
Goal: Seek and Find the Treasure Chest. Behaviours:
- When in danger,
- place a limited number of Sea Mines (up to 5) to kill the chasing Shark.
- Evade from the Shark.
- Hide from the Shark.
- Get distracted by the Mermaid, follow it and temporarily forgetting about the Treasure Chest.
- Seek and attempt to find the Treasure Chest.
Goal: Distract the Diver from the Treasure Chest and potentially lead them closer to the Shark by interposing between them. Behaviours:
- Look for the Diver to distract them from the Treasure Chest and lead them towards the Shark.
- Move randomly around the Treasure Chest.
Goal: Protect the Treasure Chest from Diver Behaviours:
- Chase and attempt to kill the Diver if the distance from the Treasure Chest is less than 150% of the Shark's distance from the Diver
- Protect the Treasure Chest by patrolling its vicinity.
