BG3 Script Extender – Download Baldur’s Gate 3 Script Extender

Overview of Baldur’s Gate 3 (BG3)

Baldur’s Gate 3 (BG3) is an acclaimed role-playing game (RPG) developed by Larian Studios, best known for their work on the Divinity: Original Sin series. Released in 2020 as part of the long-running Baldur’s Gate franchise, BG3 is set in the Dungeons & Dragons (D&D) universe, bringing players into a richly detailed world filled with deep storytelling, tactical combat, and a broad range of choices that shape the game’s narrative. Players can create custom characters, explore vast landscapes, and engage in turn-based battles using the D&D 5th Edition rule set, making it a highly engaging experience for fans of role-playing games.

The game’s narrative is heavily choice-driven, with numerous branching paths that lead to multiple endings, making every decision feel impactful. BG3 emphasizes role-playing freedom and tactical gameplay, which has captivated fans of both RPGs and D&D. As with many RPGs, modding has become an integral part of the BG3 community, allowing players to expand and tailor their experience.

Introduction to Script Extender (SE)

In the world of modding, Script Extenders (SEs) play a pivotal role. A Script Extender is a tool or plugin that expands the scripting capabilities of a game, enabling deeper customization and more complex modifications. For games like BG3, the Script Extender works by allowing the game to execute custom scripts, effectively bypassing or extending the limitations set by the game’s base engine.

The Baldur’s Gate 3 Script Extender (BG3SE) specifically allows modders to enhance their mods by unlocking additional scripting options that aren’t available in the base game. With BG3SE, modders can access more powerful tools for altering gameplay, adding new mechanics, or even integrating entirely new features that enhance the player’s experience.

Importance of SE in Enhancing Gameplay

BG3SE is vital for modders who want to push the boundaries of what BG3 can offer. While Larian Studios has provided an excellent base game with robust mechanics, there are certain limitations in what modders can achieve without the Script Extender.

For instance, without BG3SE, mods are largely confined to surface-level changes like adding items, modifying character appearances, or altering basic gameplay variables. However, with the Script Extender, modders can:

• Introduce new mechanics that weren’t possible in the base game.
• Create more sophisticated AI behavior for companions or enemies.
• Expand on UI elements to improve player control and accessibility.
• Implement quality-of-life improvements such as enhanced camera controls or inventory management systems.

Some examples of popular mods that rely on BG3SE include mods that allow for larger party sizes, real-time combat systems, or expanded customization options for character progression. These types of mods would be impossible to implement without the additional scripting capabilities provided by the Script Extender.

In short, BG3SE not only enhances the modding community’s ability to create more diverse and ambitious mods but also allows players to experience BG3 in new and innovative ways. For modders, it provides the tools needed to stretch the game’s potential; for players, it offers access to a more dynamic and customized gameplay experience that can cater to a wide variety of playstyles.

What is the BG3 Script Extender?

The Baldur’s Gate 3 Script Extender (BG3SE) is a modding tool designed to extend the scripting capabilities of Baldur’s Gate 3. At its core, BG3SE acts as a bridge between the game’s engine and custom mods, allowing modders to break free from the limitations of the base game’s scripting framework. With this tool, the community can craft deeper, more complex mods that go beyond cosmetic changes, offering enhanced gameplay experiences, new mechanics, and immersive modifications that wouldn’t otherwise be possible.

Without BG3SE, modding the game is like having access to a toolbox with only a few basic tools—sufficient for making surface-level changes, but not enough for the intricate work modders often envision. BG3SE opens that toolbox wide, providing access to more advanced tools that enable creativity to flourish. For both players and creators, it enriches the game by expanding what can be accomplished within its digital world.

Key Features of the Script Extender

The BG3 Script Extender comes packed with essential features that make it a cornerstone for modders who want to push the boundaries of Baldur’s Gate 3:

• Extended Scripting Capabilities: BG3SE allows for more advanced scripting by enabling access to additional functions and data structures not available in the base game. This means modders can write custom scripts that interact with deeper game mechanics, enabling features like dynamic events, complex dialogues, or new AI behaviors.
• Integration with Existing Mods: Many of the most popular mods for BG3 depend on BG3SE to function. These include mods that expand party size limits, introduce new spells, or even overhaul core gameplay elements like combat or crafting systems.
• Support for New Mechanics and Systems: Whether it’s adding real-time combat options or designing custom spells and abilities, BG3SE offers the foundation for creating entirely new systems. With this power, modders can introduce features that might feel like they came from a future patch or DLC from the developers themselves.
• Ongoing Updates and Community Support: The developers behind BG3SE are continually improving the tool, adding new functions and fixing bugs to ensure compatibility with the latest versions of the game. The tool’s continued evolution is backed by an active community that shares insights, tutorials, and collaborative projects.

Lua and Osiris Scripting Support

One of the most powerful features of BG3SE is its support for Lua and Osiris scripting languages. These are the same scripting languages used by the developers at Larian Studios, making them incredibly versatile for modders.

• Lua Scripting: Lua is a lightweight and easy-to-learn scripting language commonly used in game development for logic and interaction. In BG3, Lua can be used to create complex character behaviors, dialogue trees, and custom event triggers. With BG3SE, modders can expand these Lua scripts, introducing new gameplay elements or tweaking existing mechanics to suit their vision.
• Osiris Scripting: Osiris is more advanced and focuses on game logic, particularly in how quests, events, and triggers are handled. BG3SE allows modders to utilize Osiris scripting to create custom quests, define more intricate game rules, or even create new storylines that seamlessly integrate into the game’s narrative. It’s an invaluable tool for anyone looking to go beyond basic modding and dive into the deep mechanics of the game world.

API Documentation Availability

For any tool to be effective, clear and comprehensive documentation is essential—and BG3SE does not disappoint in this regard. The API documentation for BG3SE is readily available online, giving modders a detailed roadmap of all available functions, features, and scripting options they can use. This documentation is regularly updated as new features are added to the Script Extender.

The availability of this documentation makes it easier for modders to experiment, troubleshoot, and develop their mods with confidence. It provides clear instructions on how to use Lua and Osiris scripting within the BG3 framework and details on how to interact with the core functions of the game. Moreover, the documentation is often accompanied by community-driven guides and tutorials that help modders at all skill levels—whether you’re just starting out or you’re a veteran creator looking to push the boundaries of the game’s engine.

Compatibility and Support

Understanding the compatibility of the BG3 Script Extender (BG3SE) is essential for ensuring a smooth modding experience. Here’s what you need to know about supported platforms, console limitations, and compatibility with game patches and updates.

Supported Platforms

• Windows:
  BG3SE is fully supported on Windows, making it the most popular platform for modding Baldur’s Gate 3. The installation process is straightforward, and most modding tools, including BG3 Mod Manager (BG3MM), are primarily designed for Windows users.
• Linux:
  BG3SE also offers support for Linux users. The installation process may differ slightly, especially when adjusting permissions and configuring launch options. However, dedicated Linux modding communities provide resources and assistance for users on this platform.
• Mac OS:
  As of now, there is limited support for Mac OS. The BG3 Script Extender and many mods may not function correctly or be compatible with the game on Mac systems. Users may want to keep an eye on updates from the community or Norbyte’s GitHub for potential future support.

Limitations Regarding Consoles

• PlayStation and Xbox:
  Unfortunately, the BG3 Script Extender is not available for console platforms, including PlayStation and Xbox. This limitation is largely due to the restrictions imposed by these consoles on modding. As such, players on these platforms cannot utilize BG3SE or any of the extensive modding capabilities available to PC users.
• Future Possibilities:
  While some games have begun to support modding on consoles, it’s uncertain whether Baldur’s Gate 3 will follow suit. Players interested in modding should consider playing the game on PC or Linux for the full experience.

Compatibility with Game Patches and Updates

• Regular Updates:
  The BG3 Script Extender is actively maintained and updated to remain compatible with the latest patches and updates released for Baldur’s Gate 3. Whenever Larian Studios releases a new game update, users should check for a corresponding update for BG3SE on Norbyte’s GitHub.
• Version Mismatch Issues:
  After a game update, there may be a short period during which BG3SE is not compatible. This is common in the modding community and usually resolved quickly as developers work to update the Script Extender. During this time, users might experience errors or issues loading mods that rely on BG3SE.
• Best Practices for Modding:
  To ensure a smooth experience:
  • Always back up your save files before updating the game.
  • Check the modding community and Norbyte’s GitHub for announcements regarding updates to BG3SE after a new game patch.
  • Temporarily disable mods until compatible versions are available, particularly after significant game updates.

By understanding the compatibility landscape of BG3SE, you can better navigate your modding experience and stay informed about any potential limitations or updates that may affect your gameplay. Happy modding!

BG3 Script Extender – Installation (Comprehensive Guide)

Installing the Baldur’s Gate 3 Script Extender (BG3SE) might seem daunting if you’re new to modding, but with the right guidance, it’s a straightforward process. Whether you choose to install BG3SE via a mod manager or manually, here’s how you can get everything up and running smoothly.

Installing via BG3 Mod Manager (BG3MM)

The easiest and most popular way to install BG3SE is by using the BG3 Mod Manager (BG3MM). This tool simplifies the process by managing all your mods in one place, making installation and updates hassle-free.

Steps for Installation:

1. Download BG3 Mod Manager (BG3MM):
   • First, download the latest version of BG3 Mod Manager from a trusted source like Nexus Mods.
2. Install BG3 Mod Manager:
   • Once downloaded, install BG3MM on your system by following the setup instructions.
3. Download BG3SE:
   • Head to Norbyte’s GitHub repository, where you can find the latest version of the BG3 Script Extender.
4. Add BG3SE to BG3MM:
   • Open BG3 Mod Manager, and under the “Mods” tab, drag and drop the BG3SE files into the window.
   • Ensure that the Script Extender appears under “Active Mods.”
5. Activate BG3SE:
   • After adding BG3SE to the Mod Manager, click the “Export Order to Game” button to ensure BG3SE is activated within the game’s mod files.
6. Launch BG3:
   • Start the game through the Mod Manager or directly via Steam. The BG3SE should now be functioning, allowing mods to take full advantage of the extended scripting capabilities.

Troubleshooting Common Issues:

• BG3SE Not Recognized by BG3MM:
  • Ensure that you’re using the latest version of both BG3MM and BG3SE. Outdated versions can lead to compatibility issues.
  • Double-check that you’ve placed the BG3SE files in the correct mod folder within BG3MM.
• Game Not Loading Mods:
  • Make sure you’ve clicked the “Export Order to Game” button in BG3MM. Without this step, the game might not recognize the mods.
  • Ensure your mod load order is correct—this can be adjusted within BG3MM.
• Game Crashing After Installing BG3SE:
  • Try disabling other mods to determine if there’s a conflict with one of them. Some mods may not work well together or with the Script Extender.

Manual Installation

If you prefer to install the Script Extender manually, it’s still a relatively simple process. Here’s a step-by-step guide for manual installation:

Downloading from Norbyte’s GitHub:

1. Visit Norbyte’s GitHub Page:
   • Go to Norbyte’s GitHub repository where the BG3SE is hosted.
2. Download the Latest Release:
   • Look for the latest release of BG3SE and download the zipped file. Be sure to choose the correct version for your game (e.g., Windows or Linux).

Extracting Files to the Appropriate Directory:

3. Locate Your BG3 Installation Folder:
   • For Steam users, you can find the installation folder by right-clicking on Baldur’s Gate 3 in your Steam library, selecting “Properties,” going to the “Installed Files” tab, and clicking “Browse.”
4. Extract BG3SE Files:
   • Unzip the BG3SE file you downloaded. You’ll want to extract the contents directly into the bin folder of the BG3 installation directory.
   • For Windows, the path typically looks like this:
     C:\Program Files (x86)\Steam\steamapps\common\Baldur's Gate 3\bin
   • Ensure the Script Extender files (e.g., DXGI.dll) are placed in this folder.
5. Verify Installation:
   • After extracting the files, launch BG3. You can confirm BG3SE is working by checking if mods that depend on the Script Extender are functioning properly.

Windows Installation Path:

For those on Windows, the default installation path of BG3 is:

C:\Program Files (x86)\Steam\steamapps\common\Baldur's Gate 3\

You’ll need to extract the Script Extender files into the bin folder within this directory.

Linux Installation Instructions:

Installing BG3SE on Linux is a bit different, but still manageable. Here’s how you can do it:

1. Download BG3SE for Linux:
   • On Norbyte’s GitHub, download the Linux version of BG3SE (if available). If there’s no dedicated Linux version, the general version should still work.
2. Locate BG3 Installation Folder:
   • The path for Steam games on Linux is generally: /home/<YourUsername>/.steam/steam/steamapps/common/Baldur's Gate 3/
3. Extract BG3SE Files:
   • Extract the Script Extender files and move them into the bin folder within your BG3 installation directory.
4. Adjust Permissions:
   • Ensure the extracted files have executable permissions. You can do this by right-clicking the file, selecting “Properties,” and checking the “Allow executing file as program” box.

Launch Options for Steam (Linux/Steam Deck):

To ensure BG3SE runs correctly on Linux or Steam Deck, you may need to modify the launch options for the game within Steam:

1. Open Steam:
   • Go to your Steam library, right-click on Baldur’s Gate 3, and select “Properties.”
2. Set Launch Options:
   • Under the “General” tab, find the “Launch Options” field.
   • Add this line:bashCopy codeWINEDLLOVERRIDES="dxgi=n" %command%
   • This command tells the system to use the Script Extender’s custom DXGI.dll instead of the default Wine version.
3. Launch BG3:
   • Start Baldur’s Gate 3 as usual. If everything is set up correctly, the Script Extender should now work seamlessly with the game.

Common Issues and Troubleshooting

While installing and using the BG3 Script Extender (BG3SE) is typically straightforward, it’s common to encounter issues, especially for those new to modding. Here’s a breakdown of common error messages and problems you might run into, along with practical solutions to help you get back on track.

Error Messages and Their Meanings

1. Error: “BG3SE.dll not found” or “dxgi.dll not found”What it means:
   This error typically occurs when the Script Extender files (such as dxgi.dll) haven’t been placed in the correct directory or weren’t extracted properly.
   • Solution:
     • Ensure that you’ve extracted the BG3SE files directly into the bin folder inside your BG3 installation directory. For most users, the path looks like: C:\Program Files (x86)\Steam\steamapps\common\Baldur's Gate 3\bin
     • Double-check that the files are in the right folder and try launching the game again.
2. Error: “Incompatible version” or “Version mismatch between BG3 and Script Extender”What it means:
   This error suggests that the version of BG3SE you’re using isn’t compatible with the current version of Baldur’s Gate 3. It’s common after a game update when BG3SE hasn’t yet been updated to match.
   • Solution:
     • Visit Norbyte’s GitHub to check for a new version of BG3SE. Download and install the updated version to ensure compatibility with the latest BG3 patch.
     • If a new version of BG3SE isn’t available yet, you may need to disable mods that rely on the Script Extender temporarily until a compatible version is released.
3. Error: “Mods not loading” or “Script Extender not detected”What it means:
   This error usually means that BG3SE hasn’t been properly recognized by the game, and therefore the mods that depend on it aren’t being loaded.
   • Solution:
     • If using BG3 Mod Manager (BG3MM), make sure you’ve clicked the “Export Order to Game” button. This step is crucial for ensuring that BG3SE and any mods are properly loaded.
     • For manual installation, confirm that the dxgi.dll file is in the bin folder and that you’re launching the game correctly.
     • If you’re playing on Linux or Steam Deck, ensure the launch options are set properly with the WINEDLLOVERRIDES command (explained in the installation section).
4. Error: “Script Extender crashed” or “BG3SE has stopped working”What it means:
   This error occurs when the Script Extender encounters an issue during gameplay. It could be caused by an incompatible mod, corrupted files, or a conflict between BG3SE and the game’s version.
   • Solution:
     • Disable mods one by one to identify if a specific mod is causing the crash. Some mods might not be compatible with the latest version of BG3SE or the game itself.
     • Reinstall BG3SE to ensure no files were corrupted during the initial installation.
     • Make sure your game and all mods are up-to-date and compatible with the Script Extender.

Solutions for Common Problems Encountered During Installation or Use

1. BG3SE Not Working After Game Update:Problem: After a Baldur’s Gate 3 update, the Script Extender stops working, and mods that rely on it aren’t being loaded.
   • Solution:
     • Check Norbyte’s GitHub or the modding community forums for an updated version of BG3SE. When the game updates, BG3SE often needs to be updated as well.
     • If no update is available yet, you can disable the Script Extender-dependent mods and play the game without them until a fix is released.
2. BG3MM Fails to Recognize BG3SE:Problem: BG3 Mod Manager isn’t showing BG3SE in the list of active mods, or mods aren’t working even after installing BG3SE.
   • Solution:
     • Ensure that BG3SE has been properly placed in the mod folder within BG3MM.
     • Check the mod order and make sure BG3SE is listed first or in the correct position according to the mod’s instructions.
     • If the issue persists, reinstall both BG3MM and BG3SE to resolve potential file conflicts.
3. Game Crashes When Loading Mods:Problem: BG3 crashes upon loading mods, especially after adding new ones that require BG3SE.
   • Solution:
     • Disable the most recent mod you added to identify if it’s causing a conflict.
     • Verify that all mods are up to date and compatible with the current version of BG3 and BG3SE.
     • If disabling a mod resolves the issue, check the mod page for any known conflicts or troubleshooting advice.
     • Clear the mod cache by deleting the Mods folder inside the BG3 installation directory and reinstalling your mods.
4. Performance Drops or Game Freezes After Installing BG3SE:Problem: The game slows down or freezes during gameplay after installing BG3SE and related mods.
   • Solution:
     • Reduce the number of active mods to see if one is causing performance issues.
     • Ensure your hardware meets the recommended requirements for BG3 and that no background processes are overloading your system.
     • Some mods may be more resource-intensive, especially those that expand party size or introduce complex new mechanics. Try disabling those mods first to see if performance improves.

Additional Resources

Exploring the world of modding with the BG3 Script Extender (BG3SE) can be an exciting journey, especially with the wealth of resources available to help you along the way. Whether you’re looking for official documentation, community forums, or tutorials, this section will point you in the right direction.

Links to Official Documentation and Community Forums

• Official BG3 Script Extender Documentation:
  For comprehensive guides on using BG3SE, its features, and scripting capabilities, head to the official BG3 Script Extender documentation. This resource provides detailed explanations and examples to help you understand the tool better.
• Norbyte’s GitHub Repository:
  Keep up with the latest updates, releases, and discussions on BG3SE at Norbyte’s GitHub. This is the central hub for downloading the Script Extender and accessing its source code.
• Larian Studios Community Forums:
  Engage with fellow players and modders on the official Larian Studios forums. This is a great place to ask questions, share your experiences, and get insights from others in the community.
• Reddit Community:
  The Baldur’s Gate 3 subreddit is another excellent resource for discussions about modding, troubleshooting tips, and sharing user-generated content. The community is active and often provides helpful advice.

Tutorials and Guides for Advanced Users

• Modding Tutorials on YouTube:
  Video tutorials can be an effective way to learn. Channels like KageMitsu and Furrypaws offer in-depth guides on using BG3SE, creating mods, and implementing complex scripting techniques. Search for “Baldur’s Gate 3 Script Extender tutorial” on YouTube for a variety of visual guides.
• BG3 Modding Discord Servers:
  Joining a Discord server dedicated to BG3 modding can provide real-time assistance and a community of like-minded individuals. The Baldur’s Gate 3 Modding Community Discord is an active hub where you can ask questions, share your work, and collaborate on projects.
• Written Guides on Modding Websites:
  Websites like Nexus Mods often have user-created guides detailing various modding processes. Look for modding tutorials specific to BG3SE on platforms like Nexus Mods, where experienced modders share their knowledge and techniques.
• Scripting Reference Guides:
  For those interested in diving deeper into Lua and Osiris scripting, refer to resources like the Lua official website for documentation on the Lua language, or seek out community-contributed Osiris scripting references that specifically cater to Baldur’s Gate 3.

By leveraging these resources, you can enhance your modding experience with BG3SE, troubleshoot issues, and explore the creative possibilities that the Baldur’s Gate 3 community has to offer. Happy modding!