Mods App
Convenient preferences management for Schedule I mods.
Note: This mod requires Bars' fork of S1API (>=v3.0.1). You can get it on GitHub, Thunderstore or NexusMods.
Features
- New "Mods" app in the phone for easy access
- See all loaded mods, including their name, version, author, compatibility status (S1API/Mono/IL2CPP) and if they're enabled or not
- Powerful Search capabilities
- Search mods by name or author
- Search through all preferences using their names or descriptions (appearing in a separate "All Mods" section)
- Fuzzy search for better results even with typos or partial matches
- Comprehensive preference management:
- Support for multiple data types (boolean, integer, enum, vector3, string, float, keycode, color, lists, dictionaries)
- Organized categories for better preference organization
- Real-time editing with type-appropriate input controls
- Apply/Reset functionality for easy preference management
- Reset to Default option for individual entries to quickly revert changes
- Smart heuristics to automatically match preferences and configurations to their respective mods
- JSON configuration support for mods without MelonPreferences
- Manual JSON file path specification and live editing
- Clean, intuitive interface
- Text size scaling options for accessibility
- Collapsible categories for better organization
- Theme presets and custom theming options for personalization
- Mod changelog/readme viewer for easy access to information
- Dependency tracking to see which mods require others to function properly
- In-app log explorer to view mod logs and errors without leaving the app
- Issues are visible at-a-glance with a notification badge on the app icon
- Open source (MIT License)
Important Notes
Preference Changes: When you modify preferences through this app, other mods may not immediately reflect the changes. The app will remind you when a restart might be necessary for changes to take effect. This depends on how individual mods handle preference updates.
If you're a mod developer, check out the preferences guide.
Enabling/Disabling Mods: This app supports enabling or disabling mods from version 1.2.2. The restart is required for the change to apply. Still, I'd recommend using a dedicated, mod platform aware mod manager, like Schedule I Mod Manager (SIMM), r2modman, Gale or Vortex just to name a few. They can handle loading/unloading mods, updates and some even have mod profile support.
Backup Your Configs: Always back up your configuration files before making changes. While the app is designed to be safe, unexpected issues can arise.
Screenshots
Select different themes:
Preferences Types Supported
MelonPreferences
- Boolean - toggle switch
- Integer/Float - number input, with optional slider if the entry uses a Validator with a specified range
- String - text input
- Enum - dropdown
- Color - color wheel picker
- KeyCode - key binding input
- Vector3/other float structs - three number inputs
- Lists - list editor that allows adding/removing/reordering/editing items in the list. Supports both simple types and complex types (some may use fallback handler instead of dedicated one).
- Dictionaries - dictionary editor similar to the list editor that allows adding/removing/editing key-value pairs.
There's also a fallback for unsupported types (like custom classes or structs) that is a text input. It may not work properly for all types.
JSON
Fallback to JSON configuration for mods that don't use MelonPreferences.
You can specify the path in the appropriate field. It's relative to UserData.
If the file exists and is a valid JSON, you can edit it directly in the app.
Changes are applied to the file on save (if valid JSON).
Installation
- Install MelonLoader
- Install Bars' fork of S1API (>=v3.0.1).
- Extract the zip file
- Place the dll file into the
Mods directory
- Launch the game
Credits
- Bars for forking S1API, continuing its development and providing support. Also for helping with making this mod compatible with IL2CPP.
- All the open source projects that made this possible (MelonLoader, S1API and many more).
- Original wrench icon from FontAwesome
- Original warning, scroll, maximize and undo icon from Lucide, ISC License
