Color Converter API 1.0.0

- SPT 3.8.2
RaiRaiTheRaichu
Oct 9th 2023
12k Downloads
27 Comments

Please do not ask when mod authors will update their mods to 3.9.0
Bothering mod authors will lead to warnings and repeat offenses will lead to eventual bans.

Client-side mod to allow using hexcode colors for your items! Custom background colors for your items, or any color tracer you want!

You can check to see if the plugin exists in your server mod's source code any way you'd like, but an easy copy-paste check is here:

Code

private static IsPluginLoaded(): boolean 
{
    const fs = require('fs');
    const pluginName = "rairai.colorconverterapi.dll";
        // Fails if there's no ./BepInEx/plugins/ folder
    try 
    {
        const pluginList = fs.readdirSync("./BepInEx/plugins").map(plugin => plugin.toLowerCase());
        return pluginList.includes(pluginName);
    }
    catch 
    {
        return false;
    }
}

Display More

You can handle the result of this function however you'd like. Once you have validated that the plugin exists, you can proceed to fill in the fields for color in your item database with hexcodes in lieu of a color enum.

For example:

"TracerColor": "#FF00FF",

"BackgroundColor": "#2A2AFF",

Short 3-byte hexcode colors are also supported like so:

"BackgroundColor": "#F90",

Which will be interpreted as:

"BackgroundColor": "#FF9900",

Images

Version 1.0.0
- RaiRaiTheRaichu
- Oct 9th 2023
- 11k Downloads
(Reupload due to broken permissions.)

Link not working? Try downloading from here:
https://github.com/RaiRaiTheRaichu/ColorConverterAPI/releases
https://dev.sp-tarkov.com/RaiRaiTheRaichu/ColorConverterAPI/releases

2

Demigods Apr 23rd 2024

Soo this might be the dumbest question ever but how does the mod work? I hit F12 and couldn't find it in the list to recolor items.

FiveF Apr 29th 2024

this mod is for modders. allows for custom background colors or racers or others colors. basic eft allows 7-9 different colors.
Demigods Apr 30th 2024

damn I wish i knew how to use it. I would love my own backgrounds for items and weapons and gear and stuff... I had one from DJLand in last version before 3.8.0 hit but i havent seen it since.

FiveF May 12th 2024

its simple. just edit database. Instead using `blue`, `default`, `yellow`, `red`, `black`, `tracerRed` etc, you can use hex values (i.e. 16 bits xd)

Code

    //ammo background 2.1
    for (const itemID in itemsData) {
        const item = itemsData[itemID];
        if (item._parent === `5485a8684bdc2da71d8b4567`) {
            if (item._props.PenetrationPower <= 5) {
                item._props.BackgroundColor = `#010000`; //1
            } else if (item._props.PenetrationPower <= 10) {
                item._props.BackgroundColor = `#030000`; //3
            } else if (item._props.PenetrationPower <= 15) {
                item._props.BackgroundColor = `#060000`; //6
            } else if (item._props.PenetrationPower <= 20) {
                item._props.BackgroundColor = `#0a0000`; //10
            } else if (item._props.PenetrationPower <= 25) {
                item._props.BackgroundColor = `#100000`; //16
            } else if (item._props.PenetrationPower <= 30) {
                item._props.BackgroundColor = `#170000`; //23
            } else if (item._props.PenetrationPower <= 35) {
                item._props.BackgroundColor = `#1f0000`; //31
            } else if (item._props.PenetrationPower <= 40) {
                item._props.BackgroundColor = `#290000`; //41
            } else if (item._props.PenetrationPower <= 45) {
                item._props.BackgroundColor = `#340000`; //52
            } else if (item._props.PenetrationPower <= 50) {
                item._props.BackgroundColor = `#400000`; //64
            } else if (item._props.PenetrationPower <= 55) {
                item._props.BackgroundColor = `#4d0000`; //77
            } else if (item._props.PenetrationPower <= 60) {
                item._props.BackgroundColor = `#5c0000`; //92
            } else if (item._props.PenetrationPower <= 65) {
                item._props.BackgroundColor = `#6c0000`; //108
            } else if (item._props.PenetrationPower <= 70) {
                item._props.BackgroundColor = `#7d0000`; //125
            } else if (item._props.PenetrationPower <= 75) {
                item._props.BackgroundColor = `#8f0000`; //143
            } else if (item._props.PenetrationPower <= 80) {
                item._props.BackgroundColor = `#a30000`; //163
            } else if (item._props.PenetrationPower <= 85) {
                item._props.BackgroundColor = `#b80000`; //184
            } else if (item._props.PenetrationPower <= 90) {
                item._props.BackgroundColor = `#cf0000`; //207
            } else if (item._props.PenetrationPower <= 95) {
                item._props.BackgroundColor = `#e60000`; //230
            } else {
                item._props.BackgroundColor = `#ff0000`; //255
            }
        }

Display More

This is was part of my old of manually written logarithmic penetration coefficient for ammunition (for RM). Look on #030000, #4d0000 etc. You can paste it here and see what color it is (this is blackRed to whiteRed).

I currently use two colors divided into calibers to determine if penetration is good or best for current caliber.

Code

export function backgroundAmmos(databaseServer: any) {
    const itemsData = databaseServer.tableData.templates.items;
    const enData = databaseServer.tableData.locales.global.en;

    //ammo background 3.0?
    const ammoList12x70: any[] = [];
    const ammoList20x70: any[] = [];
    const ammoList23x75: any[] = [];
    const ammoList26x75: any[] = [];
    const ammoList9x18: any[] = [];
    const ammoList762x25: any[] = [];
    const ammoList9x19: any[] = [];
    const ammoList1143x23: any[] = [];
    const ammoList9x21: any[] = [];
    const ammoList57x28: any[] = [];
    const ammoList46x30: any[] = [];
    const ammoList9x39: any[] = [];
    const ammoList9x33: any[] = [];
    const ammoList366_TKM: any[] = [];
    const ammoList545x39: any[] = [];
    const ammoList556x45: any[] = [];
    const ammoList68x51: any[] = [];
    const ammoList762x39: any[] = [];
    const ammoList762x35: any[] = [];
    const ammoList762x51: any[] = [];
    const ammoList762x54: any[] = [];
    const ammoList127x55: any[] = [];
    const ammoList86x70: any[] = [];
    const ammoList127x108: any[] = [];
    const ammoList40x46: any[] = [];
    const ammoListOthers: any[] = [];

    for (const itemId in itemsData) {
        const item = itemsData[itemId];

        if (item._parent === `5485a8684bdc2da71d8b4567`) {
            const keyInEnData = `${itemId} Name`;

            if (enData[keyInEnData]) {
                let addedToSpecificList = false;
                const ammoList = getAmmoList(enData[keyInEnData]);
                if (ammoList) {
                    ammoList.push({
                        _id: item._id,
                        name: enData[keyInEnData],
                        PenetrationPower: item._props.PenetrationPower,
                        Damage: item._props.Damage,
                        ArmorDamage: item._props.ArmorDamage
                    });
                    addedToSpecificList = true;
                }

                if (!addedToSpecificList) {
                    ammoListOthers.push({
                        _id: item._id,
                        name: enData[keyInEnData],
                        PenetrationPower: item._props.PenetrationPower,
                        Damage: item._props.Damage,
                        ArmorDamage: item._props.ArmorDamage
                    });
                }
            }
        }
    }

    function getAmmoList(ammoName) {
        switch (true) {
            case ammoName.startsWith(`12/70`):
                return ammoList12x70;
            case ammoName.startsWith(`20/70`):
                return ammoList20x70;
            case ammoName.startsWith(`23x75mm`):
                return ammoList23x75;
            case ammoName.startsWith(`26x75mm`):
                return ammoList26x75;
            case ammoName.startsWith(`9x18mm`):
                return ammoList9x18;
            case ammoName.startsWith(`7.62x25mm`):
                return ammoList762x25;
            case ammoName.startsWith(`9x19mm`):
                return ammoList9x19;
            case ammoName.startsWith(`.45 ACP`):
                return ammoList1143x23;
            case ammoName.startsWith(`9x21mm`):
                return ammoList9x21;
            case ammoName.startsWith(`5.7x28mm`):
                return ammoList57x28;
            case ammoName.startsWith(`4.6x30mm`):
                return ammoList46x30;
            case ammoName.startsWith(`9x39mm`):
                return ammoList9x39;
            case ammoName.startsWith(`.357 Magnum`):
                return ammoList9x33;
            case ammoName.startsWith(`.366 TKM`):
                return ammoList366_TKM;
            case ammoName.startsWith(`5.45x39mm`):
                return ammoList545x39;
            case ammoName.startsWith(`5.56x45mm`):
                return ammoList556x45;
            case ammoName.startsWith(`6.8x51mm`):
                return ammoList68x51;
            case ammoName.startsWith(`7.62x39mm`):
                return ammoList762x39;
            case ammoName.startsWith(`.300`):
                return ammoList762x35;
            case ammoName.startsWith(`7.62x51mm`):
                return ammoList762x51;
            case ammoName.startsWith(`7.62x54mm R`):
                return ammoList762x54;
            case ammoName.startsWith(`12.7x55mm`):
                return ammoList127x55;
            case ammoName.startsWith(`.338 Lapua Magnum`):
                return ammoList86x70;
            case ammoName.startsWith(`12.7x108mm`):
                return ammoList127x108;
            case ammoName.startsWith(`40x46mm`):
                return ammoList40x46;
            default:
                return ammoListOthers;
        }
    }

    function updateBackgroundColor(ammoList, itemsData) {
        var penetrationPowers = ammoList.map(ammo => ammo.PenetrationPower);
        var maxPenetrationPower = Math.max(...penetrationPowers);

        //loop each ammo and update BackgroundColor based on PenetrationPower
        ammoList.forEach(ammo => {
            if (ammo.PenetrationPower >= maxPenetrationPower - (maxPenetrationPower * 0.075)) {
                itemsData[ammo._id]._props.BackgroundColor = "#ff0000";
            } else if (ammo.PenetrationPower >= maxPenetrationPower - (maxPenetrationPower * 0.2)) {
                itemsData[ammo._id]._props.BackgroundColor = "#800000";
            }
        });
    }

    updateBackgroundColor(ammoList12x70, itemsData);
    updateBackgroundColor(ammoList20x70, itemsData);
    updateBackgroundColor(ammoList23x75, itemsData);
    updateBackgroundColor(ammoList26x75, itemsData);
    updateBackgroundColor(ammoList9x18, itemsData);
    updateBackgroundColor(ammoList762x25, itemsData);
    updateBackgroundColor(ammoList9x19, itemsData);
    updateBackgroundColor(ammoList1143x23, itemsData);
    updateBackgroundColor(ammoList9x21, itemsData);
    updateBackgroundColor(ammoList57x28, itemsData);
    updateBackgroundColor(ammoList46x30, itemsData);
    updateBackgroundColor(ammoList9x39, itemsData);
    updateBackgroundColor(ammoList9x33, itemsData);
    updateBackgroundColor(ammoList366_TKM, itemsData);
    updateBackgroundColor(ammoList545x39, itemsData);
    updateBackgroundColor(ammoList556x45, itemsData);
    updateBackgroundColor(ammoList68x51, itemsData);
    updateBackgroundColor(ammoList762x39, itemsData);
    updateBackgroundColor(ammoList762x35, itemsData);
    updateBackgroundColor(ammoList762x51, itemsData);
    updateBackgroundColor(ammoList762x54, itemsData);
    updateBackgroundColor(ammoList127x55, itemsData);
    updateBackgroundColor(ammoList86x70, itemsData);
    updateBackgroundColor(ammoList127x108, itemsData);
    updateBackgroundColor(ammoList40x46, itemsData);
    updateBackgroundColor(ammoListOthers, itemsData);
}

Display More

yes i am too fasst

Demigods May 12th 2024

lol I did NOT understand any of what you do said.. All i see are letters and numbers. To bad there wasn't a hud to make your own background colors using a hud program for dumb people like me lol

SezaRoski Apr 22nd 2024

Is this error is known to any one?
https://i.postimg.cc/C5QBZ9ZX/…024-04-21-16-17-32-58.png
- SezaRoski Apr 22nd 2024
  
  I have posted a help threads about it
Houragorn Apr 21st 2024

This might be foolish of me but, would there be a way to use this to add more colours to the "Tag" feature for containers? Is that even possible?
- RaiRaiTheRaichu Apr 21st 2024 Author
  
  It would take a separate client mod, but an RGB slider or something definitely wouldn't be impossible.
  
  IIRC, that kind of information gets saved to the profile so I'd be concerned that if you removed the mod, your profile would be broken unless you untagged/deleted the items.
  
  Still, it's definitely doable.
- Houragorn Apr 22nd 2024
  
  Thanks for the response King. As I feared it will be more than what my little coding skills can do. I might try but most likely will hit a wall. Thanks none the less for the pointers!
Elite911 Apr 19th 2024

I am using Item Info

I assume this mod would be incompatible as they both use colors.
- RaiRaiTheRaichu Apr 19th 2024 Author
  
  Nothing is incompatible, and this isn't a mod
FiveF Apr 12th 2024

Next step - RGBA :]
jk ~w~
- RaiRaiTheRaichu Apr 12th 2024 Author
  
  Hi!
  
  It's on the to-do list, actually!
- FiveF Apr 12th 2024
  
  >.>
grizzly Oct 9th 2023

Not sure what file is downloaded using the download here "ColorConverterAPI-1.0.0.zip".
But it does not have any BebInEx folder or any .dll file in it, it has three .cs and one .sln, one .csproj files in it.

If i go too your github and download RaiRai.ColorConverterAPI.zip then i get the folder and dll file!
Did you upload/link the source code file instead?
1
- RaiRaiTheRaichu Oct 9th 2023 Author
  
  That's really weird, the zip that the link goes to is definitely the compiled release zip.
  
  Regardless, I changed the link yet again, so hope this one works for everyone.
  
  Either way, glad you managed to get the compiled plugin.
- grizzly Oct 10th 2023
  
  Yep that gave me the correct file!
Bobitec Oct 9th 2023

The link is a 404 page for me...

EDIT : Fixed; thank you
- Huze Oct 9th 2023
  
  me too!
- RaiRaiTheRaichu Oct 9th 2023 Author
  
  https://dev.sp-tarkov.com/RaiR…hu/ColorConverterAPI/tags
  
  Does this link work for you? Just click the zip at the bottom of the tag. Either way, I've updated the link as well in the Versions tab of this page.
- ArcticOwl Oct 9th 2023
  
  nope, dead link again
- Huze Oct 9th 2023
  
  still getting the error:{
- Huze Oct 9th 2023
  
  might not be authorized to use it

Color Converter API 1.0.0

Images

Version 1.0.0

Demigods Apr 23rd 2024

FiveF Apr 29th 2024

Demigods Apr 30th 2024

FiveF May 12th 2024

Demigods May 12th 2024

SezaRoski Apr 22nd 2024

SezaRoski Apr 22nd 2024

Houragorn Apr 21st 2024

RaiRaiTheRaichu Apr 21st 2024 Author

Houragorn Apr 22nd 2024

Elite911 Apr 19th 2024

RaiRaiTheRaichu Apr 19th 2024 Author

FiveF Apr 12th 2024

RaiRaiTheRaichu Apr 12th 2024 Author

FiveF Apr 12th 2024

grizzly Oct 9th 2023

RaiRaiTheRaichu Oct 9th 2023 Author

grizzly Oct 10th 2023

Bobitec Oct 9th 2023

Huze Oct 9th 2023

RaiRaiTheRaichu Oct 9th 2023 Author

ArcticOwl Oct 9th 2023

Huze Oct 9th 2023

Huze Oct 9th 2023

Ammo Stats in Description

Useless Key Blacklist

Warzone Cat Ears

Unrestricted Plates

Rai's Hidden Caches

Who is online?