All entries go in GameUserSettings.ini under the header [AnyColourSets].


If anything is still unclear, feel free to ask and I'll help out! :)
Example config can be found at the bottom

No existing dinos will be affected- you will need to perform a dinowipe with Admincheat DestroyWildDinos for the coloured dinos to spawn.

Values listed in this section are the defaults.

If a dino receives a set applied with this mod, it will override any vanilla event set it has been set to receive- As such, particularly if you have high chances of custom sets, use mod's activeevent config to ensure that dinos will still receive event sets.

Not all vanilla/mod’s coloursets will have colours in every region, so use those sets with the knowledge that they may not properly affect all dinos!

You can use all four methods of setting colour sets (events, custom global, biome, and dino specific) together, and dinos will be able to receive all of them- alongside their normal colour set, if no custom set ends up being applied. Consider UseAllSets a custom global set- either UseAllSets=True or GlobalColourSets= can be used, but not both at once.

Outside of the full BP paths, the INI code for all dinos and coloursets MUST have an _C on the end of them for the code to work. For example, the custom Dawn colourset MUST be written as DinoColorSet_ACSDawn_C. Just the filename, DinoColorSet_ACSDawn, will not work.


---------------------------------------------------------------------------------------


GENERAL + GLOBAL


ColoursetBPPaths
Any coloursets which are not part of this mod or vanilla must have their BP paths added to this to be used. Separate all entries with a comma. Example,
ColoursetBPPaths=Blueprint'/Game/Mods/AnyColourSets/CustomColourSets/DinoColorSet_ACSBioLumAberrant.DinoColorSet_ACSBioLumAberrant',Blueprint'/Game/Mods/AnyColourSets/CustomColourSets/DinoColorSet_ACSCosmic.DinoColorSet_ACSCosmic',Blueprint'/Game/Mods/AnyColourSets/CustomColourSets/DinoColorSet_ACSDawn.DinoColorSet_ACSDawn'

UseArkEvents=False
True allows the mod to read the activeevent= parameter and activate the appropriate event set for all dinos. Since sets applied with this mod override event sets if applied, you may need to use this to have event coloured dinos, particualrly if you have a high chance of custom sets. May need a % chance set in ArkEventChance to work.

ArkEventChance=
Allows setting the chance of a dino receiving the global event colourset. Uses a number between 0.01-100, and is a % chance of the set being applied. If UseArkEvents=True, you may need a manually set value for this.

UseCustomGlobalSets=True
True allows setting custom coloursets for all dinos to use, like Ark’s events do.

UseAllSets=False
Requires UseCustomGlobalSets to be enabled. Allows the global colour set to use every colour set that the mod has been set to use. This includes every dino’s specific sets, (Rexes, wyverns, etc), not just event and this mod’s custom sets. If UseAllSets is false, the global colours will choose only from the contents of GlobalColourSets.

GlobalColourSets=
Sets which specific coloursets all dinos should have a chance to spawn with. Classname (eg DinoColorSet_ACSDawn_C) only, multiple entries. All entries are separated with a comma, and do not put spaces before or after each comma. Any sets that are not part of ACS or vanilla must be added to ColoursetBPPaths. There is a discussion post linked under the intro with the classnames and BP paths of all vanilla and ACS sets. If not provided by the author, the sets of other mods can be found by searching the mod files.

CustomGlobalColourSetChance=
The chance for a dino to receive one of the custom global coloursets. Uses a number between 0.01-100, and is a % chance of the set being applied. If UseCustomGlobalSets is enabled, this MUST have a value set for it.

UseGlobalExcludeClasses=False
True allows setting a list of dinos to not receive any global coloursets. Class-specific colours will still work on these dinos.

GlobalExcludeClasses=
When UseGlobalExcludeClasses=true, sets which dinos should not use Global coloursets. Classname (eg raptor_character_bp_c) only, multiple entries. All entries should be separated with a comma, and do not put spaces before or after each comma. Example,
UseGlobalExcludeClasses=true
GlobalExcludeClasses=Baryonyx_Character_BP_C,Toad_Character_BP_C,Doed_Character_BP_C
Will prevent Baryonyx, Doeds and Beelzebufo from having the global colour set applied to them

UseSpecificGlobalChances=False
SpecificGlobalChancesDinos=
SpecificGlobalChances=
When UseSpecificGlobalChances=True, allows setting a separate chance for receiving the global colour set to the chance specified in CustomGlobalColourSetChance, for a specific dino class. Works similarly to class-specific colours, where a dino that is in the first position in SpecificGlobalChancesDinos= will use the first entry in SpecificGlobalChances= as it's specific global chance, the third dino the third number, etc.

SpecificGlobalChancesDinos is classname (eg raptor_character_bp_c) only, multiple entries. All entries should be separated with a comma, and do not put spaces before or after each comma.
SpecificGlobalChances is a number 0.01-100
Example,
UseSpecificGlobalChances=True
SpecificGlobalChancesDinos=Achatina_Character_BP_C,Allo_Character_BP_C,Ankylo_Character_BP_C,
SpecificGlobalChances=60,20,80

Will give the Achatina a 60% chance of spawning with a global set, the Allo 20%, and the Anky 80%

SetAppliedOrder=0
Can be set to 0 or 1. Allows setting which method of set application can be overriden by the other. 0 allows sets applied with DinosToUseCustomSets to be overridden by the application of GlobalColourSets, and 1, vice versa. Custom activeevent colours will always be allowed to override. Currently, Biome set application will always be allowed to be overriden- this will be changed in a future update

DisableSetOverrides=False
True prevents the second method of application (either DinosToUseCustomSets or GlobalColourSets, depending on the value set in SetAppliedOrder), from attempting to add it's colourset if the dino has already received a custom set. Currently, Biome set application will always be allowed to be overriden- this will be changed in a future update

ModColourSetsToUse=
Same thing as ColoursetBPPaths, retained only for compatibility with older INI

---------------------------------------------------------------------------------------


CLASS-SPECIFIC


Place the colour sets, and chance for the coloursets, in the same position in the respective list as the dinos for it to apply to. For example, if a raptor is listed 5th in DinosToUseCustomSets, the colour sets and chance for those sets set to be applied must be listed 5th in ColourSetsToUse and ChanceOfColourSet.

When using multiple entries of the same dino in DinosToUseCustomSets, ChanceOfColourSet will be determined based off the first instances of the dinos only (so if you have raptor,raptor,raptor,achatina,rex, then the first entry in ChanceOfColourSet will be for the raptor, the second for the achatina, the third for the rex).

All entries in each list are separated with a comma, and do not put spaces before or after each comma.

ColourSetsToUse=
Uses the colour set's classname (eg DinoColorSet_Achatina_C). There is a discussion post linked under the intro with all the classnames of both vanilla and this mod's sets. Any sets that are not part of ACS or vanilla must be added to ColoursetBPPaths to be used.

DinosToUseCustomSets=
Uses the dino's classname (eg Raptor_Character_BP_C). You can have multiple entries with the same classname. Works on modded dinos.

ChanceOfColourSet=
Uses a number between 0.01-100, and is a % chance of the set being applied.

ExtraEntriesToCheck=0
Note that the higher this value is, the more performance heavy it will be. ExtraEntriesToCheck dictates how many entries in DinosToUseCustomSets, after the first instance of the dino that spawns will be checked for other occurrences of that dino. So if ExtraEntiresToCheck=4, after the first instance of the dino, the following 4 entries will be checked for that dino appearing again. Any entries more than 4 from the first instance of the dino will be ignored. For example, if you have 3 entries for raptors, then 4 for achatina, then another 2 for raptors, only the first 3 sets for raptors will be included. So, it's best to place all entries for the same dino next to each other.


---------------------------------------------------------------------------------------


SPAWNER AND SPAWN ENTRY SPECIFIC


Note that you can unfortunately only have one colourset to applied to any given spawn *entry* due to vanilla limitations, however you can have multiple spawn entries in one container for different creatures which all get different colours (for example, you can't make 'Rex 1' use both the Cosmic and Warlock sets, but you can have 2 entries, Rex 1 Warlock and Rex 1 Cosmic, to use both sets on rexes spawning in that location). These will also always be overridden by the Global/Biome Specific/Class Specific sets.

EnableSpawnerColourSets=False
When True, controls whether the spawner specific coloursets are used or not


SpawnersToCheckForEntries=
This config exists for performance reasons: The mod will only check containers listed in this config to apply the spawner coloursets to (it has no affect on global/class-specific/Gen1 Biome sets). You MUST ENTER SPAWNERS IN HERE FOR CONFIG SETS TO WORK ON THEM. See the discussion page https://steamcommunity.com/workshop/filedetails/discussion/2302876995/3827551164378918187/
for a list of all vanilla spawner BP paths. For modmap spawners you will need to look at mod documentation or files.


Example input:
SpawnersToCheckForEntries=/Game/PrimalEarth/CoreBlueprints/Spawners/DinoSpawnEntriesMountain.DinoSpawnEntriesMountain,/Game/PrimalEarth/CoreBlueprints/Spawners/DinoSpawnEntriesSnow.DinoSpawnEntriesSnow,/Game/PrimalEarth/CoreBlueprints/Spawners/DinoSpawnEntriesSwamp.DinoSpawnEntriesSwamp,/Game/PrimalEarth/CoreBlueprints/Spawners/DinoSpawnEntriesBeach.DinoSpawnEntriesBeach,/Game/PrimalEarth/CoreBlueprints/Spawners/DinoSpawnEntriesRedwoods.DinoSpawnEntriesRedwoods


SpawnerColourSets=
Will make the mod apply a colourset to all creatures within a given spawner. This is overriden by the entry name specific config

Example Input
SpawnerColourSets=DinoSpawnEntriesBeach_C:DinoColorSet_ACSWarlock_C,DinoSpawnEntriesSnow_C:DinoColorSet_ACSBioLumAberrant_C
Format: SpawnContainerClassname:ColoursetClassname,SpawnContainerClassname:ColoursetClassname
Separate the container and the colourset to apply to it with :
Separate each set of container and colourset with ,


EntryNameColourSets=
Will apply this colourset to every entry matching this entry name. Works on basegame spawns, modded spawns, and INI spawns, where you can choose the name for the most flexibility. Note the actual contents of the name only matter as much as what you tell the mod to look for. For example, an entry called 'Shark Ocean' will NOT automatically recieve the DinoColorSet_ACSDeepOcean_C colourset, unless you specify in the mod INI, Shark Ocean;DinoColorSet_ACSDeepOcean_C

You can find the entry names vanilla uses here:
https://ark.wiki.gg/wiki/Data_maps#Creature_Spawn_Maps
https://raw.githubusercontent.com/arkutils/Obelisk/master/data/wiki/spawn_groups.json

I am working on documenting the entry names in my mods (Extra Aberrant Variants, Cross-Genesis 1 and 2, Lost Island and Fjordur dinos eveywhere, etc), I may make the names more distinct for greater control if there is demand for it, but since there would be hundreds of entries to update, I will see if there is interest for that first.

For INI, AnEntryName is the option that the mod checks. For example, to make argents in a given area spawn with the Dunes colourset, AnEntryName="Argent 1-2 Desert", and then setting in the mod INI EntryNameColourSets=Argent 1-2 Desert;DinoColorSet_ACSDunes_C

Spawn Entry names for other mods may also be found on Obelisk in the mod's folder: https://github.com/arkutils/Obelisk/tree/master/data/wiki


Example input:
EntryNameColourSets=Ankylo (1-3);DinoColorSet_ACSFiery_C*Snow Rex;DinoColorSet_ACSGlacial_C*CG: Shadowmane 1-3;DinoColorSet_ACSCosmic_C
Format: SpawnEntryName;ColoursetClassname*SpawnEntryName;ColoursetClassname
Separate the container and the colourset to apply to it with ;
Separate each set of container and colourset with *
Note the unconventional splitters for this config- this is to reduce the potential overlap with spawn entry names. : and , are much more likely to be used in a name than ; and *, because entry names that *do* have the splitter characters in them will mess up the way the mod reads the config and cannot be used.


---------------------------------------------------------------------------------------


BIOME-SPECIFIC


By default, when enabled with UseBiomeSets=True, the biome sets will apply to everything in the biome. You can configure them to either apply to everything but X classes, or apply to only X classes, with ExcludeClasses and ApplyToOnly respectively. Event, global and class-specific sets will override biome sets if applied
ExcludeClasses will take priority over ApplyToOnly- if both are enabled, only ExcludeClasses will be used.
Both work like the ExcludeClasses for the global config- Array of classnames to exclude or include (Eg LunarExcludeClasses=Raptor_Character_BP_C,Argent_Character_BP_C)
BiomeSetsGenesisOnly is so that if colours start appearing on other maps, you can lock it to only Gen1.
Biomesuseallsets + AllSetsBiomes are to use all sets for the specified biomes. AllSetsBiomes works the same as BiomesToUseSets- add the biome name- Bog,Lunar,Arctic,Ocean,Volcanic- for that biome to use all sets. (Eg AllSetsBiomes=Bog,Lunar,Arctic,Ocean,Volcanic will have all biomes use all sets) Obeys ExcludeClasses, ApplyToOnly and BiomesToUseSets. Uses the same per-biome chances as set in set chances. If set, this will be used instead of the manually set biome coloursets.
BiomesToUseSets is an array of biome names- Bog,Lunar,Arctic,Ocean,Volcanic. Add the biome name to have it colour dinos. (Eg BiomesToUseSets=Bog,Lunar,Arctic,Ocean,Volcanic will enable biome colours in all biomes)
BiomeSetChances are a float array- 5 values, one used for each biome. In order, Bog, Lunar, Arctic, Ocean, Volcanic. Ie 50,40,30,80, will give bog a 50% chance, lunar a 40% chance, etc. If you want to, say, not have anything for Arctic, but use everything else, you still need to include 5 numbers. Disable biomes with the BiomesToUseSets option.
[Biome]ColourSets is an array of colourset classnames for that biome to use (Eg LunarColourSets=DinoColorSet_ACSDawn_C,DinoColorSet_ACSSnowy_C)


UseBiomeSets=False
BiomeSetsGenesisOnly=False
UseBiomeExcludeClasses=False
UseBiomeApplyToOnly=False
BiomesUseAllSets=False

BiomeSetChances=
BiomesToUseSets=
AllSetsBiomes=

BogColourSets=
ArcticColourSets=
LunarColourSets=
VolcanicColourSets=
OceanColourSets=

BogExcludeClasses=
ArcticExcludeClasses=
LunarExcludeClasses=
VolcanicExcludeClasses=
OceanExcludeClasses=

BogApplyToOnly=
ArcticApplyToOnly=
LunarApplyToOnly=
VolcanicApplyToOnly=
OceanApplyToOnly=

---------------------------------------------------------------------------------------

Config for all dinos to have a 50% chance to receive any of this mod’s custom coloursets.

[AnyColourSets]
UseCustomGlobalSets=True
CustomGlobalColourSetChance=50
GlobalColourSets=DinoColorSet_ACSSnowy_C,DinoColorSet_ACSGlacial_C,DinoColorSet_ACSNight_C,DinoColorSet_ACSDawn_C,DinoColorSet_ACSDusk_C,DinoColorSet_ACSEvening_C,DinoColorSet_ACSVolcanic_C,DinoColorSet_ACSMolten_C,DinoColorSet_ACSDunes_C,DinoColorSet_ACSBarren_C,DinoColorSet_ACSNeon_C,DinoColorSet_ACSForest_C,DinoColorSet_ACSEarthy_C,DinoColorSet_ACSMarsh_C,DinoColorSet_ACSAquatic_C,DinoColorSet_ACSDeepOcean_C,DinoColorSet_ACSShallowWater_C,DinoColorSet_ACSBeach_C,DinoColorSet_ACSCosmic_C,DinoColorSet_ACSFiery_C,DinoColorSet_ACSWarlock_C,DinoColorSet_ACSFertileAberrant_C,DinoColorSet_ACSBioLumAberrant_C,DinoColorSet_ACSMoltenElementAberrant_C,DinoColorSet_ACSDesert_C,DinoColorSet_ACSMoonlight_C,DinoColorSet_ACSAsh_C,DinoColorSet_ACSExtChronicles_C,DinoColorSet_ACSVibrant_C,DinoColorSet_ACSSurfaceAberrant_C


Config for all dinos to have a 50% chance of receiving any event set, except achatinas, allos and ankys which have a 60, 20, and 80% chance respectively, and rexes, baryonyxes, beelzebufo and doeds, which will not receive a event set at all.

[AnyColourSets]
UseCustomGlobalSets=True
GlobalColourSets=DinoColorSet_Arkaeology_C,DinoColorSet_Christmas_C,DinoColorSet_Easter_C,DinoColorSet_ExtinctionChronicles_C,DinoColorSet_FearEvolved_C,DinoColorSet_Summer_C,DinoColorSet_Thanksgiving_C,DinoColorSet_Valentines_C
CustomGlobalColourSetChance=50
UseSpecificGlobalChances=True
SpecificGlobalChancesDinos=Achatina_Character_BP_C,Allo_Character_BP_C,Ankylo_Character_BP_C,
SpecificGlobalChances=60,20,80
UseGlobalExcludeClasses=true
GlobalExcludeClasses=Baryonyx_Character_BP_C,Toad_Character_BP_C,Doed_Character_BP_C,Rex_Character_bp_c


Config for all dinos to have a 50% chance to receive any colourset in ACS, any modded sets that have been added to ColoursetBPPaths, and vanilla, (including sets for specific dinos which may not have colours in every region, so some sets applied will not work properly on all dinos.) This also includes coloursets like dodos, parasaurs, etc, so vibrantly coloured dinos will still be fairly rare with this config

[AnyColourSets]
UseAllSets=True
UseCustomGlobalSets=True
CustomGlobalColourSetChance=50


Example config where the Raptor receives the Alpha Fire Wyvern colourset at a 50% chance, the Moschops receives the custom Aquatic colourset at 80% chance, the Achatina receives the Extinction Chronicles set at 10% chance, and the rex receives the randomcolours colour set from 'example mod' at 40% chance.

[AnyColourSets]
DinosToUseCustomSets=Raptor_Character_BP_C,Moschops_Character_BP_C,Achatina_Character_BP_C,Rex_Character_bp_c
ColourSetsToUse=SE_DinoColorSet_MegaWyvern_Fire_C,DinoColorSet_ACSAquatic_C,DinoColorSet_ExtinctionChronicles,DinoColorSet_RandomColours_C
ChanceOfColourSet=50,80,10,40
ColoursetBPPaths=Blueprint'/Game/Mods/ExampleMod/Colours/DinoColorSet_RandomColours.DinoColorSet_RandomColours'



Example config where the Raptor receives the Alpha Fire Wyvern, custom Volcanic, or custom Dusk, colourset at a 50% chance, the Moschops receives the custom Aquatic colourset at 80% chance, the Achatina receives the Extinction Chronicles or custom Vibrant set at 10% chance, and the rex recieves the randomcolours set from 'example mod' at 40% chance.

[AnyColourSets]
ExtraEntriesToCheck=3
DinosToUseCustomSets=Raptor_Character_BP_C,Raptor_Character_BP_C,Raptor_Character_BP_C,Moschops_Character_BP_C,Achatina_Character_BP_C,Achatina_Character_BP_C,Rex_Character_bp_c
ColourSetsToUse=SE_DinoColorSet_MegaWyvern_Fire_C,DinoColorSet_ACSVolcanic_C,DinoColorSet_ACSDusk_C,DinoColorSet_ACSAquatic_C,DinoColorSet_ExtinctionChronicles,DinoColorSet_ACSVibrant_C,DinoColorSet_RandomColours_C
ChanceOfColourSet=50,80,10,40
ColoursetBPPaths=Blueprint'/Game/Mods/ExampleMod/Colours/DinoColorSet_RandomColours.DinoColorSet_RandomColours'



Example config where almost all dinos, except raptors, rexes, baryonyxes, beelzebufo and doeds, will be able to receive the custom Molten Element and Aquatic sets.The Achatina a 60% chance of spawning with a global set, the Allo 20%, and the Anky 80%, and every other dino is guarenteed to receive either, one of the global sets, or a class-specific set.
Custom sets will be applied before global sets, and global sets are not allowed to override custom sets, so argents, raptors, achatina, and rexes, will receive their custom set at a 40,100,50, and 80% chance respectively. They will then receive (or have a chance to receive, in the achatina's case), one of the global sets if that chance fails (excepting the rex, which has been disabled with global exclusions, and raptor).

The argent gets the Glacial colourset at 40% chance, the Raptor receives the Alpha Fire Wyvern colourset, the achatina receives the custom Vibrant, Volcanic or DeepOcean colourset at 50% chance, and the rex recieves the custom Volcanic, or randomcolours colourset from 'example mod' at 40% chance.

From the first instance of the dino that spawns, 5 more entries in DinosToUseCustomSets will be checked for matching classnames, and as a result extra coloursets to apply.


[AnyColourSets]
ColoursetBPPaths=Blueprint'/Game/Mods/ExampleMod/Colours/DinoColorSet_RandomColours.DinoColorSet_RandomColours'
DisableSetOverrides=True
SetAppliedOrder=0
GlobalColourSets=DinoColorSet_ACSMoltenElementAberrant_C,DinoColorSet_ACSAquatic_C
UseCustomGlobalSets=True
CustomGlobalColourSetChance=100
DinosToUseCustomSets=argent_character_bp_c,raptor_character_bp_C,achatina_Character_bp_c,Achatina_Character_BP_C,Achatina_Character_BP_C,rex_Character_bp_c,rex_character_bp_C,
ColourSetsToUse=DinoColorSet_ACSGlacial_C,SE_DinoColorSet_MegaWyvern_Fire_C,DinoColorSet_ACSVibrant_C,DinoColorSet_ACSVolcanic_C,DinoColorSet_ACSDeepOcean_C,DinoColorSet_ACSVolcanic_C,DinoColorSet_RandomColours_C
ChanceOfColourSet=40,100,50,80,
ExtraEntriesToCheck=5
UseSpecificGlobalChances=True
SpecificGlobalChancesDinos=Achatina_Character_BP_C,Allo_Character_BP_C,Ankylo_Character_BP_C,
SpecificGlobalChances=60,20,80
UseGlobalExcludeClasses=true
GlobalExcludeClasses=Baryonyx_Character_BP_C,Toad_Character_BP_C,Doed_Character_BP_C,Rex_Character_bp_c
---------------------------------------------------------------------------------------