factorio-scenario-ExpCluster/exp_legacy/module/modules/data/player-colours.lua

--- Gives players random colours when they join, also applies preset colours to those who have them
-- @data Player-Colours

local Event = require("modules/exp_legacy/utils/event") --- @dep utils.event
local Colours = require("modules/exp_util/include/color")
local config = require("modules.exp_legacy.config.preset_player_colours") --- @dep config.preset_player_colours

--- Stores the colour that the player wants
local PlayerData = require("modules.exp_legacy.expcore.player_data") --- @dep expcore.player_data
local PlayerColours = PlayerData.Settings:combine("Colour")
PlayerColours:set_metadata{
    stringify = function(value)
        if not value then return "None set" end
        local c = value[1]
        return string.format("Red: %d Green: %d Blue: %d", c[1], c[2], c[3])
    end,
}

--- Used to compact player colours to take less space
local floor = math.floor
local function compact(colour)
    return {
        floor(colour.r * 255),
        floor(colour.g * 255),
        floor(colour.b * 255),
    }
end

--- Returns a colour that is a bit lighter than the one given
local function lighten(c)
    return { r = 255 - (255 - c.r) * 0.5, g = 255 - (255 - c.g) * 0.5, b = 255 - (255 - c.b) * 0.5, a = 255 }
end

--- When your data loads apply the players colour, or a random on if none is saved
PlayerColours:on_load(function(player_name, player_colour)
    if not player_colour then
        local preset = config.players[player_name]
        if preset then
            player_colour = { preset, lighten(preset) }
        else
            local colour_name = "white"
            while config.disallow[colour_name] do
                colour_name = table.get_random_dictionary_entry(Colours, true)
            end

            player_colour = { Colours[colour_name], lighten(Colours[colour_name]) }
        end
    end

    local player = game.players[player_name]
    player.color = player_colour[1]
    player.chat_color = player_colour[2]
end)

--- Save the players color when they use the color command
Event.add(defines.events.on_console_command, function(event)
    if event.command ~= "color" then return end
    if event.parameters == "" then return end
    if not event.player_index then return end
    local player = game.players[event.player_index]
    if not player or not player.valid then return end
    PlayerColours:set(player, { compact(player.color), compact(player.chat_color) })
end)