Icon Renaming Scripts

On occasion, Behaviour has been known to change the filenames of icons en masse (for instance, with 7.1.0 when all CharPortrait icon names were changed).

To keep custom icons working, it's necessary to migrate any existing icons to use the new names. To simplify this, this page includes scripts to automate the process.

caution

Please note that the use of these scripts is done at your own risk. While their functionality is trivial and I don't expect them to cause any harm, I'm not responsible if they somehow do.

I highly recommend running these on a copy/backup of your pack.

How to Use

These scripts are written in a scripting language called PowerShell. They can be run in the PowerShell or Windows Terminal.

As the scripts rename files in bulk, it's highly advisable to make a copy of any packs you are updating before running the script.

Once you've made a copy of the icon pack folder, inside the pack folder either:

• Shift-right click and click "Open PowerShell window here"
• Right click and click "Open in Terminal"

(The options will vary slightly depending on your Windows version).

Once you have one of these open, copy and paste the script into it and press Enter - all the icons should then be renamed accordingly.

Scripts

8.6.0 PTB HelpLoading Icons

The 8.6.0 PTB renamed all the HelpLoading Icons, this script will rename them to the new names.

# This script was published by NightLight for the custom icon pack community.
# Usage of this script is done at your own risk.
# PLEASE make a backup of your icons first in case there's any issues.
# See https://docs.nightlight.gg/icon-packs/resources/icon-renaming-scripts for more information.
$changes = @{
    'iconHelpLoading_unknown.png' = 'T_UI_iconHelpLoading_K35.png'
    'iconHelpLoading_twins.png' = 'T_UI_iconHelpLoading_K22.png'
    'iconHelpLoading_lich.png' = 'T_UI_iconHelpLoading_K36.png'
    'iconHelpLoading_trickster.png' = 'T_UI_iconHelpLoading_K23.png'
    'iconHelpLoading_reveal.png' = 'T_UI_iconHelpLoading_reveal.png'
    'iconHelpLoading_shapeshift.png' = 'T_UI_iconHelpLoading_K37.png'
    'iconHelpLoading_T-virus.png' = 'T_UI_iconHelpLoading_K24.png'
    'iconHelpLoading_brute.png' = 'T_UI_iconHelpLoading_brute.png'
    'iconHelpLoading_enforcer.png' = 'T_UI_iconHelpLoading_enforcer.png'
    'iconHelpLoading_escapist.png' = 'T_UI_iconHelpLoading_escapist.png'
    'iconHelpLoading_fearmonger.png' = 'T_UI_iconHelpLoading_fearmonger.png'
    'iconHelpLoading_guide.png' = 'T_UI_iconHelpLoading_guide.png'
    'iconHelpLoading_medic.png' = 'T_UI_iconHelpLoading_medic.png'
    'iconHelpLoading_scout.png' = 'T_UI_iconHelpLoading_scout.png'
    'iconHelpLoading_shadow.png' = 'T_UI_iconHelpLoading_shadow.png'
    'icons_HelpLoading_tactician.png' = 'T_UI_icons_HelpLoading_tactician.png'
    'T_UI_icons_HelpLoading_Houndmaster.png' = 'T_UI_iconHelpLoading_K38.png'
    'iconHelpLoading_SummonsOfPain.png' = 'T_UI_iconHelpLoading_K25.png'
    'T_iconHelpLoading_birdsOfTorment.png' = 'T_UI_iconHelpLoading_K26.png'
    'iconHelpLoading_delugeOfFear.png' = 'T_UI_iconHelpLoading_K27.png'
    'iconHelpLoading_ReignOfDarkness.png' = 'T_UI_iconHelpLoading_K28.png'
    'iconHelpLoading_virulentBound.png' = 'T_UI_iconHelpLoading_K29.png'
    'iconHelpLoading_demogorgon.png' = 'T_UI_iconHelpLoading_K17.png'
    'iconHelpLoading_Assassin.png' = 'T_UI_iconHelpLoading_K30.png'
    'icons_HelpLoadingDrone.png' = 'T_UI_iconHelpLoading_K31.png'
    'iconHelpLoading_survActivity_Chase.png' = 'T_UI_iconHelpLoading_survActivity_Chase.png'
    'iconHelpLoading_survActivity_Chests.png' = 'T_UI_iconHelpLoading_survActivity_Chests.png'
    'iconHelpLoading_survActivity_Gates.png' = 'T_UI_iconHelpLoading_survActivity_Gates.png'
    'iconHelpLoading_survActivity_Generator.png' = 'T_UI_iconHelpLoading_survActivity_Generator.png'
    'iconHelpLoading_survActivity_Healing.png' = 'T_UI_iconHelpLoading_survActivity_Healing.png'
    'iconHelpLoading_survActivity_HealingSelf.png' = 'T_UI_iconHelpLoading_survActivity_HealingSelf.png'
    'iconHelpLoading_survActivity_Invocation.png' = 'T_UI_iconHelpLoading_survActivity_Invocation.png'
    'iconHelpLoading_survActivity_Killer.png' = 'T_UI_iconHelpLoading_survActivity_Killer.png'
    'iconHelpLoading_survActivity_Recovering.png' = 'T_UI_iconHelpLoading_survActivity_Recovering.png'
    'iconHelpLoading_survActivity_TotemBlessing.png' = 'T_UI_iconHelpLoading_survActivity_TotemBlessing.png'
    'iconHelpLoading_survActivity_Totems.png' = 'T_UI_iconHelpLoading_survActivity_Totems.png'
    'iconHelpLoading_sk.png' = 'T_UI_iconHelpLoading_K18.png'
    'iconHelpLoading_uk.png' = 'T_UI_iconHelpLoading_K19.png'
    'iconHelpLoading_quantumInstantiation.png' = 'T_UI_iconHelpLoading_K32.png'
    'iconHelpLoading_wales.png' = 'T_UI_iconHelpLoading_K20.png'
    'iconHelpLoading_hiddenPursuit.png' = 'T_UI_iconHelpLoading_K33.png'
    'iconHelpLoading_steamPipe.png' = 'T_UI_iconHelpLoading_steamPipe.png'
    'iconHelpLoading_k21.png' = 'T_UI_iconHelpLoading_K21.png'
    'iconHelpLoading_goodGuy.png' = 'T_UI_iconHelpLoading_K34.png'
    'iconHelpLoading_addons.png' = 'T_UI_iconHelpLoading_addons.png'
    'iconHelpLoading_bloodpoints.png' = 'T_UI_iconHelpLoading_bloodpoints.png'
    'iconHelpLoading_generatorRegresion.png' = 'T_UI_iconHelpLoading_generatorRegresion.png'
    'iconHelpLoading_generators.png' = 'T_UI_iconHelpLoading_generators.png'
    'iconHelpLoading_hatch.png' = 'T_UI_iconHelpLoading_hatch.png'
    'iconHelpLoading_health.png' = 'T_UI_iconHelpLoading_health.png'
    'iconHelpLoading_hook.png' = 'T_UI_iconHelpLoading_hook.png'
    'iconHelpLoading_trapper.png' = 'T_UI_iconHelpLoading_K01.png'
    'iconHelpLoading_wraith.png' = 'T_UI_iconHelpLoading_K02.png'
    'iconHelpLoading_hillbilly.png' = 'T_UI_iconHelpLoading_K03.png'
    'iconHelpLoading_nurse.png' = 'T_UI_iconHelpLoading_K04.png'
    'iconHelpLoading_hag.png' = 'T_UI_iconHelpLoading_K05.png'
    'iconHelpLoading_shape.png' = 'T_UI_iconHelpLoading_K06.png'
    'iconHelpLoading_doctor.png' = 'T_UI_iconHelpLoading_K07.png'
    'iconHelpLoading_huntress.png' = 'T_UI_iconHelpLoading_K08.png'
    'iconHelpLoading_cannibal.png' = 'T_UI_iconHelpLoading_K09.png'
    'iconHelpLoading_nightmare.png' = 'T_UI_iconHelpLoading_K10.png'
    'iconHelpLoading_pig.png' = 'T_UI_iconHelpLoading_K11.png'
    'iconHelpLoading_clown.png' = 'T_UI_iconHelpLoading_K12.png'
    'iconHelpLoading_spirit.png' = 'T_UI_iconHelpLoading_K13.png'
    'iconHelpLoading_legion.png' = 'T_UI_iconHelpLoading_K14.png'
    'iconHelpLoading_plague.png' = 'T_UI_iconHelpLoading_K15.png'
    'iconHelpLoading_ghost.png' = 'T_UI_iconHelpLoading_K16.png'
    'iconHelpLoading_killer.png' = 'T_UI_iconHelpLoading_killer.png'
    'iconHelpLoading_killerVision.png' = 'T_UI_iconHelpLoading_killerVision.png'
    'iconHelpLoading_lore.png' = 'T_UI_iconHelpLoading_lore.png'
    'iconHelpLoading_offering.png' = 'T_UI_iconHelpLoading_offering.png'
    'iconHelpLoading_players.png' = 'T_UI_iconHelpLoading_players.png'
    'iconHelpLoading_skillCheck.png' = 'T_UI_iconHelpLoading_skillCheck.png'
    'iconHelpLoading_sound.png' = 'T_UI_iconHelpLoading_sound.png'
    'iconHelpLoading_survivor.png' = 'T_UI_iconHelpLoading_survivor.png'
    'iconHelpLoading_totem.png' = 'T_UI_iconHelpLoading_totem.png'
    'iconHelpLoading_crows.png' = 'T_UI_iconHelpLoading_crows.png'
    'iconHelpLoading_info.png' = 'T_UI_iconHelpLoading_info.png'
    'iconHelpLoading_items.png' = 'T_UI_iconHelpLoading_items.png'
    'iconHelpLoading_settings.png' = 'T_UI_iconHelpLoading_settings.png'
}

Get-ChildItem –Path "./" –Recurse -File | 
Foreach-Object {
    if ($changes[$_.Name]) {
        Rename-Item -path $_.FullName -NewName $changes[$_.Name]
    }
}

7.1.0 Portraits

The 7.1.0 update renamed all the Portrait icons and changed the area of the portrait image that is used. This script migrates them to the new names.

# This script was published by NightLight for the custom icon pack community.
# Usage of this script is done at your own risk.
# PLEASE make a backup of your icons first in case there's any issues.
# See https://docs.nightlight.gg/icon-packs/resources/icon-renaming-scripts for more information.
$changes = @{
    'S23_charSelect_portrait.png' = 'S23_FelixRichter_Portrait.png'
    'K21_charSelect_portrait.png' = 'K21_TheBlight_Portrait.png'
    'S22_charSelect_portrait.png' = 'S22_CherylMason_Portrait.png'
    'K20_charSelect_portrait.png' = 'K20_TheExecutioner_Portrait.png'
    'S38_charSelect_portrait.png' = 'S38_NicolasCage_Portrait.png'
    'S37_charSelect_portrait.png' = 'S37_GabrielSoma_Portrait.png'
    'K32_charSelect_portrait.png' = 'K32_TheSingularity_Portrait.png'
    'US_charSelect_portrait.png' = 'S21_ZarinaKassir_Portrait.png'
    'UK_charSelect_portrait.png' = 'K19_TheDeathslinger_Portrait.png'
    'SS_charSelect_portrait.png' = 'S20_YuiKimura_Portrait.png'
    'SK_charSelect_portrait.png' = 'K18_TheOni_Portrait.png'
    'S36_charSelect_portrait.png' = 'S36_RenatoLyra_Portrait.png'
    'S35_charSelect_portrait.png' = 'S35_ThalitaLyra_Portrait.png'
    'K31_charSelect_portrait.png' = 'K31_TheSkullMerchant_Portrait.png'
    'S34_charSelect_portrait.png' = 'S34_VittorioToscano_Portrait.png'
    'K30_charSelect_portrait.png' = 'K30_TheKnight_Portrait.png'
    'QF_charSelect_portrait.png' = 'S19_NancyWheeler_Portrait.png'
    'QM_charSelect_portrait.png' = 'S18_SteveHarrington_Portrait.png'
    'QK_charSelect_portrait.png' = 'K17_TheDemogorgon_Portrait.png'
    'S33_charSelect_portrait.png' = 'S33_RebeccaChambers_Portrait.png'
    'S32_charSelect_portrait.png' = 'S32_AdaWong_Portrait.png'
    'K29_charSelect_portrait.png' = 'K29_TheMasterMind_Portrait.png'
    'OK_charSelect_portrait.png' = 'K16_TheGhostface_Portrait.png'
    'S31_charSelect_portrait.png' = 'S31_HaddieKaur_Portrait.png'
    'K28_charSelect_portrait.png' = 'K28_TheDredge_Portrait.png'
    'MS_charSelect_portrait.png' = 'S16_JaneRomero_Portrait.png'
    'MK_charSelect_portrait.png' = 'K15_ThePlague_Portrait.png'
    'S30_charSelect_portrait.png' = 'S30_YoichiAsakawa_Portrait.png'
    'K27_charSelect_portrait.png' = 'K27_TheOnryo_Portrait.png'
    'KS_charSelect_portrait.png' = 'S15_JeffJohansen_Portrait.png'
    'KK_charSelect_portrait.png' = 'K14_TheLegion_Portrait.png'
    'S29_charSelect_portrait.png' = 'S29_JonahVasquez_Portrait.png'
    'T_S29_charSelect_portrait.png' = 'S29_JonahVasquez_Portrait.png'
    'K26_charSelect_portrait.png' = 'K26_TheArtist_Portrait.png'
    'T_K26_charSelect_portrait.png' = 'K26_TheArtist_Portrait.png'
    'S28_charSelect_portrait.png' = 'S28_MikaelaReid_Portrait.png'
    'HK_charSelect_portrait.png' = 'K13_TheSpirit_Portrait.png'
    'AF_charSelect_portrait.png' = 'S14_AdamFrancis_Portrait.png'
    'GS_charSelect_portrait.png' = 'S13_KateDenson_Portrait.png'
    'GK_charSelect_portrait.png' = 'K12_TheClown_Portrait.png'
    'K25_charSelect_portrait.png' = 'K25_TheCenobite_Portrait.png'
    'FS_charSelect_portrait.png' = 'S12_DetectiveDavidTapp_Portrait.png'
    'FK_charSelect_portrait.png' = 'K11_ThePig_Portrait.png'
    'SD_charSelect_portrait.png' = 'K10_TheNightmare_Portrait.png'
    'QS_charSelect_portrait.png' = 'S11_QuentinSmith_Portrait.png'
    'S25_charSelect_portrait.png' = 'S25_YunJinLee_Portrait.png'
    'K23_charSelect_portrait.png' = 'K23_TheTrickster_Portrait.png'
    'CA_charSelect_portrait.png' = 'K09_TheCannibal_Portrait.png'
    'S24_charSelect_portrait.png' = 'S24_ElodieRakoto_Portrait.png'
    'K22_charSelect_portrait.png' = 'K22_TheTwins_Portrait.png'
    'MS2_charSelect_portrait.png' = 'S17_AshleyJWilliams_Portrait.png'
    'K24_charSelect_portrait.png' = 'K24_TheNemesis_Portrait.png'
    'S26_charSelect_portrait.png' = 'S26_JillValentine_Portrait.png'
    'S27_charSelect_portrait.png' = 'S27_LeonSKennedy_Portrait.png'
    'DF_charSelect_portrait.png' = 'S01_DwightFairfield_Portrait.png'
    'TR_charSelect_portrait.png' = 'K01_TheTrapper_Portrait.png'
    'MT_charSelect_portrait.png' = 'S02_MegThomas_Portrait.png'
    'WR_charSelect_portrait.png' = 'K02_TheWraith_Portrait.png'
    'CM_charSelect_portrait.png' = 'S03_ClaudetteMorel_Portrait.png'
    'HB_charSelect_portrait.png' = 'K03_TheHillbilly_Portrait.png'
    'JP_charSelect_portrait.png' = 'S04_JakePark_Portrait.png'
    'NR_charSelect_portrait.png' = 'K04_TheNurse_Portrait.png'
    'NK_charSelect_portrait.png' = 'S05_NeaKarlsson_Portrait.png'
    'HA_charSelect_portrait.png' = 'K05_TheHag_Portrait.png'
    'SH_charSelect_portrait.png' = 'K06_TheShape_Portrait.png'
    'LS_charSelect_portrait.png' = 'S06_LaurieStrode_Portrait.png'
    'AV_charSelect_portrait.png' = 'S07_AceVisconti_Portrait.png'
    'BO_charSelect_portrait.png' = 'S08_WilliamBillOverbeck_Portrait.png'
    'FM_charSelect_portrait.png' = 'S09_FengMin_Portrait.png'
    'DO_charSelect_portrait.png' = 'K07_TheDoctor_Portrait.png'
    'DK_charSelect_portrait.png' = 'S10_DavidKing_Portrait.png'
    'BE_charSelect_portrait.png' = 'K08_TheHuntress_Portrait.png'
}

Get-ChildItem –Path "./" –Recurse -File | 
Foreach-Object {
    if ($changes[$_.Name]) {
        Rename-Item -path $_.FullName -NewName $changes[$_.Name]
    }
}