# How to Setup

## GIT

#### How to Clone the Repository

To get started with the 3DEngine project, you'll need to clone the repository to your local machine. Below, you'll find instructions using Git, a popular version control system. If you have another version control system you prefer, feel free to use that, ensuring you adapt the commands accordingly.

**Using Git**

1. Open a terminal on your computer.
2. Navigate to the directory where you want to clone the repository.
3. Enter the following command:

   ```
   git clone https://github.com/CanTalat-Yakan/3DEngine.git
   ```
4. Press `Enter`, and Git will begin cloning the repository to your specified directory.

After following these steps, you will have a local copy of the 3DEngine repository, and you're ready to explore or contribute to the project.

## VISUAL STUDIO

#### Installing Visual Studio 2022 with Required Components

To set up your development environment for compiling the 3DEngine project, you must install Visual Studio 2022 along with specific components. Follow these steps:

1. Visit the [Visual Studio downloads page](https://visualstudio.microsoft.com/downloads/) to download the Visual Studio 2022 installer.
2. Run the installer and select the **Desktop development with C++** workload during the installation process.
3. Ensure to include the following individual components from the installation options:
   * **Windows 11 SDK** for the specific version required by the project. If the version is not listed, you may need to download it separately from the Microsoft website.
   * **Windows App SDK** to enable modern Windows UI development.
   * **.NET 8.0 SDK** for developing applications using the latest .NET capabilities.
4. Continue with the installation process and wait for Visual Studio 2022 and the required components to be installed.

Once the installation is complete, you'll have all the necessary tools installed to compile and contribute to the 3DEngine project.

### BUILD

#### Building the 3DEngine Project

After successfully installing Visual Studio 2022 and the required components, you can proceed with compiling the 3DEngine project. The project consists of three primary projects:

* **3DEngine (Package)**
* **Editor**
* **Engine**

To compile the **3DEngine (Package)** for both the **Editor** and the **Engine** as standalone projects, follow these steps:

1. Open the solution that contains the **3DEngine**, **Editor**, and **Engine** projects in Visual Studio 2022.
2. Set the **3DEngine (Package)** project as the startup project by right-clicking on it in the Solution Explorer and selecting *Set as Startup Project*.
3. To build the project, go to the `Build` menu and select `Build Solution`.

For the **Editor**, compiling the **3DEngine (Package)** requires adding a new Certification:

1. In the Solution Explorer, navigate to the **3DEngine (Package)** project and double-click on the `Package.appxmanifest` file to open it.
2. In the manifest editor window, switch to the last tab labeled **Packaging**.
3. Click on the **Choose Certificate** button, then either create a new certificate by following the prompts or select an existing one from the store if available.

Completing these steps ensures that the **3DEngine (Package)** is appropriately configured with a certification for development with the **Editor**.