Subscribe to download
Sort To Tabs

A mod to automatically move items to specific tabs using rules defined by the user.

For example, weapons to the first tab, ammo on the second, armor on the third, etc.

Press F5 to apply the move rules for the items on that tab. Press S to invoke the game's normal sort.

The rules and hotkeys can be changed in the configuration file. See the Configuration section below.


Users that have used the mod before Quasimorph 0.8.5 Will have their rules reset due to config changes.
The previous config file will be backed up to %AppData%\..\LocalLow\Magnum Scriptum Ltd\Quasimorph_ModConfigs\QM_SortToTabs\QM_SortToTabs.json.upgrade-backup.


The default rules are:


If you enjoy my mods and want to buy me a coffee, check out my Ko-Fi[ko-fi.com] page.
Thanks!



The configuration file will be created on the first game run and can be found at %AppData%\..\LocalLow\Magnum Scriptum Ltd\Quasimorph_ModConfigs\QM_SortToTabs\QM_SortToTabs.json.

See the rules section below.


The refresh and sort keys can be found in the config file. Valid keys can be found at the bottom of https://docs.unity3d.com/ScriptReference/KeyCode.html


The rules search for a match from top to bottom. First match wins.
The rules have the following optional parts: Id (ex: army_knife), Type (ex: ArmorRecord), SubType (ex: QuestItem), and Category (Tezctlan). Any blank values will not be used to match an item.

Any item that does not have a matching rule will not be moved.

Most rules will only need a single value such as Type or Id.

A rule with all blank values will match every item. This should be put at the end of the rules.

The data for every item is exported to DataExport.csv. See the Data section below for more info.

Example rules:

Example Entry in the config file:


While items can have more than one category, the rule's Category property only supports one item.

Example from the DataExport.csv:

To match all Tezctlan and XiomaraMasks, there would need to be one rule for each. Using "Tezctlan XiomaraMasks" will not work.


The mod will export all of the items' info to %AppData%\..\LocalLow\Magnum Scriptum Ltd\Quasimorph_ModConfigs\QM_SortToTabs\DataExport.csv.

Example data from DataExport.csv:

The ItemName column is the item's name as displayed in the game, and is not use by the rules.
The Categories column contains one or more value and is separated by spaces.


If the ship a recycler and the recycler is not in use, the rules will treat the recycler as an eighth tab.

If a rule targets the eighth tab but the recycler is not available or in use, the rule will not move the item.
However, if the property AltTabNumber is set, that tab will be used as the target instead.

This allows a user to create a staging tab until the recycler is available. When the recycler is ready, running the sort on that tab will move the staged items to the recycler.

Example:


If the configuration has a loading issue (such as it being incorrectly formatted), the game will use the defaults.
There will be an error in the log player.log indicating this, but will not be obvious to users otherwise.

To recover, delete the config file and restart the game. A new config file with the defaults will be created.


To assist with debugging the rules while running the game, the mod will reload the configuration any time the file is saved.

The config optionDebugLogMatches can be enabled to log which rule matched the item. This will write every item and the rule that matched that item to the game's Player.log.

The game's log can be found here %AppData%\..\LocalLow\Magnum Scriptum Ltd\Quasimorph\Player.log

• Thanks to GitHub user WiliamRogers1886 for providing an interim 0.8.5 patch.

Source code is available on GitHub https://github.com/NBKRedSpy/QM_SortToTabs