From 7bc6ac22f8499074050508a1666c8ded4ac37bbb Mon Sep 17 00:00:00 2001 From: GenZmeY Date: Sun, 20 Feb 2022 22:59:39 +0300 Subject: [PATCH] update README.md --- README.md | 68 ++++++++++++++++++------------------------------------- 1 file changed, 22 insertions(+), 46 deletions(-) diff --git a/README.md b/README.md index a582558..6e331e8 100644 --- a/README.md +++ b/README.md @@ -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) [![license](https://img.shields.io/github/license/GenZmeY/KF2-Server-Extension)](LICENSE) -## Features: +# Features: - Build, brew, test and upload to Steam Workshop; - No need to edit KFEditor.ini at all; - Sources can be stored in any path; - Easily switch between different projects. -## Add to your project -[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). +# Requirements +- [git-bash](https://git-scm.com/download/win) -**There are two options to add KF2-BuildTools to your project:** - -### As git submodule +# Add to your project Make sure that the location of folders and files in your project is as follows (Correct it if it's not): -`//Classes/*uc` +`//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 ` -Then run the command: -`git submodule add https://github.com/GenZmeY/KF2-BuildTools tools` +Add submodule: `git submodule add https://github.com/GenZmeY/KF2-BuildTools tools` **updating build tools:** -Open git-bash and go to your project: `cd ` -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'. +Get updates: `pushd tools && git pull && popd` +Commit the changes: `git add tools && git commit -m 'update tools'` -Changes not staged for commit: - (use "git add ..." to update what will be committed) - (use "git restore ..." 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'` - -### As standalone script +## 2. As standalone script 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. -## If you are using someone else's project that has BuildTools... -If you haven't downloaded the project yet, just add `--recurse-submodules` when cloning it: -`git clone --recurse-submodules ` -If you have already downloaded the project, just run the command in the project folder: -`git submodule update --init --recursive` +# Usage +Available commands can be found here: [USAGE.md](USAGE.md) -## Usage (Basic) -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 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 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. -### Prepare +## Prepare **UNDER CONSTRUCTION** -### Compilation +## Compilation **UNDER CONSTRUCTION** -### Brewing +## Brewing **UNDER CONSTRUCTION** -### Testing +## Testing **UNDER CONSTRUCTION** -### Uploading to steam workshop +## Uploading to steam workshop **UNDER CONSTRUCTION** -## Other +# Other [TODO List](TODO.md) -## License +# License [GNU GPLv3](LICENSE)