---
title: "CLUA Console"
---
    <div class="title_main"> CLUA Console</div> 
    <br />
    <ul>
      <li><a href="#enable"> Enabling / Accessing the CLUA Console</a></li>
      <li><a href="#keys"> Cheat Keys </a></li>
      <li><a href="#commands"> Commands </a></li>
    </ul>
  
  <div id="enable">
    <br />
    <strong>Activating the Console in BG(2): EE</strong><br />
    <div class="indent1">
      Enable (before patch v2.0)<br />
      <div class="indent1">
        Open the Baldur.ini file (located in the 'Documents\Baldur's Gate - Enhanced Edition' directory). <br />
        Find the line <span class="highlight"> INSERT INTO options ROWS ( </span> and add the text <span class="highlight"> 'Program Options',	'Debug Mode',	'1', </span> underneath. <br />
      </div>
      Enable (patch v2.0 or later)<br />
      <div class="indent1">
        Open the Baldur.lua file (located in the 'Documents\Baldur's Gate - Enhanced Edition' directory). <br />
        Add the line <span class="highlight">SetPrivateProfileString('Program Options','Debug Mode','1')</span> to it. <br />
      </div>
      Access <br />
      <div class="indent1">
        Create a new game / load a save game.<br />
        Press <span class="highlight"> ctrl </span> and <span class="highlight"> space </span> together.<br />
        CLUA commands can be entered in the editing area that appears at the bottom of the screen.<br />
        Commands must be prefixed with <span class="highlight"> CLUAConsole: </span> (before patch v2.0) or <span class="highlight"> C: </span> (since patch v2.0 and possibly before).<br />
      </div>
      <br />
    </div>
  </div>
  
  <div id="keys">
    <br />
    <strong> Cheat Keys</strong><br />
    <div class="indent1">
      After using the CLUAConsole:EnableCheatKeys() command the following cheat keys are activated.<br />
      <div class="indent1">
        CTRL+1 &nbsp;&nbsp; Change armor level animation<br />
        CTRL+2 &nbsp;&nbsp; Fade screen to black<br />
        CTRL+3 &nbsp;&nbsp; Fade screen to normal<br />
        CTRL+4 &nbsp;&nbsp; Highlight background-interactive objects<br />
        CTRL+5 &nbsp;&nbsp; Displays animation information<br />
        CTRL+6 &nbsp;&nbsp; Change avatar animation previous<br />
        CTRL+7 &nbsp;&nbsp; Change avatar animation next<br />
        CTRL+A &nbsp;&nbsp; Animation avatar (see CTRL+S)<br />
        CTRL+C &nbsp;&nbsp; Runs NALIAND epilogue<br />
        CTRL+E &nbsp;&nbsp; Alters visual range <br />
        CTRL+F &nbsp;&nbsp; Turn the character<br />
        CTRL+G &nbsp;&nbsp; Display list of areas loaded in cache<br />
        CTRL+I &nbsp;&nbsp; Selects animation (see CTRL+L). Can force banters. <br />
        CTRL+J &nbsp;&nbsp; Teleport to cursor position<br />
        CTRL+K &nbsp;&nbsp; Creature under cursor kick out party<br />
        CTRL+L &nbsp;&nbsp; Plays animation (selected by CTRL+I)<br />
        CTRL+M &nbsp;&nbsp; (Followed by ENTER) Debug Dump (if [Game Options] Wild Surge Keys = 1)<br />
        CTRL+O &nbsp;&nbsp; (Followed by ENTER) Write Debug Dump to log file (if [Program Options] Logging On = 1)<br />
        CTRL+P &nbsp;&nbsp; Keep screen centred on selected character<br />
        CTRL+Q &nbsp;&nbsp; Creature under cursor joins party<br />
        CTRL+R &nbsp;&nbsp; Heals character under cursor<br />
        CTRL+S &nbsp;&nbsp; Select avatar animation<br />
        CTRL+T &nbsp;&nbsp; Advance game time 1 hour<br />
        CTRL+U &nbsp;&nbsp; Temporarily highlight Doors + Ground Objects<br />
        CTRL+X &nbsp;&nbsp; Extended position information<br />
        CTRL+Y &nbsp;&nbsp; Kills creature under cursor<br />
      </div>
      <br />
        The EEs also support pressing CTRL or SHIFT to display the dynamic or static searchmap respectively, as an overlay. You have to enable that first by adding these keys to Baldur.lua:
        <div class="indent1 highlight">
            SetPrivateProfileString('Game Options','Render Search Map','1')         -- press SHIFT key to display overlay<br />
            SetPrivateProfileString('Game Options','Render Dynamic Search Map','1') -- press CTRL key to display overlay
        </div>
    </div>
  </div>
  
  <div id="commands">
    <br />
    <strong> Using the Console</strong>
    <div class="indent1">
      Commands <br />
      <div class="indent1">
      AddGold(&lt;int&gt;)<br />
      <div class="indent1">
        Adds the gold specified by &lt;int&gt; to the party.
      </div>
      AddSpell("&lt;string&gt;")<br />
      <div class="indent1">
        Adds the spell specified by &lt;string&gt; to the selected character.
      </div>
      AdvanceRealTime(&lt;int&gt;)<br />
      <div class="indent1">
        Advances the in-game 'real time' counter.
      </div>
      CreateEngine(&lt;int&gt;)<br />
      <div class="indent1">
        Unknown - seems to start a new single (0) or multi (1) player game.
      </div>
      CreateCreature("&lt;string&gt;")<br />
      <div class="indent1">
        Creates the creature specified by &lt;string&gt;.
      </div>
      CreateItem("&lt;string&gt;",&lt;int1&gt;,&lt;int2&gt;,&lt;int3&gt;)<br />
      <div class="indent1">
        Creates the item specified by &lt;string&gt;.<br />
        The parameters control the amount/charges of the item.
      </div>
      CreateVEFVidCell("&lt;string&gt;")<br />
      <div class="indent1">
        Plays the VVC specified by specified by &lt;string&gt;.<br />
      </div>
      DisplayAllBAMFiles()<br />
      <div class="indent1">
        Plays all graphic files in order.<br />
      </div>
      DisplayText("&lt;string&gt;")<br />
      <div class="indent1">
        Displays the text specified by &lt;string&gt;.<br />
      </div>
      Eval(&lt;string&gt;,&lt;int&gt;)<br />
      <div class="indent1">
        Executes the script action specified by &lt;string&gt;.<br />
        The whole string can be enclosed into single quotes (') so that double quotes<br />
        can still be used within the script action.<br />
        An optional numeric parameter specifies the active party member for the script action.<br />
        The parameter expects the portrait slot index, starting with 0 for the first party member.<br />
      </div>
      Exec(&lt;string&gt;)<br />
      <div class="indent1">
        Executes all clua commands contained in the text file specified by &lt;string&gt;.<br />
      </div>
      EnableCheatKeys(&lt;int&gt;)<br />
      <div class="indent1">
        Enables (1) or disables (0) cheat keys, based on the value of &lt;int&gt;.
      </div>
      ExploreArea()<br />
      <div class="indent1">
        Explores the current area.
      </div>
      GetGlobal("&lt;string&gt;","&lt;string2&gt;")<br />
      <div class="indent1">
        Displays the variable specified by &lt;string1&gt; (of type &lt;string2&gt;).
      </div>
      LogMessages(&lt;int&gt;)<br />
      <div class="indent1">
        Enables logging of game messages?.
      </div>
      LogSet("&lt;string&gt;")<br />
      <div class="indent1">
        Filename to log message to?.
      </div>
        MoveToArea("&lt;string&gt;")<br />
      <div class="indent1">
        Move the selected characters to the area specified by &lt;string&gt;.
      </div>
      PlayMovie("&lt;string&gt;")<br />
      <div class="indent1">
        Plays the movie specified by &lt;string&gt;.
      </div>
      PlaySound("&lt;string&gt;")<br />
      <div class="indent1">
        Plays the sound specified by &lt;string&gt;.
      </div>
      SetCurrentXP("&lt;int&gt;")<br />
      <div class="indent1">
        Sets the XP of the selected character to &lt;int&gt;.
      </div>
      SetDisableBrightest<br />
      <div class="indent1">
        Unknown - probably related to water alpha levels :)
      </div>
      SetGlobal("&lt;string1&gt;","&lt;string2&gt;",&lt;int&gt;)<br />
      <div class="indent1">
        Sets the variable specified by &lt;string1&gt; (of type &lt;string2&gt;) to the value of &lt;int&gt;.
      </div>
      SetLimitTransparency(&lt;int&gt;)<br />
      <div class="indent1">
        Unknown.
      </div>
      SetWaterAlpha(&lt;int&gt;)<br />
      <div class="indent1">
        Unknown - probably related to water alpha levels :)
      </div>
      SetWeather(&lt;int&gt;)<br />
      <div class="indent1">
        Sets the current weather.
      </div>
      StartStore("&lt;string&gt;")<br />
      <div class="indent1">
        Starts the store specified by &lt;string&gt;</span>.
      </div>
      StrrefOn()<br />
      <div class="indent1">
        Strings are displayed with their associated strref numbers.<br />
      </div>
      StrrefOff()<br />
      <div class="indent1">
        Strings are not displayed with their associated strref numbers.<br />
      </div>
      TestAllDialog()<br />
      <div class="indent1">
        Lists all dialog file in the game, and checks for errors.<br />
      </div>
      WriteScript(&lt;string&gt;)<br />
      <div class="indent1">
        Output scripts into the directory specified by &lt;string&gt;. <br />
        Place mouse cursor of creature to evaluate scripts attached to that creature.<br />
        Otherwise it will evaluate area scripts.<br />
      </div>
      Eval('RegainRangerHood()')<br />
      <div class="indent1">
        Removes the "Fallen Ranger" status from the selected character.<br />
      </div>
      Eval('RegainPaladinHood()')<br />
      <div class="indent1">
        Removes the "Fallen Paladin" status from the selected character.<br />
      </div>
      </div>
      </div>
      <br />
      NB. While the console is enabled, the following cheat is also enabled.<br />
      At the stat distribution screen, pressing CTRL+8 will yield maximum stat value.<br />
    </div>
  </div>
</div>