=================================
INFO
=================================
Mod enabled dev console as well as acts as a siple BP modloader
Supports CME only mods as well.

PLEASE FOR THE LOVE OF THE GOD VIEW THE FILE AS "RAW"
DO NOT READ IT AS EMBBED ON NEXUS!


=================================
INSTALL
=================================
1. STEAM: Go to your Steam Library, find "STALKER 2", right-click, Manage -> Browse Local Files.
This is your game root folder.
2. Extract content of the zip-archive inside root folder. If you did everything correctly,
"Simple_ModLoader.*"
will be present inside "Stalker2\Content\Paks\".
3. Installation complete.


=================================
UNINSTALL
=================================
Delete aforementioned files


=================================
CONFLICTS
=================================
The mod already enables console so you dont need to install any console mods.
Other *OLD* BP mods might conflict.


=================================
GAME CRASHES AT STARTUP!!111!!!!
=================================
This is a super-rare bug I only got once. This happens with ANY PAK mods.
I have no idea what causes it but the best solution is:
1. Remove all mods temporarily
2. Start the game once until main menu
3. Start re-adding mods 1 by one.


=================================
USAGE
=================================

[~] or [`] or [/] to call console. See below how to change the key

Terms:
- scp :: soft-class path

Commands:

mod add path :: adds BP mod to auto load list and instantly spawn it if needed
mod del path_or_index :: removes mod from list and destroys instance
mod print * :: prints list currently saved mods
-
cme add path :: adds CME to auto load list and instantly spawns if needed
cme del path :: removes cme from extensions collection
mod print * :: prints list currently saved cmes
-
clearall :: removes all entries from aut-load DB
-
conset smallfontsize size :: sets console font size
-

Once a mod or cme is added, it will be auto-reloaded on save reload.
P.S. Other S2HOC specific console commands included in files


=================================
FAQ
=================================
- What is this ? -

Blueprint mod loader. It is not relevant for 99% of the mods
you may want to use. You can install it for console and/or as
a dependency for BP mods (like flashlight tweaker)


- How to change console key? -

a) Open or CREATE in Notepad
Steam: %LOCALAPPDATA%\Stalker2\Saved\Config\Windows\Input.ini
GamePass: %LOCALAPPDATA%\Stalker2\Saved\Config\WinGDK\Input.ini
b) Add to the very top section:

[/Script/Engine.InputSettings]
!ConsoleKeys=ClearArray
ConsoleKeys=RightBracket
ConsoleKeys=YourKey

c) Replace "RightBracket" with a key of your choice:
https://nerivec.github.io/old-ue4-wiki/pages/list-of-keygamepad-input-names.html


- How to block default TILDE console key? -

Launch the game with switch -notilde
(add in in shortcut properties on in Steam's launch options)


- How to add a mod? -

1. For end-users:
Simply read the mod's readme and find out what path mod uses as per
developer's description and then use command:
"mod add path" or "cme add path"

2. For developers:
Use "Copy reference" action (via UE right click menu on your blueprint asset in editor),
take the path inside the ' single quotes part, for example:
/Script/Engine.Blueprint'/Game/Mods/FLCustomizer/BP_MOD_FLCustomizer.BP_MOD_FLCustomizer'
and append "_C" to the end of it, turning it into final:
/Game/Mods/FLCustomizer/BP_MOD_FLCustomizer.BP_MOD_FLCustomizer_C
and finally, the command to add a mod:
mod add /Game/Mods/FLCustomizer/BP_MOD_FLCustomizer.BP_MOD_FLCustomizer_C
(no quotes of any kinds)

This is your "soft-class path". The "Mods/" folder is where I decided to put my
blueprint, yours can be anyhting. It always starts with "/Game/" (UE things).
You can name assets however you like, there is no convention.


=================================
GAMEPASS/GOG SPECIFIC FAQ
=================================
Gamepass is not supported and will never be properly supported.
That being said, there are *workarounds*.

WARNING: NO MODS WILL BE SPAWNED IN MAIN MENU FOR NOW BECAUSE OF GP JANK
They will be spawned in-game


-- I. I've installed ModLoader and all my saves are gone!!111 --

a) Open folder "%LOCALAPPDATA%\Packages\GSCGameWorld.S.T.A.L.K.E.R.2HeartofChernobyl_6fr1t1rwfarwt\SystemAppData\xgs\00090000044B432D_0000000000000000000000007782504A\SaveGames"
b) Copy savegames to "%LOCALAPPDATA%\Stalker2\Saved\SaveGames"
c) be happy

-- II. I've UNinstalled ModLoader and all my saves are gone again!!111 --

a) Open folder "%LOCALAPPDATA%\Stalker2\Saved\"
b) Copy savegames to "%LOCALAPPDATA%\Packages\GSCGameWorld.S.T.A.L.K.E.R.2HeartofChernobyl_6fr1t1rwfarwt\SystemAppData\xgs\00090000044B432D_0000000000000000000000007782504A\SaveGames"
c) be happy

-- III. I've installed ModLoader v0.0.4 or greater and now all my saves are gone AGAIN!!111 --

Starting from version 0.0.4, ModLoader has some internal fixes that attempt to address the I.
If you updated ModLoader and savegames that were there with old ModLoader are gone, do step II.


-- IV. ModLoader does not save mods I've added via "mod add" command! --

Same issue. Saving modlist wont work. You have to add it manually in config.
a) Open or create Engine.ini inside "%LOCALAPPDATA%\Stalker2\Saved\Config\WinGDK\"
b) Add following section:

[/Game/Mods/S2HOCBootstrap/UModData.UModData_C]
ModsToSpawn=

Now, instead of executing command
mod add /Some/Mod/Path/Mod.Mod_C

you add mod path line to the config, like this:

[/Game/Mods/S2HOCBootstrap/UModData.UModData_C]
ModsToSpawn=/Some/Mod/Path/Mod.Mod_C
ModsToSpawn=/Some/Mod2/Path/Mod2.Mod2_C

and now mods will autoload.


-- V. Why is this so jank!?!?!? --
You chose gamepass, not me.


=================================
KNOWN ISSUES
=================================
- no valid gamepass support, only workarounds


=================================
HOW TO REPORT ISSUES
=================================
- describe exact steps/what you did that lead to the bug
- provide screenshot of the "platform" command in console
- provide savegames before and after if possible (%LOCALAPPDATA%\Stalker2\Saved\)


=================================
CHANGELOG
=================================
- v0.0.8a - restored compatibility with older mods because people cant read
- v0.0.8 - some QoL fixes: block default console key, remove mod by index
- v0.0.7 - packaging fix -this should work better now
- v0.0.6 - some internal fixes
- v0.0.5 - a bit more drastic workarounds
- v0.0.4 - gamepass workarounds
- v0.0.3 - internal fixes
- v0.0.2 - readme clarificaion
- v0.0.1 - Initial release


=================================
CREDITS
=================================
KeinZantezuken