mirror of
https://github.com/blitzkit/blitzkit.git
synced 2026-10-21 10:47:04 +02:00
106 lines
2.1 KiB
Markdown
106 lines
2.1 KiB
Markdown
# BlitzKit
|
|
|
|
Encyclopedia for World of Tanks Blitz.
|
|
|
|
## Development
|
|
|
|
Setting up a local developer environment for BlitzKit is more complex than most projects, but this section will guide you through all the steps. If you're ever lost or confused, feel free to ask for help in [the official Discord server](https://discord.gg/nDt7AjGJQH).
|
|
|
|
### Prerequisites
|
|
|
|
Before you touch any code, you'll need the following.
|
|
|
|
#### Linux
|
|
|
|
Because Node API for .NET doesn't resolve runtime-specific object files for libraries, the entirety of the BlitzKit project is "vendor-locked" to a single OS. GitHub Actions, responsible for BlitzKit CD/CI works best with Ubuntu, thus we must also use a Linux OS.
|
|
|
|
#### Windows (Optional)
|
|
|
|
...
|
|
|
|
#### Bun
|
|
|
|
https://bun.com/
|
|
|
|
BlitzKit is written mostly in TypeScript, with packages fetched from NPM, managed by Bun.
|
|
|
|
#### .NET
|
|
|
|
https://dotnet.microsoft.com/download/dotnet/9.0/
|
|
|
|
You'll need the .NET 9.0 SDK to build and run the interface layer between BlitzKit and your local installation of World of Tanks Blitz.
|
|
|
|
#### Protocol Buffers
|
|
|
|
https://protobuf.dev/installation/
|
|
|
|
Both BlitzKit and World of Tanks Blitz encode their APIs with Protocol Buffers.
|
|
|
|
#### World of Tanks Blitz
|
|
|
|
https://store.steampowered.com/app/444200/
|
|
|
|
You'll need an up-to-date installation of World of Tanks Blitz on your computer. You may use the same installation that you play, even on a Windows partition if you dual boot.
|
|
|
|
#### UE4SS
|
|
|
|
...
|
|
|
|
#### protodump
|
|
|
|
...
|
|
|
|
#### FModel (Optional)
|
|
|
|
...
|
|
|
|
### Set Up
|
|
|
|
Now we can start installing and initiating the code of BlitzKit.
|
|
|
|
#### Cloning
|
|
|
|
BlitzKit is a massive monorepo with a lot of submodules. You'll likely not need all the branches and commit history. So, clone with depth 1.
|
|
|
|
```bash
|
|
git clone --depth 1 https://github.com/blitzkit/blitzkit.git
|
|
cd blitzkit
|
|
git submodule update --init --recursive --depth 1
|
|
```
|
|
|
|
#### Proto Files
|
|
|
|
...
|
|
|
|
#### Mappings
|
|
|
|
...
|
|
|
|
#### Environment Variables
|
|
|
|
...
|
|
|
|
#### The Big One
|
|
|
|
...
|
|
|
|
### Modifying The Code
|
|
|
|
This is where you can start changing things and proposing them through pull requests.
|
|
|
|
#### Server
|
|
|
|
...
|
|
|
|
#### Building
|
|
|
|
...
|
|
|
|
#### Branches & Pull Requests
|
|
|
|
...
|
|
|
|
#### Updating
|
|
|
|
...
|