0. Please make sure you are using the latest version before filing a bug report. Reports should include as much context as possible to help me reproduce the issue and ideally also a script extender log. See the "Create Console" option in BG3 Mod Manager to make sure the script extender window is shown so that you can grab the information you need. Vague complaints without supporting evidence or questions already addressed in the FAQ below are likely to be ignored. Also please use English when communicating with me.
1. If you close the character creation screen when making a Custom Companion you will return to the main menu, lose any unsaved progress, and may find your game in an inconsistent state until you restart it. This is hard coded game behavior and I cannot change 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 is also beyond my ability to change. When 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 anyone's approval.
4. Dragonborn Companions may have animation problems in dialogue. This is an underlying game issue not in my power to fix, and probably explains why there are no Dragonborn hirelings.
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.
6. Custom Companions may sometimes use Dark Urge voice barks when attached to a Dark Urge player character. There is currently no known workaround for this issue.
Q: Does the version on mod.io replace this one? A: Absolutely not. It is a cut down alternative for people who can't or won't use the Script Extender. This version offers additional functionality such as NPC duplication.
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. If you are sure that it is working, post a bug report with a full Script Extender log.
Q: What version of the game and script extender are supported? A: As of writing, game patch 8 and script extender v24. While I have not gone out of my way to remove compatibility with previous game versions, I only run and test with patch 8 and offer no support for patch 7 and earlier.
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 Rolan, 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: No. Dialogue in this game is very hard to do (in my opinion) and I'm a scripting guy, not a cinematographer.
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.
StrictEndgame - default: true - Removes the wand, mirror, all Companion related spells, and prevents Companions from being dismissed after passing the point-of-no-return when entering the Morphic Pool. This replicates vanilla game behavior where your party is supposed to be fixed after this point. Disabling this will restore behavior from versions 2.2.0.4 and earlier. Be aware that dismissing a Companion to camp after the point-of-no-return means you can't get them back as there is no access to camp anymore.
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!
mate, as someone who is only just getting into modding, I've unpacked your mod and had a look at all the work that you've put into creating this - just wow! It seems like absolute wizardry to me (and genuinely inspirational).
I was thinking of trying to create an 'alter-ego' type mod piggy-backing off your own mod but I actually don't even know what to copy because it is all so far beyond me. The idea was to design a dummy character in CC that is then tied to a spell (i.e. like an extra option in the disguise self spell) that would allow players to disguise themselves as the dummy character from CC. Would allow for some pretty interesting RP stuff.
I am sure you're inundated with questions etc but I would love to pick your brain about where to start. I've been using Norbytes BG3 search engine and learned a lot about character's appearance but the whole CC thing is very intimidating to me!
I would make an absolutely terrible teacher in the general "teach me how to mod" sense, but if you have any specific questions about why I did something a certain way in the code then feel free to shoot me a DM and I'll do my best to answer, assuming I remember.
You might also want to keep a lookout for Moonglasses being updated for patch 8 and consider making your mod with native Osiris code in the toolkit rather than with the script extender. There was no toolkit when this I first made this mod, but looking back I see that I re-invented the wheel or did things the hard way a bunch of times compared to how it would have been in Osiris.
Thanks mate that's actually very helpful feedback already. I know your mod.io version doesn't use script extender -would I be better off looking into that one for how things are done?
It depends how quickly you want to get started, I guess. Moonglasses still hasn't been released for patch 8, unless you want to use a beta version which you can only get from the author's Discord.
You are welcome to look inside Custom Companions Lite as well for ideas though. Just credit me if you actually copy any of my code.
Thank you for a great mod Adriant! I was wondering what the requirements for having visible gear are? Can all humanoind characters like Isobel and Dame Aylin be made to show gear, or have you had to pick specific characters and modded them to be able to show gear?
Aylin I think is not eligible to show gear because she already special cased in the code to make her show up as resplendent Aylin and not the version in rags from the Shadowfell.
Мод просто бомба! Нет, серьезно! Мне очень нравится этот мод своей идеей создания своих наемников, но меня расстраивает одно, то, что NPC и игра в целом считают его наемником и не хотят разговаривать с этим персонажем практически во всех диалогах, по крайней мере напарники не хотят с ним разговаривать, потому что он не лидер группировки. В целом за мод респект, спасибо, но если будет возможность сделать его альтернативным игроком, то я был бы еще счастливее.
I have the latest version. I just started a new game, attempted to create a new companion. Got to the guardian stage of new creation, just pressed the venture forth button without doing anything on that page, and the game just sort of stops. I can pull up the main menu, but it never returns back to the game or creates my companion.
Hi - I don't think this mod is related to my issue. BUT, it might be and this is the only place to find out. I use this and PArty Limit Begone. In patch 6 there were places I'd CTD 9crash to desktop) and the only solution was drop my party size to 4 (not more) and then invite everone back later. Repeat next CTD. In patch 7 I finished multiple runs of 16 companions. (all base augmented by this mod. Now in patch 8, I'm bck to CTD in Chreche, the Last Light, Fighting Duegar and another place I don't remember. I've been able to get through with 6 this time.....
So, is anyone else seeing this. Is there ANY way you could see the game rejecting these companions? I'm checking in desperation and to help, if there is a connection.
If the answer is "can't be this mod", I'll edid my comment to say "Hi, Thank you"
1139 comments
0. Please make sure you are using the latest version before filing a bug report. Reports should include as much context as possible to help me reproduce the issue and ideally also a script extender log. See the "Create Console" option in BG3 Mod Manager to make sure the script extender window is shown so that you can grab the information you need. Vague complaints without supporting evidence or questions already addressed in the FAQ below are likely to be ignored. Also please use English when communicating with me.
1. If you close the character creation screen when making a Custom Companion you will return to the main menu, lose any unsaved progress, and may find your game in an inconsistent state until you restart it. This is hard coded game behavior and I cannot change 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 is also beyond my ability to change. When 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 anyone's approval.
4. Dragonborn Companions may have animation problems in dialogue. This is an underlying game issue not in my power to fix, and probably explains why there are no Dragonborn hirelings.
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.
6. Custom Companions may sometimes use Dark Urge voice barks when attached to a Dark Urge player character. There is currently no known workaround for this issue.
Q: Does the version on mod.io replace this one?
A: Absolutely not. It is a cut down alternative for people who can't or won't use the Script Extender. This version offers additional functionality such as NPC duplication.
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. If you are sure that it is working, post a bug report with a full Script Extender log.
Q: What version of the game and script extender are supported?
A: As of writing, game patch 8 and script extender v24. While I have not gone out of my way to remove compatibility with previous game versions, I only run and test with patch 8 and offer no support for patch 7 and earlier.
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 Rolan, 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: No. Dialogue in this game is very hard to do (in my opinion) and I'm a scripting guy, not a cinematographer.
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 was thinking of trying to create an 'alter-ego' type mod piggy-backing off your own mod but I actually don't even know what to copy because it is all so far beyond me. The idea was to design a dummy character in CC that is then tied to a spell (i.e. like an extra option in the disguise self spell) that would allow players to disguise themselves as the dummy character from CC. Would allow for some pretty interesting RP stuff.
I am sure you're inundated with questions etc but I would love to pick your brain about where to start. I've been using Norbytes BG3 search engine and learned a lot about character's appearance but the whole CC thing is very intimidating to me!
You might also want to keep a lookout for Moonglasses being updated for patch 8 and consider making your mod with native Osiris code in the toolkit rather than with the script extender. There was no toolkit when this I first made this mod, but looking back I see that I re-invented the wheel or did things the hard way a bunch of times compared to how it would have been in Osiris.
You are welcome to look inside Custom Companions Lite as well for ideas though. Just credit me if you actually copy any of my code.
Aylin I think is not eligible to show gear because she already special cased in the code to make her show up as resplendent Aylin and not the version in rags from the Shadowfell.
Great mod! I love the idea of an eldritch knight squirrel
Was there any place in particular you had this problem?
I found the offending mod. The Class Mod Old Growth Druid breaks this mod.
So, is anyone else seeing this. Is there ANY way you could see the game rejecting these companions? I'm checking in desperation and to help, if there is a connection.
If the answer is "can't be this mod", I'll edid my comment to say "Hi, Thank you"