About this mod
Easily configure your Enshrouded dedicated server with this simple Python script. Edit settings, create backups, and revert to defaults, all without touching the JSON file directly. Includes automatic backup, and a "randomize" feature for the adventurous!
- Requirements
- Permissions and credits
- Changelogs
v2.4.5
What is it?
This powerful tool, designed to be placed directly in your Enshrouded server's JSON directory, offers a user-friendly GUI to modify various server settings. No more squinting at raw JSON; just clear tabs, easy-to-use controls, and a whole lot less stress!
What does it do?
We've listened to the chatter online and built this editor to tackle the common headaches server admins face:
- No More JSON Nightmares! Say goodbye to server startup failures due to a misplaced comma or a forgotten quote. Our GUI handles the tricky formatting, so you can focus on crafting your perfect server experience.
- Actually Understand Your Settings! Each setting comes with a clear label and a handy tooltip explaining what it does and its valid options or ranges. We even try to pull the latest defaults and version info from the game's own enshrouded_server_readme.txt
if you have it alongside the tool! - User Group Management Made Easy! Setting up different permission levels for Admins, Friends, and Guests? Our "Server Roles" tab lets you view, edit, add new groups, and delete existing ones without manually fiddling with the complex userGroups array. (And yes, we'll remind you to change those default passwords!)
- Master Your Game's Difficulty (The Smart Way)! Tweak individual game settings to your heart's content! If you change a specific game setting (like player health or enemy damage), the tool cleverly sets your gameSettingsPreset to "Custom" for you. And if you pick a non-Custom preset, we'll gently remind you that those individual tweaks might be overridden by the game.
- Safety First - Automatic Backups Galore! Worried about messing something up? Don't be! The tool automatically creates a timestamped backup of your enshrouded_server.json before any changes are saved. We also make backups before you revert to defaults or restore an older version.
- Oops! Undo Button? Almost! (Granular Restore)Made a change you regret? You can easily browse and restore a specific previous version of your settings from the automatically created backups.
- Time & Numbers Made Simple! Settings like Day/Night duration or Time to Starvation? Edit them in plain old minutes, not confusing nanoseconds! Factors like Player Health or Enemy Damage? Use percentages (e.g., 150% for 1.5x) – we do the math behind the scenes.
- Feeling Adventurous? Randomize It! Want a truly unique (and potentially chaotic) Enshrouded experience? Use the "Randomize Settings on This Tab" button for Player, World, Enemy, Resources, or Experience settings. We'll even give you a heads-up if the dice roll a particularly brutal-looking setup!
- Never Forget to Save! An asterisk (*) in the window title will remind you if you have unsaved changes, and we'll double-check with you before you close the app
Changelog:
- v1.0: Initial version. Basic menu, loading, saving, and editing of settings.
- v1.1: Added automatic backup functionality before modifying settings.
- v1.2: Added error handling for file not found and invalid JSON.
- v1.3: Improved input validation and added port number range check.
- v1.4: Added function to display all current settings.
- v1.5: Added ability to revert to default settings.
- v1.6: Added ability to fetch default settings from a remote URL.
- v1.7: Added randomization feature for world, enemy, and resource settings.
- v1.8: Improved error handling and added more setting descriptions.
- v1.9: Refactored code for better readability and maintainability. Fixed several minor bugs. Added better boolean input.
- v2.0: Added a "Revert to Most Recent Backup" function. Separated the "EXIT" option, and added a function to view the JSON, and reorganized menus.
- v2.1: Changed "View JSON" to display settings in plain English rather than raw JSON.
- v2.2: Enhanced User Group Management.
- v2.3: Bug Fixes and Improvements.
- v2.4.0: Initial Tkinter GUI Release
- First version of the GUI, porting core logic from the previous version (CLI tool).
- Included tabbed interface, settings display, basic input widgets.
- Integrated enshrouded_server_readme.txt parsing for defaults and game version.
- Implemented core save, load, backup, and revert-to-default functionalities.
- v2.4.1: Core GUI Functionality & Fixes
- Added "Granular Restore" feature to the main menu to restore specific backup files.
- Enhanced backup filenames to include a "reason" for the backup.
- Fixed NameError for get_setting_config_by_path function.
- Resolved TclError related to shared preset_override_label packing across multiple tabs.
- v2.4.3: Enhanced Input & Robustness
- Added nanosecond-to-minute conversion for "Time to Starvation" setting.
- Implemented choice-based (dropdown/selection) input for verbose string settings like "Tombstone Mode" and "Taming Startle Repercussions" (and others like Weather, Curse Mode etc.) to prevent typos.
- Improved handling of missing settings when populating the GUI.
- Made type conversion on saving settings more robust using description hints.
- Updated hardcoded fallback defaults to be more sensible.
- v2.4.5
- Implemented user-friendly percentage input/display for "Factor" settings (e.g., Player Health as 100% instead of 1.0).
- Enabled adding new user groups and deleting existing user groups from the "Server Roles" tab.
- Added "Randomize Settings on This Tab" button for Player, World, Enemy, Resources, and Experience tabs.
- Implemented a difficulty assessment heuristic with a warning pop-up for randomized settings.
- Integrated logic to automatically set gameSettingsPreset to "Custom" when individual game settings are modified.
- Added a visual warning label on relevant tabs when gameSettingsPreset is not "Custom".
- Implemented an unsaved changes indicator (* in window title) and a prompt on exit if changes are pending.
- Switched to manually defined, more concise tooltips for all settings for better clarity.
- Added a tooltip reminder for password fields in user groups to encourage changing defaults.
- Refined the "Structural Differences" warning message to be more informative and less alarming.
- Python Power: Make sure you have Python 3.x installed (don't worry, you don't need to install any extra fancy libraries – it's all built-in!).
- Download & Place: Grab the script and pop it into your Enshrouded dedicated server's main folder (where enshrouded_server.exe lives).
- The Magic Readme (Highly Recommended!): If you have the enshrouded_server_readme.txt that comes with the server files, put it in the same folder as our script. This helps the tool load the most up-to-date default settings and game version info. If it's not there, the tool will use its own built-in defaults.
- Run It! Open your command prompt or terminal in your server folder and type: python enshrouded_server_config.py (or just double click the script itself).
Navigate the tabs, tweak to your heart's content, hit "Save All Settings," and enjoy your customized Enshrouded world!
⚠️ A Friendly Note - This is a community-made tool, designed to help. Always, always keep your own manual backups of important server data before making big changes, just in case! The creator(s) of this tool are not responsible for any server hiccups. Play safe!
We hope this makes your life as an Enshrouded server admin a whole lot easier and more fun! Let us know what you think!