Note: You do NOT need to do this unless you want to run configuration commands for the mod.
If you just want to use the mod with default settings: Skip all of this

Enabling the Script Extender Console:

* This article doesn't cover installation of the Script Extender
* If you can't figure out how to install it, just use BG3 Mod Manager ( [Link] ) and do 'Download & Extract the Script Extender' from its tools menu at the top.


Enabling the Script Extender Console:

If the 'ScriptExtenderSettings.json' file doesn't already exist in your BG3 bin folder, create a file with that name (exactly - NOT 'ScriptExtenderSettings.json.txt') and put these contents in it:

{
  "CreateConsole": true
}


If the 'ScriptExtenderSettings.json' file already exists in your BG3 bin folder, add this line. Note that if you get the commas between lines wrong (too few or too many), the file will not load.

"CreateConsole": true,


Using the Script Extender Console:
* If you've done the above steps correctly, a 2nd window should start with BG3 when you run it.
* This 2nd window will look kind of like a command prompt
* While the game is running, you can switch focus to this 2nd window and press return on your keyboard to enter the Lua Console input mode
* You can enter commands into this console now

Article information

Added on

Edited on

Written by

Kvalyr

155 comments

  1. Famwise
    Famwise
    • member
    • 1 kudos
    I added a text file to the bin and named it as you instructed and put 
    {
      "CreateConsole": true

    as instructed but there's no second window. What am I doing wrong?
    1. temp39285
      temp39285
      • member
      • 0 kudos
      Make sure the exact filename is "ScriptExtenderSettings.json" and doesn't end in ".txt" instead. You can make sure it saves with the right extension by putting quotes around the filename when saving. If you have the DWrite.dll file in the bin directory as well it should work.
    2. morniah
      morniah
      • member
      • 0 kudos
      I had the same issue! I used this free converter to convert my .txt file to .json (as Windows didn't do it automatically). After converting your file, make sure you remove ".json" from the file name (it will already be in the correct format). Basically your file should just be called "ScriptExtenderSettings".
    3. Raigyu
      Raigyu
      • supporter
      • 0 kudos
      You can also enable windows explorer to see filename extensions and edit it that way
    4. QuackerYu
      QuackerYu
      • member
      • 0 kudos
      Where do we add the 
      {
        CreateConsole true

      ?
      I made the Script Extender folder but i dont know what to put that code into
    5. epar
      epar
      • member
      • 0 kudos
      QuackerYu: in the ScriptExtenderSettings.json
    6. SomeMineral
      SomeMineral
      • member
      • 0 kudos
      I wish I knew how to make a .json file lmfao
    7. EtherealWarlock
      EtherealWarlock
      • supporter
      • 1 kudos
      I mean, it's not that many sentences... Do you people even read?
    8. Sugarimi
      Sugarimi
      • member
      • 0 kudos
      You are an absolute godsend. The simple action of just removing .json from the file name made it start working for me. THANK YOU!
    9. scbbc81
      scbbc81
      • member
      • 0 kudos
      There is no need for a program it's super simple to do.

      Open up File Explorer then View->Show-> File Name Extensions

      Right Click Desktop-> New -> Text Document

      Open up the new document with notepad (should be automatic on double click)

      Paste:

      {
        "CreateConsole": true
      }

      Save file and close

      Right Click file --> Show more options -> Rename (You might not need to click show more options on windows 10)

      Paste file name:
      ScriptExtenderSettings.json

      Windows will ask you something like if your sure you want to change the extension
      Click Yes

      For GOG move it to the bin folder where the game is installed - I am guessing Steam is similar.
    10. maramsp
      maramsp
      • premium
      • 13 kudos
      Hero @morniah !
      This worked like a charm!
    11. Bluepheonix135
      Bluepheonix135
      • member
      • 0 kudos
      @scbbc81 THIS WORKED THANK YOU!!!
    12. Octoberwaltz
      Octoberwaltz
      • member
      • 0 kudos
      Thank you sir!
    13. KaliCrush
      KaliCrush
      • member
      • 0 kudos
      Perfect instructions! Thank you!
    14. LadyMadam
      LadyMadam
      • member
      • 0 kudos
      this helped so much!!! though for me taking the .json out of the file name reverted it back into a regular file
    15. EHoop30
      EHoop30
      • member
      • 0 kudos
      The issue that I think most people are having is that windows is hiding the .txt file extension after you name the file, so it will be ScriptExtenderSettings.json.txt. To fix this, open up the file, click "Save As" and make sure to put quotes around the file name when saving e.g.: "ScriptExtenderSettings.json"

      No need to use free file converters or any other ad revenue generators lol
    16. Stormspirit3645
      Stormspirit3645
      • member
      • 0 kudos
      thank you all
    17. Stormspirit3645
      Stormspirit3645
      • member
      • 0 kudos
      thank you all
  2. 0010ng
    0010ng
    • member
    • 0 kudos
    HOW TO CREATE "ScriptExtenderSettings.json" WITHOUT MAKE IT TXT. ??
    1. Cawa425
      Cawa425
      • member
      • 0 kudos
      lmao skill issue
    2. Ziccat
      Ziccat
      • member
      • 0 kudos
      enable the display of file extensions in file explorer
  3. 0010ng
    0010ng
    • member
    • 0 kudos
    HOW TO CREATE "ScriptExtenderSettings.json" WITHOUT MAKE IT TXT. ??
  4. 0010ng
    0010ng
    • member
    • 0 kudos
    HOW TO CREATE "ScriptExtenderSettings.json" WITHOUT MAKE IT TXT. ??
  5. Ironshield98
    Ironshield98
    • member
    • 1 kudos
    Windows is probably throwing an extra .txt extension on the json file so the script extender doesn't see it. You can google how to change file explorer to show extensions.

    You don't have to make the json file, mod manager will do it for you.

    Settings>Open Preferences>Script Extender> Then check the create console box and click save!
    1. Jo747
      Jo747
      • member
      • 0 kudos
      Thank you random stranger!
      Worked better going through Mod Manager. Like people were mentioning, creating the file yourself results in a double file format.
    2. Dastantis
      Dastantis
      • member
      • 5 kudos
      Thanks. This is the official description.
  6. lowkeyhighkey2234
    lowkeyhighkey2234
    • member
    • 0 kudos
    I made a json file and pasted the contents and am met with,

    "Failed to load configuration file 'ScriptExtenderSettings.json':
    * Line 1, Column 1
    Syntax error: value, object or array expected"
  7. linehand
    linehand
    • member
    • 17 kudos
    The default file view setting in windows to hide, filename extensions... I mean, I always turn that off, but whoever even thought of making that a setting at all, much less setting it on by default -- there is a special place in hell.
    1. michaelmj11
      michaelmj11
      • member
      • 0 kudos
      It's for your grandma who goes through her computer and delete's/edits all her files to remove that weird junk at the end.

      I mean OBVIOUSLY it is supposed to be "Recipe's" not "Recipe's.txt"
  8. odinspearx
    odinspearx
    • supporter
    • 0 kudos
    How do you get the console into input mode? I can get the console to appear no problem, but I cannot click into it and enter any kind of input mode, no matter how many times I press enter.
    1. icassar
      icassar
      • supporter
      • 0 kudos
      Credit to Lyratcm, who pointed it out in an older comment, but the issue is probably Vortex. If you instead start the game directly from the .exe using administrator mode, it should work.
  9. lyratcm
    lyratcm
    • supporter
    • 3 kudos
    For those using vortex and having issues with not being able to type in the console, you can still launch the game through the exe (as administrator) and have your mods loaded. by doing that i was able to type in the console
    1. edwaja7
      edwaja7
      • premium
      • 0 kudos
      That worked! thanks.
    2. Citru5Kick
      Citru5Kick
      • member
      • 0 kudos
      Do u have pirated version?
      While i'm trying to do it i get launcher error bout mods

      nevermind, find out 
      EDIT: Ignore that pop out and press play in launcher.
      Game will load up and everything will be fine
    3. icassar
      icassar
      • supporter
      • 0 kudos
      Thank you, this worked!!
  10. AnerithDemonNeko
    AnerithDemonNeko
    • premium
    • 0 kudos
    idk what im doing wrong i followed the instructions to letter and i still cannot get the the window to appear
    1. TheoFromPoland
      TheoFromPoland
      • member
      • 0 kudos
      Same here :((