Compare commits
7 Commits
Author | SHA1 | Date | |
---|---|---|---|
42f9cc4931 | |||
3d43768f04 | |||
5655aae2e5 | |||
f10871b501 | |||
3ffc5b0e55 | |||
1a78385437 | |||
5d3a7cece3 |
2
.gitignore
vendored
2
.gitignore
vendored
@ -1,2 +0,0 @@
|
||||
testing.ini
|
||||
3rd-party-bin
|
3
.gitmodules
vendored
Normal file
3
.gitmodules
vendored
Normal file
@ -0,0 +1,3 @@
|
||||
[submodule "tools"]
|
||||
path = tools
|
||||
url = https://github.com/GenZmeY/KF2-BuildTools
|
@ -1,11 +1,10 @@
|
||||
[h1]WARNING![/h1]
|
||||
[h1]Warning[/h1]
|
||||
This mod is not whitelisted and will unrank your server. Any XP gained will not be saved.
|
||||
|
||||
[h1]Disclaimer [/h1]
|
||||
This is the same as [url=https://steamcommunity.com/sharedfiles/filedetails/?id=1417081496]Pharrahnox's SetWave[/url], but with some fixes:
|
||||
- fixed Dosh parameter for Endless mode.
|
||||
|
||||
[h1]Description:[/h1]
|
||||
This is the same as [url=https://steamcommunity.com/sharedfiles/filedetails/?id=1417081496]Pharrahnox's SetWave[/url], but with some fixes:
|
||||
- fixed starting Dosh for Endless mode.
|
||||
|
||||
A utility mod that allows users to specify the starting wave and the boss that will spawn. Additionally, users can jump between waves during the match with a console command (mutate setwave, see below).
|
||||
The purpose of this mod is to allow mappers to more efficiently test their maps for later waves or for the boss. It could also be used to skip early waves if you find them boring, or to test strategies against a specific boss.
|
||||
It is designed to be compatible with every mutator and wave-based gamemode, and to require little to no maintenance after game updates.
|
||||
@ -16,7 +15,7 @@ It is designed to be compatible with every mutator and wave-based gamemode, and
|
||||
3. Open console (`) and input:
|
||||
[code]open KF-BioticsLab?Game=KFGameContent.KFGameInfo_Endless?Difficulty=0?GameLength=0?Mutator=StartWave.StartWave?[/code]
|
||||
Change the name of the map and the parameters of the game to the ones you need.
|
||||
Add StartWave parameters that you need to this line (you can add any parameter from the config, the description is below).
|
||||
Add StartWave parameters that you need to the end of the line (you can add any parameter from the config, the description is below).
|
||||
4. <Enter>.
|
||||
|
||||
[h1]Usage (server):[/h1]
|
||||
@ -24,20 +23,21 @@ Add StartWave parameters that you need to this line (you can add any parameter f
|
||||
|
||||
1. Open your PCServer-KFEngine.ini / LinuxServer-KFEngine.ini;
|
||||
2. Add the following string to the [b][OnlineSubsystemSteamworks.KFWorkshopSteamworks][/b] section:
|
||||
[code]ServerSubscribedWorkshopItems=<WORKSHOP_ID>[/code]
|
||||
[code]ServerSubscribedWorkshopItems=2521731447[/code]
|
||||
3. Start the server and wait while the mutator is downloading;
|
||||
4. Stop the server;
|
||||
5. Add mutator to server start line: [b]?Mutator=StartWave.StartWave[/b]
|
||||
6. Add startwave launch parameters or use config (the description is below).
|
||||
6. Add StartWave parameters or use config (the description is below).
|
||||
7. Start the server
|
||||
|
||||
[h1]Mutator setup[/h1]
|
||||
You can use a config file if you do not want to specify parameters in the startup line:
|
||||
You can use a config if you don't want to specify parameters in the startup line:
|
||||
Create a file KFGame/Config/KFStartWave.ini and copy this text into it:
|
||||
[code]
|
||||
[StartWave.StartWave]
|
||||
// Any settings not specified in the launch command will use the values stored here. If you use the same
|
||||
// settings often, it is recommended to store those here and only change what you need in the launch command.
|
||||
// Any settings not specified in the launch command will use the values stored here.
|
||||
// If you use the same settings often, it is recommended to store those here
|
||||
// and only change what you need in the launch command.
|
||||
|
||||
// Whether mod-specific events should be logged.
|
||||
bUseDebug=true
|
||||
@ -57,8 +57,9 @@ TraderTime=60
|
||||
// The starting dosh of players.
|
||||
Dosh=250
|
||||
|
||||
// The boss override index. For the default boss list, 0-Hans, 1-Patty, 2-King FP, 3-Abomination. Negative
|
||||
// values can be used to keep the boss spawn random.
|
||||
// The boss override index.
|
||||
// For the default boss list, 0-Hans, 1-Patty, 2-King FP, 3-Abomination.
|
||||
// Negative values can be used to keep the boss spawn random.
|
||||
Boss=-1
|
||||
[/code]
|
||||
You can change the config as you need.
|
||||
@ -76,7 +77,7 @@ mutate setwave 3 // identical to the above (the last parameter defaults to
|
||||
You can jump forwards or backwards between waves (e.g. from 5 -> 2 -> 8 -> 3, etc.)
|
||||
|
||||
[h1]If not working[/h1]
|
||||
Older versions of Setwave have the same file names - this can cause conflicts if you subscribe to them. Therefore:
|
||||
Older versions of SetWave have the same file names - this can cause conflicts if you subscribe to them. Therefore:
|
||||
1. Check your subscriptions. If you are subscribed to old versions of the mutator, cancel them.
|
||||
2. Clear the cache (the game doesn't clear it). It's here:
|
||||
[code]
|
||||
@ -96,9 +97,5 @@ I didn't test the mod very much because I only needed to fix a bug with Dosh.
|
||||
If you find any other problems, please describe how to reproduce them. Maybe I can fix it.
|
||||
You can do it right here, but I'll be much happier if you do it [url=https://github.com/GenZmeY/KF2-StartWave/issues]in issues on github[/url] .
|
||||
|
||||
[h1]Credits:[/h1]
|
||||
[url=https://steamcommunity.com/profiles/76561198021230296]Pharrahnox[/url] - creating a mutator;
|
||||
[url=https://steamcommunity.com/profiles/76561198001617867]GenZmeY[/url] - bugfixes.
|
||||
|
||||
[h1]Sources:[/h1]
|
||||
[u]https://github.com/GenZmeY/KF2-StartWave[/u] [b](GNU GPLv3)[/b]
|
38
README.md
38
README.md
@ -1,32 +1,46 @@
|
||||
# KF2-StartWave
|
||||
|
||||
[](https://steamcommunity.com/sharedfiles/filedetails/?id=<WORKSHOP_ID>)
|
||||
[](https://steamcommunity.com/sharedfiles/filedetails/?id=<WORKSHOP_ID>)
|
||||
[](https://steamcommunity.com/sharedfiles/filedetails/?id=<WORKSHOP_ID>)
|
||||
[](https://steamcommunity.com/sharedfiles/filedetails/?id=<WORKSHOP_ID>)
|
||||
[](https://steamcommunity.com/sharedfiles/filedetails/?id=2521731447)
|
||||
[](https://steamcommunity.com/sharedfiles/filedetails/?id=2521731447)
|
||||
[](https://steamcommunity.com/sharedfiles/filedetails/?id=2521731447)
|
||||
[](https://steamcommunity.com/sharedfiles/filedetails/?id=2521731447)
|
||||
[](https://github.com/GenZmeY/KF2-StartWave/tags)
|
||||
[](LICENSE)
|
||||
|
||||
# Description
|
||||
A utility mod that allows users to specify the starting wave and the boss that will spawn. Additionally, users can jump between waves during the match with a console command (mutate setwave, see below).
|
||||
The purpose of this mod is to allow mappers to more efficiently test their maps for later waves or for the boss. It could also be used to skip early waves if you find them boring, or to test strategies against a specific boss.
|
||||
It is designed to be compatible with every mutator and wave-based gamemode, and to require little to no maintenance after game updates.
|
||||
|
||||
**This is the same as [Pharrahnox's SetWave](https://steamcommunity.com/sharedfiles/filedetails/?id=1417081496), but with some fixes:**
|
||||
- fixed starting Dosh for Endless mode.
|
||||
|
||||
# Usage
|
||||
[See steam workshop page](https://steamcommunity.com/sharedfiles/filedetails/?id=<WORKSHOP_ID>)
|
||||
[See steam workshop page](https://steamcommunity.com/sharedfiles/filedetails/?id=2521731447)
|
||||
|
||||
***
|
||||
|
||||
**Note:** If you want to build/test/brew/publish a mutator without git-bash and/or scripts, follow [these instructions](https://tripwireinteractive.atlassian.net/wiki/spaces/KF2SW/pages/26247172/KF2+Code+Modding+How-to) instead of what is described here.
|
||||
|
||||
# Build
|
||||
1. Install [Killing Floor 2](https://store.steampowered.com/app/232090/Killing_Floor_2/), Killing Floor 2 - SDK and [git for windows](https://git-scm.com/download/win);
|
||||
2. Open git-bash in the folder: `C:\Users\<USERNAME>\Documents\My Games\KillingFloor2\KFGame`
|
||||
2. open git-bash and go to any folder where you want to store sources:
|
||||
`cd <ANY_FOLDER_YOU_WANT>`
|
||||
3. Clone this repository and go to the source folder:
|
||||
`git clone https://github.com/GenZmeY/KF2-StartWave && cd KF2-StartWave`
|
||||
4. Run make.sh script:
|
||||
`./make.sh --compile`
|
||||
4. Download dependencies:
|
||||
`git submodule init && git submodule update`
|
||||
5. Compile:
|
||||
`./tools/builder -c`
|
||||
5. The compiled files will be here:
|
||||
`C:\Users\<USERNAME>\Documents\My Games\KillingFloor2\KFGame\Unpublished\BrewedPC\Script\`
|
||||
|
||||
# Testing
|
||||
You can check your build using the `make.sh` script.
|
||||
Open git-bash in the source folder and run the script:
|
||||
`./make.sh --test`
|
||||
On first launch, the script will create `testing.ini` file and launch the game with the settings from it (KF-Nuked map + ServerExtMut). Edit this file if you need to test the mutator with different parameters.
|
||||
Open git-bash in the source folder and run command:
|
||||
`./tools/builder -t`
|
||||
(or `./tools/builder -ct` if you haven't compiled the mutator yet)
|
||||
|
||||
A local single-user test will be launched with parameters from `test.cfg` (edit this file if you want to test mutator with different parameters).
|
||||
|
||||
# Bug reports
|
||||
If you find a bug, go to the [issue page](https://github.com/GenZmeY/KF2-StartWave/issues) and check if there is a description of your bug. If not, create a new issue.
|
||||
|
16
build.cfg
Normal file
16
build.cfg
Normal file
@ -0,0 +1,16 @@
|
||||
# Build parameters
|
||||
|
||||
# If True - compresses the mutator when compiling
|
||||
# Scripts will be stored in binary form
|
||||
# (reduces the size of the output file)
|
||||
StripSource="True"
|
||||
|
||||
# Mutators to be compiled
|
||||
# Specify them with a space as a separator,
|
||||
# Mutators will be compiled in the specified order
|
||||
PackageBuildOrder="StartWave"
|
||||
|
||||
# Mutators that will be uploaded to the workshop
|
||||
# Specify them with a space as a separator,
|
||||
# The order doesn't matter
|
||||
PackageUpload="StartWave"
|
220
make.sh
220
make.sh
@ -1,220 +0,0 @@
|
||||
#!/bin/bash
|
||||
|
||||
# Requirements: git-bash
|
||||
# https://git-scm.com/download/win
|
||||
|
||||
set -Eeuo pipefail
|
||||
trap cleanup SIGINT SIGTERM ERR EXIT
|
||||
|
||||
function winpath2unix () # $1: win path
|
||||
{
|
||||
echo "$*" | \
|
||||
sed -r 's|^(.):|\\\1|' | \
|
||||
sed 's|\\|/|g'
|
||||
}
|
||||
|
||||
function unixpath2win () # $1: unix path
|
||||
{
|
||||
echo "$*" | \
|
||||
sed -r 's|^/(.)|\1:|' | \
|
||||
sed 's|/|\\|g'
|
||||
}
|
||||
|
||||
function reg_readkey () # $1: path, $2: key
|
||||
{
|
||||
winpath2unix $(
|
||||
reg query "$1" //v "$2" | \
|
||||
grep -F "$2" | \
|
||||
awk '{ $1=$2=""; print $0 }' )
|
||||
}
|
||||
|
||||
function show_help ()
|
||||
{
|
||||
echo "$ScriptName"
|
||||
echo "Usage:"
|
||||
echo "${ScriptName} OPTION"
|
||||
echo "Options:"
|
||||
echo " -c, --compile"
|
||||
echo " -b, --brew"
|
||||
echo " -bu, --brew-unpublished"
|
||||
echo " -u, --upload"
|
||||
echo " -t, --test"
|
||||
echo " -h, --help"
|
||||
}
|
||||
|
||||
function cleanup()
|
||||
{
|
||||
trap - SIGINT SIGTERM ERR EXIT
|
||||
restore_kfeditorconf
|
||||
}
|
||||
|
||||
function get_latest_multini ()
|
||||
{
|
||||
local ApiUrl="https://api.github.com/repos/GenZmeY/multini/releases/latest"
|
||||
local LatestTag=$(curl --silent "$ApiUrl" | grep -Po '"tag_name": "\K.*?(?=")')
|
||||
local DownloadUrl="https://github.com/GenZmeY/multini/releases/download/$LatestTag/multini-windows-amd64.exe"
|
||||
|
||||
mkdir -p "$ThirdPartyBin"
|
||||
curl -LJs "$DownloadUrl" -o "$ThirdPartyBin/multini.exe"
|
||||
}
|
||||
|
||||
function backup_kfeditorconf ()
|
||||
{
|
||||
cp "$KFEditorConf" "$KFEditorConfBackup"
|
||||
}
|
||||
|
||||
function restore_kfeditorconf ()
|
||||
{
|
||||
if [[ -f "$KFEditorConfBackup" ]]; then
|
||||
mv -f "$KFEditorConfBackup" "$KFEditorConf"
|
||||
fi
|
||||
}
|
||||
|
||||
function setup_modpackages ()
|
||||
{
|
||||
multini --set "$KFEditorConf" 'ModPackages' 'ModPackages' 'StartWave'
|
||||
multini --set "$KFEditorConf" 'ModPackages' 'ModPackagesInPath' "$(unixpath2win "$MutSource")"
|
||||
}
|
||||
|
||||
function compiled ()
|
||||
{
|
||||
test -f "$MutStructScript/StartWave.u"
|
||||
}
|
||||
|
||||
function compile ()
|
||||
{
|
||||
if ! command -v multini &> /dev/null; then
|
||||
get_latest_multini
|
||||
fi
|
||||
|
||||
backup_kfeditorconf && setup_modpackages
|
||||
|
||||
rm -rf "$MutUnpublish"
|
||||
mkdir -p \
|
||||
"$MutUnpublish" \
|
||||
"$MutStructScript"
|
||||
|
||||
CMD //C "$(unixpath2win "$KFEditor")" make -useunpublished &
|
||||
local PID="$!"
|
||||
while ps -p "$PID" &> /dev/null
|
||||
do
|
||||
if compiled; then
|
||||
kill "$PID"; break
|
||||
fi
|
||||
sleep 2
|
||||
done
|
||||
|
||||
restore_kfeditorconf
|
||||
|
||||
if ! compiled; then
|
||||
echo "Compilation failed"
|
||||
return 1
|
||||
fi
|
||||
}
|
||||
|
||||
function brew ()
|
||||
{
|
||||
echo "brew command is broken. Use --brew-unpublished or brew from WorkshopUploadToolGUI instead of this."
|
||||
# CMD //C "$(unixpath2win "$KFEditor")" brewcontent -platform=PC ServerExt ServerExtMut -useunpublished
|
||||
}
|
||||
|
||||
function brew_unpublished ()
|
||||
{
|
||||
rm -rf "$MutPublish"
|
||||
if ! compiled; then
|
||||
compile
|
||||
fi
|
||||
cp -rf "$MutUnpublish" "$MutPublish"
|
||||
}
|
||||
|
||||
function generate_wsinfo () # $1: package dir
|
||||
{
|
||||
local Description=$(cat "$MutPubContent/description.txt")
|
||||
local Title=$(cat "$MutPubContent/title.txt")
|
||||
local Preview=$(unixpath2win "$MutPubContent/preview.png")
|
||||
local Tags=$(cat "$MutPubContent/tags.txt")
|
||||
local PackageDir=$(unixpath2win "$1")
|
||||
echo "\$Description \"$Description\"
|
||||
\$Title \"$Title\"
|
||||
\$PreviewFile \"$Preview\"
|
||||
\$Tags \"$Tags\"
|
||||
\$MicroTxItem \"false\"
|
||||
\$PackageDirectory \"$PackageDir\"
|
||||
" > "$MutWsInfo"
|
||||
}
|
||||
|
||||
function upload ()
|
||||
{
|
||||
PackageDir=$(mktemp -d -u -p "$KFDoc")
|
||||
cp -rf "$MutPublish"/* "$PackageDir"
|
||||
generate_wsinfo "$PackageDir"
|
||||
CMD //C "$(unixpath2win "$KFWorkshop")" "$MutWsInfoName"
|
||||
rm -rf "$PackageDir"
|
||||
rm -f "$MutWsInfo"
|
||||
}
|
||||
|
||||
function create_default_testing_ini ()
|
||||
{
|
||||
echo "Map=\"KF-Outpost\"
|
||||
Game=\"KFGameContent.KFGameInfo_Endless\"
|
||||
Difficulty=\"0\"
|
||||
GameLength=\"0\"
|
||||
Mutators=\"StartWave.StartWave\"
|
||||
Args=\"StartWave=7?Dosh=999?bUseDebug=True\"" > "$MutTestingIni"
|
||||
}
|
||||
|
||||
function game_test ()
|
||||
{
|
||||
if ! [[ -r "$MutTestingIni" ]]; then
|
||||
create_default_testing_ini
|
||||
fi
|
||||
source "$MutTestingIni"
|
||||
CMD //C "$(unixpath2win "$KFGame")" ${Map}?Difficulty=${Difficulty}?GameLength=${GameLength}?Game=${Game}?Mutator=${Mutators}?${Args} -useunpublished -log
|
||||
}
|
||||
|
||||
ScriptFullname=$(readlink -e "$0")
|
||||
ScriptName=$(basename "$0")
|
||||
ScriptDir=$(dirname "$ScriptFullname")
|
||||
|
||||
SteamPath=$(reg_readkey "HKCU\Software\Valve\Steam" "SteamPath")
|
||||
DocumentsPath=$(reg_readkey "HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" "Personal")
|
||||
|
||||
KFPath="$SteamPath/steamapps/common/killingfloor2"
|
||||
KFBin="$KFPath/Binaries"
|
||||
KFEditor="$KFBin/Win64/KFEditor.exe"
|
||||
KFGame="$KFBin/Win64/KFGame.exe"
|
||||
KFWorkshop="$KFBin/WorkshopUserTool.exe"
|
||||
|
||||
KFDoc="$DocumentsPath/My Games/KillingFloor2"
|
||||
KFConfig="$KFDoc/KFGame/Config"
|
||||
|
||||
KFEditorConf="$KFConfig/KFEditor.ini"
|
||||
KFEditorConfBackup="${KFEditorConf}.backup"
|
||||
|
||||
MutSource="$ScriptDir"
|
||||
MutPubContent="$MutSource/PublicationContent"
|
||||
MutUnpublish="$KFDoc/KFGame/Unpublished"
|
||||
MutPublish="$KFDoc/KFGame/Published"
|
||||
|
||||
MutStructScript="$MutUnpublish/BrewedPC/Script"
|
||||
MutStructPackages="$MutUnpublish/BrewedPC/Packages"
|
||||
MutStructLocalization="$MutUnpublish/BrewedPC/Localization"
|
||||
|
||||
MutTestingIni="$MutSource/testing.ini"
|
||||
MutWsInfoName="wsinfo_serverext.txt"
|
||||
MutWsInfo="$KFDoc/$MutWsInfoName"
|
||||
|
||||
ThirdPartyBin="$MutSource/3rd-party-bin"
|
||||
|
||||
export PATH="$PATH:$ThirdPartyBin"
|
||||
|
||||
if [[ $# -eq 0 ]]; then show_help; exit 0; fi
|
||||
case $1 in
|
||||
-h|--help ) show_help ; ;;
|
||||
-c|--compile ) compile ; ;;
|
||||
-b|--brew ) brew ; ;;
|
||||
-bu|--brew-unpublished ) brew_unpublished ; ;;
|
||||
-u|--upload ) upload ; ;;
|
||||
-t|--test ) game_test ; ;;
|
||||
* ) echo "Command not recognized: $1"; exit 1;;
|
||||
esac
|
31
test.cfg
Normal file
31
test.cfg
Normal file
@ -0,0 +1,31 @@
|
||||
# Test parameters
|
||||
|
||||
# Map:
|
||||
Map="KF-Outpost"
|
||||
|
||||
# Game:
|
||||
# Survival: KFGameContent.KFGameInfo_Survival
|
||||
# WeeklyOutbreak: KFGameContent.KFGameInfo_WeeklySurvival
|
||||
# Endless: KFGameContent.KFGameInfo_Endless
|
||||
# Objective: KFGameContent.KFGameInfo_Objective
|
||||
# Versus: KFGameContent.KFGameInfo_VersusSurvival
|
||||
Game="KFGameContent.KFGameInfo_Endless"
|
||||
|
||||
# Difficulty:
|
||||
# Normal: 0
|
||||
# Hard: 1
|
||||
# Suicide: 2
|
||||
# Hell: 3
|
||||
Difficulty="0"
|
||||
|
||||
# GameLength:
|
||||
# 4 waves: 0
|
||||
# 7 waves: 1
|
||||
# 10 waves: 2
|
||||
GameLength="2"
|
||||
|
||||
# Mutators
|
||||
Mutators="StartWave.StartWave"
|
||||
|
||||
# Additional parameters
|
||||
Args="Dosh=999?StartWave=7?bUseDebug=True"
|
1
tools
Submodule
1
tools
Submodule
Submodule tools added at 3d96a1e6c6
Reference in New Issue
Block a user