Skip to content
sense edited this page May 14, 2023 · 18 revisions

Setup and Installation

System Requirements

  • Windows 10 or 11
  • DirectX 11.3 compatible graphics card (we recommend a GTX970 or later)

Installation

  • Download and install .net 6.0 SDK
  • On Windows 10 you also need Windows Graphics tools:
    • Open Window Settings > Apps> Apps & features/Optional features.
    • If Graphics Tools is already listed under Installed features, then you're done. Otherwise, click Add a feature.
    • Search for and/or select Graphics Tools, and then click Install.
  • Download and unzip the latest release
  • Start StartT3.exe

Installing with development environment

For developing and debugging c# Operators we recommend setting up the development environment and running it from an IDE like Visual Studio:

Dependencies

  1. We only test on Win10. But Win11 might work too.
  2. If you don't have a .net IDE installed already, download and install Microsoft Visual Studio Community Edition

In the installer, make sure to select the features...

  1. .net Desktop Application development
  2. .net 4.7.1 (on the right side)
  3. Download and install .net 6.0 SDK
  4. You might also want to download and install a git client, like https://git-fork.com/ . Alternatively, you can install the bare bone git scm.
  5. On Windows 10, you also need to install Windows Graphics tools

Cloning the repository

If you don't have a GitHub account

Ideally, it would be better to sign-up. It's free and only takes a minute or so. This allows you to share your changes with the community. If not, do the following:

  1. Make sure that you have git scm installed (see above)
  2. Right file explorer right click on the folder you want T3 to install in and select Open git bash here
  3. Clone: git clone git@github.com:still-scene/t3.git Note: As of 2021-11-05 we no longer use submodules, so you don't have to care about setting up those.

If you have a GitHub account

  1. If you have a GitHub account, we recommend using ssh. Make sure you have an ssh-key installed correctly. GitHub has excellent documentation on that topic.

  2. With Fork you just clone the repository.

  3. If you're using the command line

    git clone  git@github.com:still-scene/t3.git
    

Completing the installation

  1. Start Install/install.bat To initialize some dependencies and the default view layouts. If you cleaned your solution with Visual Studio, you might need to run the install.bat script again.

Building and starting

  1. Open t3.sln
  2. In the Solution Explorer, right click on T3 to open the Properties panel. Under the section Debug, change the Working directory for all build modes to ... This is important, because the Resources folder needs to be on the same logical level as the starting directory. If this is not match, you will experience errors like "t3.ico" not found.
  3. Start the project in Debug or Release mode

Setting the startup directory in Visual Studio:

image

Here is a Video showing the entire Visual Studio Install and Build process.. once you have sucessfully created a Tooll3 repo from Github ..

Tooll3.IDE.install.and.Build.Procedure.mp4

Setting the startup directory in Rider:

image image

Pitfalls

Bass.DLL not found...

image

Solution: Make sure to run Install/install.bat.

Can't create fonts texture

image

Solution: Make sure to properly adjust the working directory.

Clone this wiki locally