About this mod
Recategorises and condense vanilla basebuilding menu groups to make room for modded objects. The backbone of BuildFrame.
- Requirements
- Permissions and credits
- Mirrors
- Changelogs
- Donations
(Recategorisation and Trimming Utility for Build Menu)
is the backbone of

RecTUM - Recategorisation and Trimming Utility for Build Menu
SACS - Selection Augmentation for Colour System
Why make RecTUM?
Since the 3.7 update, the build menu has been revamped into a "tab and list" structure, there are 11 vanilla "top groups" at the time of writing.
Through some research, we discovered that the maximum number of top groups that can appear in the build menu is 19. Once the amount of internal top groups exceeds that number, they are either inaccessible to players in-game, or would cause instabilities, to the point of crashing the game when opening the build menu.

At the same time, each top group has a display size limit of around 24 rows of objects, with the limit decreasing with more subgroups taking room by opening with a new row. We've also found the maximum functional limit of objects per top group is 240. Once again, exceeding that limit will cause instabilities, including inaccessible objects, the build menu UI bugging out visually, booting players out of selected top groups, or crashes.
With the vanilla groups untouched, the absolute maximum number of modded base objects would be 240*8=1920 objects. With current basebuilding mods, we are already past 2000 objects, and thus necessitates a change in the vanilla groups to make room for modded objects in order to maintain compatibility, stability of the mods, and various quality-of-life features such as distinct categorisation, proper headers, etc.
RecTUM condenses the vanilla categories into 5 top groups. This means 6 vanilla top groups are hidden from the build menu, and the total free space for new top groups is now 14. This creates a space for mods that add new base objects to expand more freely, without the fear of crashing the game.

Installation
RecTUM is not meant to be used standalone, even though it can be; it is intended to be used in conjunction with one and more basebuilding mods that add additional objects to the build menu.
Because of this, RecTUM is designed to be used as an AMUMSS .lua script, to be used along with any .paks or .luas that other basebuilding mods provide.
Click here to go to AMUMSS's Nexus mod page.
When used alone, the output .pak name will be "~~~RecTUM.pak"; when used in conjunction with other luas, the .pak name will be "~~~~BuildFrame_Comp.pak" (or whatever the last lua that dictates the MOD_BATCHNAME to be)
Compatibility
RecTUM is designed to be processed first in AMUMSS, before any other script. The intention is that the vanilla groups be reduced before any other tweak is done, although it is not essential.
Because it is processed before any other script, RecTUM edits only the vanilla base object entries (specifically, which group they belong to) and adds new "sub-groups" into existing vanilla top groups.
Because the reduced sub-groups are not removed, only hidden, mods adding objects to said vanilla groups will still show the objects under their intended vanilla groups.
Any modders who ultilises AMUMSS lua scripts and want their base objects added to vanilla groups moved by RecTUM should name their lua script with 7 (seven) plus signs (+) at the beginning of the file name. For more information, feel free to join the modding discord and discuss with us further.
Files edited
METADATA\REALITY\TABLES\BASEBUILDINGOBJECTSTABLE.MBIN
UI\BASEPARTSMENU.MBIN