Unity SDK Setup

The SDK is based on Unity, this guide will show you how to setup Unity and the SDK.

Unity Editor install

First thing is to download the Unity Hub and install it.

Once installed, you then need to install the current Unity version BAS is using. Generally having the same MAJOR.MINOR LTS version of Unity is fine. But for full compatibility, try to use the same version BAS itself uses.

Blade and Sorcery uses 2021.3.38f1.

  1. Open the Unity Hub.
  2. Click Installs on the left side.
  3. Click Install Editor.
  4. Unity Version 2021.3.38 is a previous Unity LTS version, so you must go to “Archive” then “download archive”. Alternatively, you can click Here.
  5. Click on 2021 at the top of the page, and locate 2021.3.38f1.
  6. Click Install, allow the Unity page to access programs outside of the webpage (for Unity Hub) and agree to the Terms of Service.

Unity will now download and install the editor.

Sync SDK repository on your computer

The SDK is hosted on Github. To make further updates easily, we highly recommend to install a version control software like Github Desktop, that will allow you to update the repository and be aware of any local changes.

  1. Go and install GitHub Desktop: https://desktop.github.com/
  2. Go to the SDK Git repository
  3. Copy the Git URL

  1. Open Github Desktop, go to File> Clone repository and paste the URL to clone the repository on your machine

Once synced, you can switch from different SDK version by changing branch (Master will always be the latest version of the SDK) Fetch

Fetch button will update your local repository if any updates has been pushed on the online repositor

Branch

Open SDK with Unity

We will use the Unity Hub to open the BAS SDK.

  1. Open the Unity Hub.
  2. Click Projects on the left side
  3. Click Open at the top of the projects section.
  4. Navigate to where you extracted the BasSDK-master folder.
  5. Click the folder BasSDK-master
  6. Click Open.

Unity will then open the project and start to process and import the project files. This may take some time, so let it complete.

Once the import is finished, you should see the Unity editor scene and/or game view.