0 of 0
About this mod
Experimental Mod Loader for Enshrouded. Allows easy management and integration of mods for Enshrouded Game and Server. Features Mod Management, Live Configuration and Dependency Injection. Drag & Drop Installation. Comes with all legacy shroudtopia features as mods.
- Permissions and credits
- Mirrors
- Donations
Modloader for Enshrouded (Server & Client)
-606779-blue){kind=icon}
I'm excited to introduce Shroudtopia, a modloader that allows easy management and integration of mods for Enshrouded. With Shroudtopia, you can dynamically load, activate, and deactivate mods without restarting, giving you the ultimate flexibility to enhance gameplay.
Modloader Features
- Mod Management: Dynamically load and unload mods from the "mods" folder.
- Live Configuration: Modify mod settings at runtime without restarting the server.
- Dependency Injection: Each mod is fully integrated into the system via the ModContext, enabling shared access to configuration, logging, and other utilities.
Installation
1. Download Mod Loader: Get the latest Shroudtopia binaries from the release section.
2. Setup: Extract the files into your Enshrouded game or dedicated server folder.
3. Download Example Mods: Get the latest example mods from the release section.
4. Mods Folder: Create a
mods folder if it doesn’t exist and place your mod DLLs inside.5. Launch: Start the server. A default config is generated if
shroudtopia.json is absent.On servers: If Shroudtopia is loaded correctly, you should see something like this in the server console:
[shroudtopia][INFO] Config loaded.
[shroudtopia][INFO] Waiting for injection. Configured boot delay is 3000ms.
Upon the first launch, a default configuration file (shroudtopia.json) is created. All mods are deactivated by default, so you must manually activate them by adjusting the configuration.
Configuration
Each mod can be enabled or customized via the
shroudtopia.json config file. Here’s an example configuration:
{
"active": true,
"bootDelay": 3000,
"enableLogging": true,
"logLevel": "INFO",
"mods": {
"basics": {
"active": true,
"no_stamina_loss": true,
"no_fall_damage": true,
"inf_item_use": true
},
"Flight Mod": {
"active": true
}
},
"updateDelay": 500
}
To enable or disable specific features for a mod:
"basics": {
"active": true,
"no_stamina_loss": true,
"no_fall_damage": false,
"inf_item_use": true
}
Example Mods
- Flight Mod: Enjoy full flight capabilities with the glider. No more losing height!
- First Person View: Play Enshrouded from another perspective. Example for client-only mod. Note: This mod has not been updated since a few game versions and is untested!
- Basics Mod: Flight Mod is no fun with fall damage. All other legacy Shroudtopia features have been put into this mod. You can selectively activate them in the configuration file.
Creating Mods
Mods for Shroudtopia are written as dynamic libraries (DLLs) and need to include
shroudtopia.h from ./shroudtopia/.They must implement the Mod interface and provide the factory function:
extern "C" __declspec(dllexport) Mod* CreateModInstance() {
return new BasicsMod();
}
Mod Interface
Every mod must implement the following functions to integrate with the modloader:
class Mod {
public:
virtual ~Mod() {}
virtual ModMetaData GetMetaData() = 0;
virtual void Load(ModContext* modContext) = 0;
virtual void Unload(ModContext* modContext) = 0;
virtual void Activate(ModContext* modContext) = 0;
virtual void Deactivate(ModContext* modContext) = 0;
virtual void Update(ModContext* modContext) = 0;
};
ModMetaData contains essential information about the mod:
struct ModMetaData {
std::string name;
std::string description;
std::string version;
std::string author;
std::string targetShroudtopiaVersion;
bool hasClientSupport;
bool hasServerSupport;
};
Contributing
Currently, no game-specific functions are implemented in the ModContext. This is a first try. Contributions are welcome! Fork the repository, add improvements, and submit pull requests. I would be happy to see more mods for this around.
License
This project is licensed under the MIT License.
Let’s make Enshrouded even more exciting with Shroudtopia! 🌟
Special thanks to the following folks. Their work gave me a headstart implementing most features:
- cfe
- Turk
- Atamg
- ndoa