Skip to content

GenZmeY/KF2-SafeMutLoader

Repository files navigation

KF2-SafeMutLoader

Downloads MegaLinter GitHub tag (latest by date) GitHub

Description

Use non-whitelisted mutators and stay ranked.

Legal

SafeMutLoader is legal and does not violate the KF2 EULA. Here's why in detail: LEGAL.md.
However, for some reason SML is getting banned in the steam workshop, so use it at your own risk.

Usage (server only)

  1. Add SML to your server. There are two ways:
  • without workshop: download SML.u from releases and put it to KFGame/BrewedPC
  • with workshop: Use the instructions below to build the SML and upload it to your workshop, then subscribe your server to SML
  1. Add SML.Mut first to your list of mutators, example:
?Mutator=SML.Mut,FriendlyHUD.FriendlyHUDMutator,YAS.Mut,CTI.Mut,CVC.Mut,AAL.Mut

(add/remove compatible mutators you need)

⚠️ Doesn't work in single player
⚠️ SML must be first in the mutators list or it won't work.
⚠️ SML only has an effect when compatible mutators are used (the list below). If you use incompatible mutators you will lose ranked status.
⚠️ SML is a server-side mutator, clients never download it. Therefore, no one will know about you using SML if you don’t tell yourself (or if you share with the whole world the BrewedPC folder where you put the SML, lol).
⚠️ SML is incompatible with AccessPlus and other mods based on it. If you need something from there, implement it as an SML compatible mutator using developer guide.

Compatible mutators

🟢 Any whitelisted mutators
🟢 Admin Auto Login
🟢 AmmoMulti
🟢 Controlled Vote Collector
🟡 Custom Trader Inventory
Using UnlockDLC=ReplaceFilter will unrank the server when someone buys DLC weapons. Use UnlockDLC=ReplaceWeapons to get around this.
Since KF2 v1133 the content preload causes the server to unrank for some reason. Disable it in CTI settings (bPreloadContent=False) to stay ranked.
🟢 Discord Link [Edited]
🟢 FriendlyHUD
🟢 Looted Trader Inventory
🟡 StartWave
mutate startwave X command not working.
🟢 True Random Boss
🟢 Unofficial Killing Floor 2 Patch
🟢 WorkshopTool
🟢 Yet Another Scoreboard
🟡 Zed Spawner
Since KF2 v1133 zed preload causes the server to unrank for some reason. Disable it in ZedSpawner settings (bPreloadContentServer=False) to stay ranked.

Making SML-compatible mutators

See developer guide

Build & Upload

Note: If you want to build/test/brew/publish a mutator without git-bash and/or scripts, follow these instructions instead of what is described here.

  1. Install Killing Floor 2, Killing Floor 2 - SDK and git for windows;
  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-SafeMutLoader && cd KF2-SafeMutLoader
  4. Download dependencies:
    git submodule init && git submodule update
  5. Build and upload to steam workshop:
    ./tools/builder -cbu
  6. Find SafeMutLoader in your workshop and change Visibility to Unlisted so your server can download it (don't use Public visibility)

Contributing

If you make a mod compatible with SML I'll be happy to add it to the list of compatible mutators.
Contact me in any convenient way (for example, create an issue)

License

license