1
0

update README.md

This commit is contained in:
GenZmeY 2022-02-20 22:59:39 +03:00
parent 5e4b98689e
commit 7bc6ac22f8

View File

@ -4,81 +4,57 @@
[![docs-autoupdate](https://github.com/GenZmeY/KF2-BuildTools/actions/workflows/docs-autoupdate.yml/badge.svg)](https://github.com/GenZmeY/KF2-BuildTools/actions/workflows/docs-autoupdate.yml) [![docs-autoupdate](https://github.com/GenZmeY/KF2-BuildTools/actions/workflows/docs-autoupdate.yml/badge.svg)](https://github.com/GenZmeY/KF2-BuildTools/actions/workflows/docs-autoupdate.yml)
[![license](https://img.shields.io/github/license/GenZmeY/KF2-Server-Extension)](LICENSE) [![license](https://img.shields.io/github/license/GenZmeY/KF2-Server-Extension)](LICENSE)
## Features: # Features:
- Build, brew, test and upload to Steam Workshop; - Build, brew, test and upload to Steam Workshop;
- No need to edit KFEditor.ini at all; - No need to edit KFEditor.ini at all;
- Sources can be stored in any path; - Sources can be stored in any path;
- Easily switch between different projects. - Easily switch between different projects.
## Add to your project # Requirements
[git-bash](https://git-scm.com/) is the only thing you need. If you're already using git, you probably already have it. If not, [install it](https://git-scm.com/download/win). - [git-bash](https://git-scm.com/download/win)
**There are two options to add KF2-BuildTools to your project:** # Add to your project
### As git submodule
Make sure that the location of folders and files in your project is as follows (Correct it if it's not): Make sure that the location of folders and files in your project is as follows (Correct it if it's not):
`/<PackageName>/Classes/*uc` `/<PackageName>/Classes/*.uc`
**There are two ways to add KF2-BuildTools to your project:
## 1. As [git submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules)
Open git-bash and go to your project: `cd <your_project_path>` Open git-bash and go to your project: `cd <your_project_path>`
Then run the command: Add submodule: `git submodule add https://github.com/GenZmeY/KF2-BuildTools tools`
`git submodule add https://github.com/GenZmeY/KF2-BuildTools tools`
**updating build tools:** **updating build tools:**
Open git-bash and go to your project: `cd <your_project_path>` Get updates: `pushd tools && git pull && popd`
Get updates with the following command: `pushd tools && git pull && popd`
Now if you run `git status` you can see that `tools` has changed:
```
$ git status
On branch master
Your branch is up to date with 'origin/master'.
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: tools (new commits)
no changes added to commit (use "git add" and/or "git commit -a")
```
Commit the changes: `git add tools && git commit -m 'update tools'` Commit the changes: `git add tools && git commit -m 'update tools'`
### As standalone script ## 2. As standalone script
Just create a `tools` folder and put [builder](builder) there. Just create a `tools` folder and put [builder](builder) there.
Now you can use the script in the same way as in the first case, but you will have to update it yourself. Now you can use the script in the same way as in the first case, but you will have to update it yourself.
## If you are using someone else's project that has BuildTools... # Usage
If you haven't downloaded the project yet, just add `--recurse-submodules` when cloning it: Available commands can be found here: [USAGE.md](USAGE.md)
`git clone --recurse-submodules <someone_else's_project>`
If you have already downloaded the project, just run the command in the project folder:
`git submodule update --init --recursive`
## Usage (Basic) If you have a simple mutator or game mode, then the usage is also simple: just use [the commands](USAGE.md) to compile, test and upload to the steam workshop.
If you have a simple mutator or game mode, then the usage is also simple:
`./tools/builder --compile` build project
`./tools/builder --test` start project test
`./tools/builder --upload` upload/update your project to/in the steam workshop
If you need help with commands, run: `./tools/builder --help`, or visit [this page](USAGE.md). # Usage (Advanced)
## Usage (Advanced)
If your project contains several mutators, *.upk files, external dependencies, or you want to customize the whole process in more detail, then this section is for you. If your project contains several mutators, *.upk files, external dependencies, or you want to customize the whole process in more detail, then this section is for you.
### Prepare ## Prepare
**UNDER CONSTRUCTION** **UNDER CONSTRUCTION**
### Compilation ## Compilation
**UNDER CONSTRUCTION** **UNDER CONSTRUCTION**
### Brewing ## Brewing
**UNDER CONSTRUCTION** **UNDER CONSTRUCTION**
### Testing ## Testing
**UNDER CONSTRUCTION** **UNDER CONSTRUCTION**
### Uploading to steam workshop ## Uploading to steam workshop
**UNDER CONSTRUCTION** **UNDER CONSTRUCTION**
## Other # Other
[TODO List](TODO.md) [TODO List](TODO.md)
## License # License
[GNU GPLv3](LICENSE) [GNU GPLv3](LICENSE)