Boyfriend Dungeon: Ultimate Modding Guide

by Falagar / Articles, Misc. Guides / 11 Aug 2021

Before you start modifying, make a backup of any save files or other important data.

Folder for Modding

You must place ALL replacement files in the folder ModData. You should create the folder if it does not already exist (next to the SaveData folder – not inside it)

Microsoft Windows

By default, Steam’s modding folder path is: (Windows, Mac, Linux)

/SteamApps/common/Boyfriend Dungeon/ModData/[Steam Install]

For non-Steam builds (Windows Only), the modding folder path is:

C:\Users\[USERNAME]\AppData\Roaming\BoyfriendDungeon\ModData

Changing Portraits of Characters

You have the option to change each portrait! Please remember that each replacement must meet the following criteria:

Image in PNG format

the exact same filename

the ideal resolution for that particular character (see list below)

The titles of the pictures, along with their corresponding pixel sizes, are shown below. PRESERVE THESE MEASUREMENTS AT ALL COSTS! For example, Cousin Jesse must always be 724 x 980 pixels, while other characters must have their own specifications.

Character portraits that can be replaced;

Portrait_Axe_Neutral.png : 912 x 1024

Portrait_Axe_LookAway.png : 912 x 1024

Portrait_Axe_Beach.png : 912 x 1024

Portrait_BrassKnuckles_Neutral.png : 724 x 752

Portrait_Cousin_Neutral.png : 724 x 980

Portrait_Cousin_LookAway.png : 724 x 980

Portrait_Cousin_Swimwear.png : 724 x 980

Portrait_Dagger_Neutral.png : 692 x 1012

Portrait_Dagger_DarkOutfitLookAway.png : 692 x 1012

Portrait_Dagger_DarkOutfitNeutral.png : 692 x 1012

Portrait_Dagger_LookAway.png : 692 x 1012

Portrait_Dagger_FormalwearNeutral.png : 692 x 1012

Portrait_Dagger_Swimwear.png : 692 x 1012

Portrait_Estoc_Neutral.png : 704 x 1000

Portrait_Estoc_Cufflinks.png : 704 x 1000

Portrait_Estoc_Fencing.png : 704 x 1000

Portrait_Estoc_LookAway.png : 704 x 1000

Portrait_Estoc_Swimwear.png : 704 x 1000

Portrait_Eric_Neutral.png : 768 x 1024

Portrait_Eric_LookingAway.png : 768 x 1024

Portrait_Eric_Blushing.png : 768 x 1024

Portrait_Glaive_Neutral.png : 616 x 992

Portrait_Glaive_LookAway.png : 616 x 992

Portrait_Glaive_Swimwear.png : 616 x 992

Portrait_Hammer_Neutral.png : 760 x 1000

Portrait_Jake_Neutral.png : 608 x 1024

Portrait_Katana_Neutral.png : 832 x 1024

Portrait_Lasersaber_ArmUp.png : 736 x 980

Portrait_Lasersaber_Neutral.png : 736 x 980

Portrait_Mandy_Neutral.png : 656 x 984

Portrait_Olivia_CasualHappy.png : 672 x 980

Portrait_Olivia_CasualLookAway.png : 672 x 980

Portrait_Olivia_CasualNeutral.png : 672 x 980

Portrait_Olivia_CasualNeutralPhone.png : 672 x 980

Portrait_Olivia_Neutral.png : 672 x 980

Portrait_Olivia_WorkHappy.png : 672 x 980

Portrait_Olivia_WorkNeutral.png : 672 x 980

Portrait_Scythe_Neutral.png : 840 x 1000

Portrait_Scythe_NoBird.png : 840 x 1000

Portrait_Scythe_LookAway.png : 840 x 1000

Portrait_Scythe_LookAwayNoBird.png : 840 x 1000

Portrait_Scythe_Swimwear.png : 840 x 1000

Portrait_Scythe_Witchy.png : 840 x 1000

Portrait_Scythe_WitchyLookAway.png : 840 x 1000

Portrait_Scythe_WitchyNoBird.png : 840 x 1000

Portrait_Sungwoo_Neutral.png : 876 x 1024

Portrait_Talwar_Neutral.png : 832 x 1000

Portrait_Talwar_Blushing.png : 832 x 1000

Portrait_Talwar_LookAway.png : 832 x 1000

Portrait_Vincent_LookAway.png : 644 x 984

Portrait_Vincent_Neutral.png : 644 x 984

Portrait_Astarte_Hissing.png : 724 x 752

Portrait_Astarte_Neutral.png : 724 x 752

Portrait_Axe_Beach.png : 912 x 1024

Portrait_Axe_LookAway.png : 912 x 1024

Portrait_Axe_Neutral.png : 912 x 1024

Portrait_Axe_Smiling.png : 912 x 1024

Portrait_Axe_Thinking.png : 912 x 1024

Portrait_Axe_Weapon.png : 616 x 1024

Portrait_Backer_Dorian.png : 736 x 1000

Portrait_Backer_Eloise_Neutral.png : 644 x 1012

Portrait_Backer_Jeeves_Neutral.png : 804 x 1012

Portrait_Backer_Jessbond_Neutral.png : 704 x 1012

Portrait_Backer_Julian.png : 560 x 980

Portrait_Backer_Kohl_Neutral.png : 900 x 1012

Portrait_Backer_Melinda.png : 948 x 1012

Portrait_Backer_VitasVarnas_Neutral.png : 644 x 1000

Portrait_BrassKnuckles_Cleaning.png : 724 x 752

Portrait_BrassKnuckles_Hissing.png : 724 x 752

Portrait_BrassKnuckles_Neutral.png : 724 x 752

Portrait_BrassKnuckles_Purring.png : 724 x 752

Portrait_BrassKnuckles_Scared.png : 724 x 752

Portrait_BrassKnuckles_Sleeping.png : 724 x 752

Portrait_BrassKnuckles_SleepingPurring.png : 724 x 752

Portrait_BrassKnuckles_SuperPurring.png : 724 x 752

Portrait_BrassKnuckles_Weapon.png : 688 x 972

Portrait_BrassKnuckles_WeaponBroken.png : 688 x 972

Portrait_Cake.png : 480 x 676

Portrait_Cousin_LookAway.png : 724 x 980

Portrait_Cousin_Neutral.png : 724 x 980

Portrait_Cousin_Sad.png : 724 x 980

Portrait_Cousin_Scared.png : 724 x 980

Portrait_Cousin_Smiling.png : 724 x 980

Portrait_Cousin_SuperSmiling.png : 724 x 980

Portrait_Cousin_Surprised.png : 724 x 980

Portrait_Cousin_Swimwear.png : 724 x 980

Portrait_Cousin_SwimwearLookAway.png : 724 x 980

Portrait_Cousin_SwimwearSad.png : 724 x 980

Portrait_Cousin_SwimwearSmiling.png : 724 x 980

Portrait_Cousin_SwimwearSuperSmiling.png : 724 x 980

Portrait_Cousin_SwimwearSurprised.png : 724 x 980

Portrait_Cousin_SwimwearThinking.png : 724 x 980

Portrait_Cousin_Thinking.png : 724 x 980

Portrait_Dagger_Angry.png : 692 x 1012

Portrait_Dagger_DarkOutfitAngry.png : 692 x 1012

Portrait_Dagger_DarkOutfitFlirtyWink.png : 692 x 1012

Portrait_Dagger_DarkOutfitLookAway.png : 692 x 1012

Portrait_Dagger_DarkOutfitNeutral.png : 692 x 1012

Portrait_Dagger_DarkOutfitSurprised.png : 692 x 1012

Portrait_Dagger_DarkOutfitWink.png : 692 x 1012

Portrait_Dagger_DarkOutfitWoozy.png : 692 x 1012

Portrait_Dagger_FlirtyToast.png : 692 x 1012

Portrait_Dagger_FlirtyWink.png : 692 x 1012

Portrait_Dagger_FormalwearNeutral.png : 692 x 1012

Portrait_Dagger_LookAway.png : 692 x 1012

Portrait_Dagger_Neutral.png : 692 x 1012

Portrait_Dagger_PJ.png : 692 x 1012

Portrait_Dagger_Surprised.png : 692 x 1012

Portrait_Dagger_SwimwearFlirtyWink.png : 692 x 1012

Portrait_Dagger_SwimwearLookAway.png : 692 x 1012

Portrait_Dagger_SwimwearSurprised.png : 692 x 1012

Portrait_Dagger_Weapon.png : 400 x 816

Portrait_Dagger_WeaponBroken.png : 400 x 816

Portrait_Dagger_Wink.png : 692 x 1012

Portrait_Dagger_Woozy.png : 692 x 1012

Portrait_DungeonBoyfriend_Blush.png : 1024 x 1000

Portrait_DungeonBoyfriend_Hands.png : 1024 x 1000

Portrait_DungeonBoyfriend_Neutral.png : 1024 x 1000

Portrait_DungeonBoyfriend_Surprise.png : 1024 x 1000

Portrait_Eric_Angry.png : 768 x 1024

Portrait_Eric_Blushing.png : 768 x 1024

Portrait_Eric_Disgusted.png : 768 x 1024

Portrait_Eric_FlameAngry.png : 768 x 1024

Portrait_Eric_FlameNeutral.png : 768 x 1024

Portrait_Eric_FlameSad.png : 768 x 1024

Portrait_Eric_FlameScared.png : 768 x 1024

Portrait_Eric_Happy.png : 768 x 1024

Portrait_Eric_Injured.png : 768 x 1024

Portrait_Eric_InLove.png : 768 x 1024

Portrait_Eric_LookingAway.png : 768 x 1024

Portrait_Eric_Neutral.png : 768 x 1024

Portrait_Eric_Pouting.png : 768 x 1024

Portrait_Eric_Sad.png : 768 x 1024

Portrait_Eric_Scared.png : 768 x 1024

Portrait_Estoc_Annoyed.png : 704 x 1000

Portrait_Estoc_Cufflinks.png : 704 x 1000

Portrait_Estoc_Fencing.png : 704 x 1000

Portrait_Estoc_FencingSurprised.png : 704 x 1000

Portrait_Estoc_FencingThinking.png : 704 x 1000

Portrait_Estoc_LookAway.png : 704 x 1000

Portrait_Estoc_Neutral.png : 704 x 1000

Portrait_Estoc_Sad.png : 704 x 1000

Portrait_Estoc_Smiling.png : 704 x 1000

Portrait_Estoc_SmilingFlirty.png : 704 x 1000

Portrait_Estoc_Superflirty.png : 704 x 1000

Portrait_Estoc_Surprised.png : 704 x 1000

Portrait_Estoc_Swimwear.png : 704 x 1000

Portrait_Estoc_SwimwearLookAway.png : 704 x 1000

Portrait_Estoc_SwimwearSmiling.png : 704 x 1000

Portrait_Estoc_SwimwearSmilingFlirty.png : 704 x 1000

Portrait_Estoc_SwimwearSuperflirty.png : 704 x 1000

Portrait_Estoc_SwimwearSurprised.png : 704 x 1000

Portrait_Estoc_Talking.png : 704 x 1000

Portrait_Estoc_Thinking.png : 704 x 1000

Portrait_Estoc_Weapon.png : 300 x 1024

Portrait_Gift_Steel.png : 688 x 972

Portrait_Glaive_Angry.png : 616 x 992

Portrait_Glaive_Blushing.png : 616 x 992

Portrait_Glaive_BlushLook.png : 616 x 992

Portrait_Glaive_FreakOut.png : 616 x 992

Portrait_Glaive_LookAway.png : 616 x 992

Portrait_Glaive_Neutral.png : 616 x 992

Portrait_Glaive_Superflirty.png : 616 x 992

Portrait_Glaive_Swimwear.png : 616 x 992

Portrait_Glaive_SwimwearBlush.png : 616 x 992

Portrait_Glaive_SwimwearBlushingLook.png : 616 x 992

Portrait_Glaive_SwimwearFreakOut.png : 616 x 992

Portrait_Glaive_SwimwearSuperflirty.png : 616 x 992

Portrait_Glaive_Weapon.png : 256 x 1024

Portrait_Glaive_WeaponBroken.png : 256 x 1024

Portrait_Jake_Annoyed.png : 608 x 1024

Portrait_Jake_Grin.png : 608 x 1024

Portrait_Jake_Neutral.png : 608 x 1024

Portrait_Jake_Sad.png : 608 x 1024

Portrait_Jake_Smile.png : 608 x 1024

Portrait_Katana_Neutral.png : 832 x 1024

Portrait_Kristine_Annoyed.png : 900 x 972

Portrait_Kristine_Neutral.png : 900 x 972

Portrait_Kristine_Pained.png : 900 x 972

Portrait_Lasersaber_Annoyed.png : 736 x 980

Portrait_Lasersaber_ArmUp.png : 736 x 980

Portrait_Lasersaber_Flirty.png : 736 x 980

Portrait_Lasersaber_LookAway.png : 736 x 980

Portrait_Lasersaber_LookingAtPhone.png : 736 x 980

Portrait_Lasersaber_Neutral.png : 736 x 980

Portrait_Lasersaber_Pained.png : 736 x 980

Portrait_Lasersaber_Superflirty.png : 736 x 980

Portrait_Lasersaber_Swimwear.png : 736 x 980

Portrait_Lasersaber_SwimwearFlirty.png : 736 x 980

Portrait_Lasersaber_SwimwearSuperflirty.png : 736 x 980

Portrait_Lasersaber_Weapon.png : 456 x 1200

Portrait_Lasersaber_WeaponBroken.png : 456 x 1200

Portrait_Lasersaber_WeaponNoBlade.png : 456 x 1200

Portrait_Lasersaber_WeaponNoBladeBroken.png : 456 x 1200

Portrait_Mandy_Neutral.png : 656 x 984

Portrait_Mandy_SadPity.png : 656 x 984

Portrait_Mandy_Smirk.png : 656 x 984

Portrait_Mandy_Thinking.png : 656 x 984

Portrait_None.png : 400 x 400

Portrait_Olivia_CasualAngry.png : 672 x 980

Portrait_Olivia_CasualExcited.png : 672 x 980

Portrait_Olivia_CasualHappy.png : 672 x 980

Portrait_Olivia_CasualLookAway.png : 672 x 980

Portrait_Olivia_CasualNeutral.png : 672 x 980

Portrait_Olivia_CasualNeutralPhone.png : 672 x 980

Portrait_Olivia_CasualSad.png : 672 x 980

Portrait_Olivia_Neutral.png : 672 x 980

Portrait_Olivia_WorkAngry.png : 672 x 980

Portrait_Olivia_WorkExcited.png : 672 x 980

Portrait_Olivia_WorkHappy.png : 672 x 980

Portrait_Olivia_WorkNeutral.png : 672 x 980

Portrait_Olivia_WorkSad.png : 672 x 980

Portrait_Scythe_Angry.png : 840 x 1000

Portrait_Scythe_AngryLookAway.png : 840 x 1000

Portrait_Scythe_AngryLookAwayNoBird.png : 840 x 1000

Portrait_Scythe_AngryNoBird.png : 840 x 1000

Portrait_Scythe_Flirty.png : 840 x 1000

Portrait_Scythe_Happy.png : 840 x 1000

Portrait_Scythe_HappyNoBird.png : 840 x 1000

Portrait_Scythe_LookAway.png : 840 x 1000

Portrait_Scythe_LookAwayNoBird.png : 840 x 1000

Portrait_Scythe_Neutral.png : 840 x 1000

Portrait_Scythe_NoBird.png : 840 x 1000

Portrait_Scythe_OnlyBird.png : 840 x 1000

Portrait_Scythe_Pained.png : 840 x 1000

Portrait_Scythe_PainedNoBird.png : 840 x 1000

Portrait_Scythe_Puzzle.png : 424 x 716

Portrait_Scythe_Superflirty.png : 840 x 1000

Portrait_Scythe_Surprised.png : 840 x 1000

Portrait_Scythe_SurprisedNoBird.png : 840 x 1000

Portrait_Scythe_Swimwear.png : 840 x 1000

Portrait_Scythe_SwimwearFlirty.png : 840 x 1000

Portrait_Scythe_SwimwearHappy.png : 840 x 1000

Portrait_Scythe_SwimwearLookAway.png : 840 x 1000

Portrait_Scythe_SwimwearSuperflirty.png : 840 x 1000

Portrait_Scythe_SwimwearSurprised.png : 840 x 1000

Portrait_Scythe_Weapon.png : 820 x 1068

Portrait_Scythe_Witchy.png : 840 x 1000

Portrait_Scythe_WitchyFlirty.png : 840 x 1000

Portrait_Scythe_WitchyFlirtyNoBird.png : 840 x 1000

Portrait_Scythe_WitchyHappy.png : 840 x 1000

Portrait_Scythe_WitchyHappyNoBird.png : 840 x 1000

Portrait_Scythe_WitchyLookAway.png : 840 x 1000

Portrait_Scythe_WitchyMagic.png : 840 x 1000

Portrait_Scythe_WitchyMagicNoBird.png : 840 x 1000

Portrait_Scythe_WitchyNoBird.png : 840 x 1000

Portrait_Scythe_WitchyPained.png : 840 x 1000

Portrait_Scythe_WitchyPose.png : 840 x 1000

Portrait_Scythe_WitchyPoseNoBird.png : 840 x 1000

Portrait_Scythe_WitchySuperflirty.png : 840 x 1000

Portrait_Scythe_WitchySuperflirtyNoBird.png : 840 x 1000

Portrait_Scythe_WitchySurprised.png : 840 x 1000

Portrait_Silhouette.png : 652 x 1000

Portrait_SingleRose.png : 200 x 720

Portrait_Sungwoo_Happy.png : 876 x 1024

Portrait_Sungwoo_Neutral.png : 876 x 1024

Portrait_Sungwoo_NeutralCool.png : 876 x 1024

Portrait_Talwar_Annoyed.png : 832 x 1000

Portrait_Talwar_Blushing.png : 832 x 1000

Portrait_Talwar_Formalwear_Normal.png : 832 x 1000

Portrait_Talwar_LookAway.png : 832 x 1000

Portrait_Talwar_Neutral.png : 832 x 1000

Portrait_Talwar_PJ.png : 832 x 1000

Portrait_Talwar_Shirtless.png : 832 x 1000

Portrait_Talwar_SuperFlirty.png : 832 x 1000

Portrait_Talwar_Suspicious.png : 832 x 1000

Portrait_Talwar_Swimwear.png : 832 x 1000

Portrait_Talwar_SwimwearBlushing.png : 832 x 1000

Portrait_Talwar_SwimwearLookaway.png : 832 x 1000

Portrait_Talwar_VampireNeutral.png : 832 x 1000

Portrait_Talwar_VampireSmiling.png : 832 x 1000

Portrait_Talwar_VampireSuperFlirty.png : 832 x 1000

Portrait_Talwar_Weapon.png : 512 x 1024

Portrait_Talwar_WeaponBroken.png : 512 x 1024

Portrait_Tank_Casual.png : 700 x 1000

Portrait_Tank_Security.png : 700 x 1000

Portrait_TicketMachine_Neutral.png : 488 x 792

Portrait_Vincent_Angry.png : 644 x 984

Portrait_Vincent_Disgusted.png : 644 x 984

Portrait_Vincent_LookAway.png : 644 x 984

Portrait_Vincent_Neutral.png : 644 x 984

Portrait_WhiteCat_Neutral.png : 724 x 752

Portrait_WhiteCat_Sleeping.png : 724 x 752

Character Icons and phone contacts that can be replaced;

PhoneUI_ContactsNewMailIcon.png : 58 x 52

Contact_Portrait_Cousin.png : 120 x 140

Contact_Portrait_Default.png : 120 x 140

Contact_Portrait_Dagger.png : 120 x 140

Contact_Portrait_Eric.png : 120 x 140

Contact_Portrait_Estoc.png : 120 x 140

Contact_Portrait_Glaive.png : 120 x 140

Contact_Portrait_Gym.png : 120 x 140

Contact_Portrait_Knuckles.png : 120 x 140

Contact_Portrait_Lasersaber.png : 120 x 140

Contact_Portrait_NightclubBoss.png : 120 x 140

Contact_Portrait_Scythe.png : 120 x 140

Contact_Portrait_Shop.png : 120 x 140

Contact_Portrait_Talwar.png : 120 x 140

Changing Character Names

For each name you want to change, you must include a .txt file in ModData:

1: titled with the exact naming of the character, and

2: containing the replacement of the name.

Below, you can find the list of the names within the game. Be aware that many characters have multiple “names”/aliases. For example, while Sunder’s portraits are all called “Talwar”, as names he goes by both Sunder and Talwar.

Names that can be replaced;

ANY.txt

APARTMENT.txt

ARTSTUDIO.txt

Aiwaz.txt

Assistant.txt

Astarte.txt

Axe.txt

BEACH.txt

Barista.txt

Bird.txt

Bouncer.txt

BrassKnuckles.txt

CAT_CAFE.txt

CHURCH_DUNJ.txt

CLOTHING_STORE.txt

Cat.txt

Clerk.txt

Crowley.txt

Dagger.txt

Drunk Man.txt

Dungeon Boyfriend.txt

Dunj President.txt

Epee.txt

Eric.txt

Estoc.txt

GYM.txt

Girl.txt

Glaive.txt

Grumpy Detective.txt

HOSPITAL.txt

HOTEL_DUNJ.txt

HUB.txt

Heroine.txt

Hostess.txt

ICE_RINK.txt

Isaac.txt

Jake.txt

Jesse.txt

Jonah.txt

Katana.txt

Kristine.txt

Lasersaber.txt

MALL_DUNJ.txt

MANSION.txt

MOUNTAINS.txt

MUSEUM.txt

Mandy.txt

Masamune.txt

Mom.txt

Monster.txt

NIGHT_CLUB_DUNJ.txt

NORMAL_CAFE.txt

OFFICE.txt

Olivia.txt

PARK.txt

Pocket.txt

Professor.txt

RESTAURANT.txt

Recording.txt

Restaurant Owner.txt

Restaurant Owner:.txt

Rowan.txt

Sawyer.txt

Scythe.txt

Seven.txt

Smoking Jazz Singer.txt

Starter.txt

Street Cat.txt

Sunder.txt

Sungwoo.txt

THEATER.txt

Talwar.txt

Ticket Seller.txt

UNIVERSITY.txt

VINEYARD.txt

Valeria.txt

Vincent.txt

Vitas Varnas.txt

WEAPON_SHOP_DUNJ.txt

Waitress.txt

Woman.txt

Young Woman.txt

Falagar

He is the founder and editor of Magic Game World. He loved gaming from the moment he got a PlayStation 1 with Gran Turismo on his 7th birthday.

View all posts