Mod Details

Mod Configurator

Mod Configurator 1.3.0

Created by  FallegaHQ

1.6K Downloads

SPT 3.11.4 Compatible

A desktop application that provides a user-friendly GUI for configuring SPT (backend) mods through UI-based interfaces instead of manually editing JSON files.

Latest Version 1.3.0
SPT 3.11.4

Updated Sep 11, 2:47 PM

Version Notes
This download is externally hosted.
Always scan for viruses.

SPT Mod Configurator

main.png

Key Features

  • Visual Configuration Editor: Edit mod settings through intuitive forms with validation
  • Automatic Mod Discovery: Scans and identifies compatible mods in your directory
  • Real-time Validation: Prevents configuration errors with instant feedback
  • Automatic Backups: Creates backups before saving changes for safety
  • Multiple Field Types: Supports text, numbers, sliders, dropdowns, colors, arrays, and nested objects

Important Notes

This configurator does NOT include pre-made configurations for existing mods. Out of respect for mod creators and their work, I have intentionally left it up to each modder to decide whether they want to support this configurator or not.

How You Can Help: If you find this tool useful, please let your favorite modders know about this project! Encourage them to add schema support to their mods so you can configure them through this GUI. I’m happy to help any modder create schemas for their configurations.

For Mod Creators

Adding support is simple - just include a config-schema.json file in your mod that describes your configuration structure. The schema defines form fields, validation rules, and help text for users. Contact me if you need assistance creating schemas for your mods.

Requirements

  • Compatible mods must include a config-schema.json file
  • Place the executable in your SPT installation directory
  • Works with JSON, JSONC, and JSON5 configuration files

Usage

  1. Place the executable in your SPT installation directory (same level as the user folder)
  2. Launch the application
  3. The app will automatically detect mods in the user/mods directory
  4. Select a mod and configuration file to edit
  5. Make your changes using the form interface
  6. Save your changes (backups are created automatically)

The configurator validates all changes against the mod’s schema to prevent configuration errors that could break your game.

Screenshots

Data types:

1.png

Arrays:

2.png

Validation:

3.png

Help grow the ecosystem by asking your favorite modders to add schema support!

Version 1.3.0
Download Mod Version
SPT 3.11.4
Latest Compatible SPT Version

1.6K Downloads

Created Sep 11, 2:47 PM

Updated Sep 11, 2:47 PM

Virus Total Results
FallegaHQ

I will (soon-ish) create as many default schemas as possible for existing mods and will release them gradually

Read this reply if you want to know why I didn’t include any default schemas

2 Likes
The_Kniper

doesn’t work, says failed to scan mod directory no matter where i put the exe

0 Likes

because you have no mods that have a config-schema.json file in it. it’s a requirement, as stated in the Overview

*edit: or you have no compatible mods

0 Likes

I will (soon-ish) create as many default schemas as possible for existing mods and will release them gradually

Read this reply if you want to know why I didn’t include any default schemas

1 Like
PH4NTOM

Bro I dont think modders would mind if you allow any mod to be compatible with this out of the box. If they already have given txt config then this mod will just provide more convenience for the users.

This has the potential to be one of the biggest mods on this website, but if large scale modders couldnt bother to provide compatibility, then I dont think it will reach that popularity.

Just saying.

3 Likes

I think the fact that it’s required for the modder to add anything extra solely to make this app detect their mod is more effort than most, if not all, of modders here are willing to put up with, especially given how fragile automatic mod installing/editing is with SPT. it’s extra work for little extra benefit, at least in my view. it’s a cool idea, but I don’t think it’s going to catch on

0 Likes

I can add a couple of mods, say 20ish? then what, am I to dedicate all my time (which is like everyone else’s time; limited) to creating config?
Also, some modders might not like the idea of someone else creating something that alters their mods without their consent as the values that would appear in the configurator would give false sense of “truth” to what is exported from the configurator. So, many users (who most likely would not know better) would be reporting “bad behaviour” to modders who didn’t even intend to have their mods configured that way.
More on the previous point, even I don’t know any better when it comes to most mods, as this mod includes things like maximus, minimus, descriptions, etc and if I give players a sense of security in my mod and then players who acted within that sense bombarded modders with bug reports, I’d feel bad

With all that aside,I will (soon-ish) create as many default schemas as possible for existing mods and will release them gradually

0 Likes

Oh sorry, I thought that this would be automatically compatible with activated mods if you allowed it to, my mistake.

0 Likes
boofaah

Hello, interesting mod and feels like it be of great help. Is there a way for me, not a mod author, to create a schema file to add support to the mods I have downloaded?

I tried downloading the mods you had in your screenshots but they couldn’t be found by the application either.

0 Likes
Yukinoling

What you are doing is just like what happened when NVIDIA’s first-GPU was released, when the CEO persuaded multiple game developers to help him optimize the games.

It’s very difficult,

0 Likes

A man with a dream; I guess

1 Like
swiftxp

Nice one!

1 Like

thanks

0 Likes
Funkypunky

“Failed to scan for mods” in the User/Mods folder… Any tips?
I added the file in the SPT install folder, as per the instructions.
Thank you!

1 Like

we probably have some “incompatible” mod causing issues ?

1 Like

Nope! this mod will look for compatible mods and will not work with incompatible ones

0 Likes

Well, I don’t know then, I’ll try with just one mod and test. Tried with just a few trader mods, same thing….it’s not the mods it’s something else

0 Likes
fack

“failed to scan for mods” (gives the mods folder location which is correct)

0 Likes

That’s because you don’t have any compatible mods
I am trying to reach out to some modders to ask them to support configurability theough this mod… Still, no responses (it’s been 3 hours since I published this, so, I didn’t expect any yet)

2 Likes
Asriel

Oh boy I can see this one is gonna get popular :>

1 Like

Not if modders dont know about this mod or dont bother.

It’s a mistake by this guy to think that modders would mind out of the box compatibility.

0 Likes
Devraccoon

I’m a bit curious when I see this. I read the requirements, and I have to wonder: what are your plans for when SPT 4.0 rolls around? SPT 4.0 will no longer support dynamically editing mods or their data, and mod order will be automated on compilation (*removal of order.json and package.json), which makes it sound like this tool will only work now and never again. At least for those who do not play older versions than 4.0 when it comes around.

0 Likes

I am still not sure how will that affect the configurability of the backend mods (didn’t read much into it ) but if there won’t be a consistent way to help “less-technical” players configure their mods, I will update this. For now, this will work with any version less than 4.0…
I’m interested in knowing more about what might change if you can give me some heads up, I don’t have that much free time now to keep up with the development of SPT itself, but will surely catch up when possible

0 Likes

sorry I took a while to reply. essentially, with SPT 4.0 releasing eventually, they’ve totally scrapped manual mod loading since server mods are going to be C# compiled, so mod loading will be done when the game is loading. you will no longer be able to just pop order.json into the mods folder and call it a day, and manual editing of mods will stop working too.

essentially server mods will go from plain text to compiled mods, much like BepInEx C# client mods.

0 Likes

that would suck for a lot of us

Thanks for letting me know

1 Like

Yikes, maybe I don’t understand the implications of this fully but that sounds terrible if we’ll no longer be able to edit/personalize mods for our builds. There’s a whole bunch of mods my buddy and I use, that we only use because I spent a ton of time editing them to fit what we were going for. I’d say a solid 85% or more of the mods I setup on our server & clients have been edited or customized in some way vs their vanilla settings.

I mean sh!t, a bunch would prob even straight up conflict with each other :/ Is it just going to be a “you get what you get” situation or will the “settings/tweaks” currently available via config or .json files become customizable in game similar to the F12 menu for editing BepInEx plugin’s settings?

0 Likes

Details