help.Installation - tooll3/t3 GitHub Wiki
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:
- You will also need the Windows Graphics tools:
- Open Window Settings > System > Optional features.
- If Graphics Tools is already listed under Installed features, then you're done.
- Otherwise, click Add an optional feature.
- Search and select Graphics Tools, and 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
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:
- .NET Desktop Application development
- .NET 4.7.1 (on the right side)
- Download and install .NET 6.0 SDK
- You might also want to download and install a git client, like git-fork. Alternatively, you can install the bare bone git scm.
- 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:
- Make sure that you have git scm installed (see above)
- In file explorer, right-click on the folder where you want to install T3 and select Open git bash here
- Clone the repository:
git clone [email protected]:tooll3/t3.git
If you have a GitHub account
- We recommend using ssh
- Make sure you have an ssh-key installed correctly. GitHub has excellent documentation on this topic
- With Fork you just clone the repository
- If you're using the command-line:
git clone [email protected]:tooll3/t3.git
Github desktop
If you use a Github account, but are uncomfortable with terminals, Github provides a pretty good desktop application for that matter.
Resolve build dependencies
Initialize dependencies and the default view layouts. If you cleaned your solution with Visual Studio, you might need to run the install.bat
script gain.
This script should be run from its parent folder like so:
cd .\Install
.\install.bat
Building and starting
- Open
t3.sln
- 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 doesn't match, you will experience errors such as "
t3.ico not found
"
- Start the project in
Debug
orRelease
mode
Setting the startup directory in Visual Studio:
Here is a Video showing the entire Visual Studio Install and Build process.. once you have successfully created a Tooll3 repo from Github
https://github.com/tooll3/t3/assets/1504019/2163e280-9754-4857-9b73-283517a79dee
Setting the startup directory in Rider:
Pitfalls
Bass.DLL not found...
Solution: Make sure you ran Install.bat
, as described here.
Can't create fonts texture
Solution: Make sure to properly adjust the working directory.