File information
Created by
WinderTP and Babscoole and WbertoUploaded by
WinderTPVirus scan
About this mod
Combines all vanilla basebuilding colour palette groups into one, and adds all new extra colour palettes. Part of BuildFrame
- Requirements
- Permissions and credits
- Mirrors
- Changelogs
- Donations
(Selection Augmentation for Colour System)
is a part of
RecTUM - Recategorisation and Trimming Utility for Build Menu
SACS - Selection Augmentation for Colour System
Why make SACS?
The idea first came from Reddit user Runaway_Angel, who asked for a way to customise and possibly expand the basebuilding colour palettes.
After investigation, it was discovered that the game utilises a "palette group" system, in which every base object selects a group of selected palettes. That means no object will be able to use the entire range of base palettes. At the same time, experimentation reveals the number of maximum colour palettes is 128 with a "default" palette in the code, the practical limit is 127.
SACS remedies the first issue by forcing every object into the "LEGACY" palette group, and putting every palette from other groups into the LEGACY group, practically making every colour palette available to use with every base object (that allows colourisation).
SACS also adds additional colour palettes of its own. Without overwriting the existing 66 vanilla palettes, the number of possible additional palettes is 61.
Pre 3.95 information:
SACS remedies the first issue by forcing every object into the "LEGACY" palette group, and putting every palette from other groups into the LEGACY group, practically making every colour palette available to use with every base object (that allows colourisation).
SACS also adds additional colour palettes of its own. Without overwriting the existing 51 vanilla palettes, the number of possible additional palettes is 13.
Using SACS in its default configuration will expand the colour palette selection UI considerably. It will also add 54 new custom colour palettes for the user to choose from. The user will then be able to add a further 7 palettes of their choosing if they wish to.
If the user was using SACS before NMS 3.95 Endurance Update and want to retain their object colours and colour palette, setting USE_LEGACY_PALETTE_LIST to true will wedge 13 colour palettes between vanilla "LEGACY" palette group and rest of the vanilla palette groups.
If the user wishes to create their own colour palettes, they can copy the example code block, edit the colours (in hex colour), name and ID to create a new palette.
Installation
SACS can be used standalone, although it is designed to be used with other BuildFrame modules and modded objects; 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, SACS is designed to be used as an AMUMSS .lua script, to be used along with any .paks or .luas that other basebuilding mods provide.
When used alone, the output .pak name will be "~~~SACS.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
SACS is designed to be processed last in AMUMSS, after any other script. The intention is that all added base objects will be made to use the combined colour palette group after the objects are added, although it is not essential.
Due to the way base objects save their colour palette (index-based rather than ID-based), SACS will reset the Stone/Fiberglass/Timber colours from their natural palettes upon installation.
We also do not recommend using SACS with other basebuilding colour palette mods unless you're OK with your base objects changing colours drastically every time you combine multiple mods becasue of this.
Any modders who ultilises AMUMSS lua scripts and want their base objects to use any other palette groups than LEGACY should name their lua script with 5 (five) tilde signs (~) at the beginning of the file name. For more information, feel free to join the modding discord and discuss with us further.
Edits
METADATA\REALITY\TABLES\BASEBUILDINGOBJECTSTABLE.MBIN
UI\BUILDCUSTOMISE.MBIN
UI\COMPONENTS\BUILDCOLOUR.MBIN
Special Thanks to Wberto for making changes to the AMUMSS script and increasing the efficiency in its processing