0. Please make sure you are using the latest version before filing a bug report. It is also really helpful if bug reports include a script extender log or screenshot of the script extender window at the time the issue was encountered, along with as much information as possible to help me reproduce the bug. See the "Create Console" option in BG3 Mod Manager to make sure the script extender window is shown. Vague non-specific reports without supporting evidence are hard to act upon and may be ignored. Also, please use English when submitting bug reports.
1. If you close the character creation screen when making a Custom Companion you will return to the main menu and lose any unsaved progress. It will also mess up the character creation screen for the remainder of the game session. This behavior appears hard coded and I cannot work around it. DO NOT TAUNT HAPPY FUN BALL. DO NOT CLOSE THE CHARACTER CREATION SCREEN.
2. Creating a Custom Companion will disruptively open the character creation screen for everyone in multiplayer. This also appears hard coded. If using this mod in multiplayer you are advised to warn your friends before creating a Companion. Those players who are not creating a Companion should just click through without changing anything.
3. Using this mod along with Show Approval Ratings in Dialogue Choices (and possibly other similar mods) will cause text like "[Gale 1]" to be appended to some of the dialogue lines when talking to a Custom Companion, as if those lines were going to affect a vanilla follower's approval. This is a cosmetic issue only, caused by me recycling vanilla dialogue lines which then get edited by the other mod, and will not actually modify your other party members' approval.
4. Dragonborn Companions may have animation problems in dialogue. This is an underlying game issue and not in my power to fix, and probably explains why there are no Dragonborn hirelings. Please use the command spells instead of dialogue in this case.[/b]
5. It has been reported that using Mordenkainen's Fortuitous Friend Finder can somehow register as a total party kill for the purposes of Honor Mode. I have no idea why this would be, but I don't play Honor Mode and this mod was not made with it in mind, so you are advised to be careful. Frequently Asked Questions
Q: Are you going to upload this to Larian's mod page? Will it be available on consoles? A: Probably not because it makes use of the script extender to do things beyond what the official toolkit is capable of.
Q: I can't find the items or spells. How do I use this? A: You probably didn't install the Script Extender properly. Go back and check that it is working.
Q: Can I make [insert favorite mod race here] and/or [insert favorite mod class here] Companions? A: This mod uses the same character creation interface as creating a player character, so any combination of race/class including modded ones should work. Some may require Improved UI, so check that you have it installed and up to date. If you find something which doesn't work in terms of race/class mods then it's almost certainly going to need to be addressed by their creator. This mod doesn't do anything on the user interface side of things.
Q: Can I duplicate [insert favorite character here] ? A: There are no restrictions on what you can target with the duplication spell/item, but the mod was made with "standard" humanoid characters in mind; think Lakrissa and Adrielle, not the Spider Matriarch or Ketheric Thorm. When it comes to "non-standard" things such as monsters, animals, mecha, boss enemies, etc you may run into missing animations and cases where unique special abilities do not copy over or are non-functional. Please do not be offended if I am not really interested in individually fixing issues with "non-standard" entities. Priority will be given to issues which affect "standard" humanoids or are game breaking.
Q: Is this compatible with [insert favorite mod here] ? A: I run a relatively low-mod setup, mostly just cosmetic things like hair and outfits, so I probably don't know. Please try for yourself and tell me about incompatible mods. I will attempt to improve compatibility where possible in response to reports. See the known issues above for any specific known conflicts.
Q: Can I uninstall this mid-playthrough? A: No, this mod is not safe to remove mid-playthrough. You are advised to take a clean save before evaluating the mod so that you can revert if you decide you do not wish to use it.
Q: Can you unbind the wand and mirror? They offend my sense of inventory tidiness. A: Since v2.0.2.0 you can do this via the configuration file (see below) but you are on your own if you do so. I will not help you get back items lost by unbinding them.
Q: I am a mod maker. How can I recognise characters created by your mod? A: Custom Companions, both created and duplicated, all carry the 7deac637-156c-435a-9059-a0dcc5d0ecf1 tag.
Q: Does this mod change the party size limit? A: Yes and no. You may have an unlimited number of custom companions, but when you have 3 of them the base game companions will regard your party as full. If you want a fully unlocked party size mod, I recommend Party Limit Begone (SE version). Certain cutscenes may have issues with an oversized party. Before reporting such issues as being the fault of my mod, please check if you can reproduce the problem with a normal size party.
Q: Can I use this in multiplayer? A: Yes, but I don't play multiplayer myself and my testing is limited to running two copies of the game on my own computer. Feedback regarding how it does or doesn't perform in a genuine networked environment is welcome!
Q: Can you add more dialogue? A: Unlikely unless Larian makes it a lot easier in the official modding tools. Even just the tiny bit I did include was a huge pain with only a text editor to work with.
Q: What version of the game and script extender are supported? A: As of writing, game patch 7 and script extender v20.
Q: Is this the same as [insert other popular mod here] ? A: I made this mod to scratch a personal itch which other mods weren't reaching, and I felt pleased with the result so I thought I'd share it with the community. I'm not looking to get into a popularity contest and if you already have another mod which works for you then you won't need this one.
Q: I dismissed my companion! Can I get them back? A: No. Dismissed companions are gone for good. Next time send them to your camp instead of to oblivion. ;)
Note that this is an advanced feature. If you are not comfortable locating and editing this kind of file then leave it alone. The default settings should be fine for most players!
The file will be created the first time you run the game with v2.0.2.0 or higher of the mod installed. It can then be found at:
"%LOCALAPPDATA%\Larian Studios\Baldur's Gate 3\Script Extender\CustomCompanions.json" The syntax of the file must be preserved entirely. Change only the words true and false, nothing else.
The following options are accepted:
CatchupXP - default: true - Enables the XP catch up mechanism where your Companions will level up when you do. If you disable this they will almost certainly start to lag behind.
CombatDuplication - default: false - Removes the out-of-combat restriction from the duplication spell, replacing the CC_CombatClone plugin. This feature is not well tested and you are not advised to enable it unless you have a particular great need for it.
ImmersiveEpilogue - default: true - Enables your Companions to grab a drink and mingle at Withers' gathering. Disable it if you want to retain control of your Companions during the epilogue. Only affects Custom Companions, does nothing to base game characters or characters from other mods.
UnbindItems - default: false - Turn this on to remove the 'bound' effect from the wand and mirror, allowing them to be moved out of your character's inventory. You are strongly advised against doing this and if you manage to lose the items as a result there is no way to get them back. You have been warned!
I downloaded this mod, and it worked brilliantly. Until yesterday that is, now suddenly when I try to make a new custom companion, it spawns outside the map, I cant talk to it, it cant go to camp. The companion commands dont work on the newly made character, but the already made characters still work fine. I was wondering if you know what's up?
Likely a conflict with another mod. Did you add any recently? This mod relies heavily on the script extender, which is itself somewhat fragile and can fall over and stop working if another mod does something it shouldn't.
If you want me to try and help, please post a script extender log or screenshot of your script extender window so I can look for error messages.
I think I found a soft incompatibility with Feats Extra, that gives a class action to every character called 'Dodge', that for the cost of an action let's you give disadvantage to attacks made against you for one turn. In my testing, only Tavs and vanilla hirelings receive this 'Dodge' action, characters created using Full Custom Companions don't receive them.
My best guess is that Feats Extra uses a tag or identifier to give the 'Dodge' action to player characters, and that identifier is not being created/copied on Full Custom Companions characters, so Feats Extra doesn't add the action to them because they don't know they're also a player character.
The rest of both mods is working as intended as far as I know, on Patch 7.
Thank you very much for this mod, it closes a huge gap that this game has in my opinion (creating more than one custom character).
You should probably report this to the author of the other mod.
Either they can tell me what my Companions are missing in order to me recognised by their mod, or they can use the tag mentioned in the sticky post above to correctly recognise them.
If you mean a character who looks like the Durge then you can do this yourself, just make a White Dragonborn companion with the same look; as far as I know there's nothing unique about him in looks.
A character who behaved like the Durge in terms of quest and story participation would be way outside the scope of this mod.
Just an FYI, this seems to mess with the mods that change Astarion, Wyll, and Gale into females. They have the issue where their male head is floating over female bodies in character creator. Removed this mod and everything for them went back to normal.
I'd like to report a bug for Sorcerers. No mods for Sorcerers were installed on my side.
- The option in Subclass section for Storm Sorcery is missing. - It's the only class that cannot assign +2/+1 points to their stats in the Abilities section. - Bug persists whenever existing Companion/Hireling approaches Withers and when you're making a new companion
The Companion in question is Human. Didn't try it on other races.
Alright, false alarm. Indeed I had a Sorcerer mod installed.
I realized that when making new Tav Sorcerer the issue occured, so that told me it's not the issue with the CC mod itself, but the class. It's fixed. Had to rewrite my own mod xD
hi, soo I get the items and the spells on start, but when I use the spell and select the target nothing happens. I got a lot of mods on, does anyone know of incompatible mods?
New computer, fresh install of BG3 + patch 7. All installed mods confirmed up to date with Patch 7. Companions mod installed, but the icon in the menu shows up as blank. I have script extender and ImpUI installed. I've tried placing this mod in various locations throughout my load order, but the icon still doesn't show properly. I haven't gone far enough to test if the mod works beyond that, just wanted to report the icon issue.
I was wondering if anyone was having this issue, I'm in patch 7 and the companion race shows up, but I don't get the items or spells, is there a way I can either give myself the items, or any fixes people know of?
I think I figured out what the issue is with me, I tried downloading a different mod that should do the same thing, but I think the issue is that any items/spells you should get that aren't tied to race/class don't appear, don't know if anyone has found a fix for that though
792 comments
0. Please make sure you are using the latest version before filing a bug report. It is also really helpful if bug reports include a script extender log or screenshot of the script extender window at the time the issue was encountered, along with as much information as possible to help me reproduce the bug. See the "Create Console" option in BG3 Mod Manager to make sure the script extender window is shown. Vague non-specific reports without supporting evidence are hard to act upon and may be ignored. Also, please use English when submitting bug reports.
1. If you close the character creation screen when making a Custom Companion you will return to the main menu and lose any unsaved progress. It will also mess up the character creation screen for the remainder of the game session. This behavior appears hard coded and I cannot work around it.
DO NOT TAUNT HAPPY FUN BALL.DO NOT CLOSE THE CHARACTER CREATION SCREEN.2. Creating a Custom Companion will disruptively open the character creation screen for everyone in multiplayer. This also appears hard coded. If using this mod in multiplayer you are advised to warn your friends before creating a Companion. Those players who are not creating a Companion should just click through without changing anything.
3. Using this mod along with Show Approval Ratings in Dialogue Choices (and possibly other similar mods) will cause text like "[Gale 1]" to be appended to some of the dialogue lines when talking to a Custom Companion, as if those lines were going to affect a vanilla follower's approval. This is a cosmetic issue only, caused by me recycling vanilla dialogue lines which then get edited by the other mod, and will not actually modify your other party members' approval.
4. Dragonborn Companions may have animation problems in dialogue. This is an underlying game issue and not in my power to fix, and probably explains why there are no Dragonborn hirelings. Please use the command spells instead of dialogue in this case.[/b]
5. It has been reported that using Mordenkainen's Fortuitous Friend Finder can somehow register as a total party kill for the purposes of Honor Mode. I have no idea why this would be, but I don't play Honor Mode and this mod was not made with it in mind, so you are advised to be careful.
Frequently Asked Questions
Q: Are you going to upload this to Larian's mod page? Will it be available on consoles?
A: Probably not because it makes use of the script extender to do things beyond what the official toolkit is capable of.
Q: I can't find the items or spells. How do I use this?
A: You probably didn't install the Script Extender properly. Go back and check that it is working.
Q: Can I make [insert favorite mod race here] and/or [insert favorite mod class here] Companions?
A: This mod uses the same character creation interface as creating a player character, so any combination of race/class including modded ones should work. Some may require Improved UI, so check that you have it installed and up to date. If you find something which doesn't work in terms of race/class mods then it's almost certainly going to need to be addressed by their creator. This mod doesn't do anything on the user interface side of things.
Q: Can I duplicate [insert favorite character here] ?
A: There are no restrictions on what you can target with the duplication spell/item, but the mod was made with "standard" humanoid characters in mind; think Lakrissa and Adrielle, not the Spider Matriarch or Ketheric Thorm. When it comes to "non-standard" things such as monsters, animals, mecha, boss enemies, etc you may run into missing animations and cases where unique special abilities do not copy over or are non-functional. Please do not be offended if I am not really interested in individually fixing issues with "non-standard" entities. Priority will be given to issues which affect "standard" humanoids or are game breaking.
Q: Is this compatible with [insert favorite mod here] ?
A: I run a relatively low-mod setup, mostly just cosmetic things like hair and outfits, so I probably don't know. Please try for yourself and tell me about incompatible mods. I will attempt to improve compatibility where possible in response to reports. See the known issues above for any specific known conflicts.
Q: Can I uninstall this mid-playthrough?
A: No, this mod is not safe to remove mid-playthrough. You are advised to take a clean save before evaluating the mod so that you can revert if you decide you do not wish to use it.
Q: Can you unbind the wand and mirror? They offend my sense of inventory tidiness.
A: Since v2.0.2.0 you can do this via the configuration file (see below) but you are on your own if you do so. I will not help you get back items lost by unbinding them.
Q: I am a mod maker. How can I recognise characters created by your mod?
A: Custom Companions, both created and duplicated, all carry the 7deac637-156c-435a-9059-a0dcc5d0ecf1 tag.
Q: Does this mod change the party size limit?
A: Yes and no. You may have an unlimited number of custom companions, but when you have 3 of them the base game companions will regard your party as full. If you want a fully unlocked party size mod, I recommend Party Limit Begone (SE version). Certain cutscenes may have issues with an oversized party. Before reporting such issues as being the fault of my mod, please check if you can reproduce the problem with a normal size party.
Q: Can I use this in multiplayer?
A: Yes, but I don't play multiplayer myself and my testing is limited to running two copies of the game on my own computer. Feedback regarding how it does or doesn't perform in a genuine networked environment is welcome!
Q: Can you add more dialogue?
A: Unlikely unless Larian makes it a lot easier in the official modding tools. Even just the tiny bit I did include was a huge pain with only a text editor to work with.
Q: What version of the game and script extender are supported?
A: As of writing, game patch 7 and script extender v20.
Q: Is this the same as [insert other popular mod here] ?
A: I made this mod to scratch a personal itch which other mods weren't reaching, and I felt pleased with the result so I thought I'd share it with the community. I'm not looking to get into a popularity contest and if you already have another mod which works for you then you won't need this one.
Q: I dismissed my companion! Can I get them back?
A: No. Dismissed companions are gone for good. Next time send them to your camp instead of to oblivion. ;)
Note that this is an advanced feature. If you are not comfortable locating and editing this kind of file then leave it alone. The default settings should be fine for most players!
The file will be created the first time you run the game with v2.0.2.0 or higher of the mod installed. It can then be found at:
"%LOCALAPPDATA%\Larian Studios\Baldur's Gate 3\Script Extender\CustomCompanions.json"
The syntax of the file must be preserved entirely. Change only the words true and false, nothing else.
The following options are accepted:
I downloaded this mod, and it worked brilliantly.
Until yesterday that is, now suddenly when I try to make a new custom companion, it spawns outside the map, I cant talk to it, it cant go to camp. The companion commands dont work on the newly made character, but the already made characters still work fine.
I was wondering if you know what's up?
Thanks in advance
If you want me to try and help, please post a script extender log or screenshot of your script extender window so I can look for error messages.
I think I found a soft incompatibility with Feats Extra, that gives a class action to every character called 'Dodge', that for the cost of an action let's you give disadvantage to attacks made against you for one turn. In my testing, only Tavs and vanilla hirelings receive this 'Dodge' action, characters created using Full Custom Companions don't receive them.
My best guess is that Feats Extra uses a tag or identifier to give the 'Dodge' action to player characters, and that identifier is not being created/copied on Full Custom Companions characters, so Feats Extra doesn't add the action to them because they don't know they're also a player character.
The rest of both mods is working as intended as far as I know, on Patch 7.
Thank you very much for this mod, it closes a huge gap that this game has in my opinion (creating more than one custom character).
Either they can tell me what my Companions are missing in order to me recognised by their mod, or they can use the tag mentioned in the sticky post above to correctly recognise them.
A character who behaved like the Durge in terms of quest and story participation would be way outside the scope of this mod.
Hey there.
I'd like to report a bug for Sorcerers. No mods for Sorcerers were installed on my side.
- The option in Subclass section for Storm Sorcery is missing.
- It's the only class that cannot assign +2/+1 points to their stats in the Abilities section.
- Bug persists whenever existing Companion/Hireling approaches Withers and when you're making a new companion
The Companion in question is Human. Didn't try it on other races.
But it's still valuable data you gave me; the mod is working fine.
I'll check what can be done on my side.
Indeed I had a Sorcerer mod installed.
I realized that when making new Tav Sorcerer the issue occured, so that told me it's not the issue with the CC mod itself, but the class.
It's fixed. Had to rewrite my own mod xD