
     .   ,              ,-. .                     
     |\ /|             /    |                     
     | V | ,-. ,-. ;-. | -. | ,-: ,-. ,-. ,-. ,-. 
     |   | | | | | | | \  | | | | `-. `-. |-' `-. 
     '   ' `-' `-' ' '  `-' ' `-` `-' `-' `-' `-' 
    
             MoonGlasses version 1.2.0.433
    -- Baldurs Gate 3 Toolkit through a new lens -- 
    Join our Discord: https://discord.gg/Y7T8q4e8UE

# Installation from base Toolkit (Glasses)

1. Download the files (Well done!)
2. Run unlock.bat, this unblocks all the .dll files that Windows complains about
3. Extract dxgi.dll file and MoonGlasses Folder into `Baldurs Gate 3 Toolkit` folder. (steamapps\common\Baldurs Gate 3 Toolkit)
4. Run the editor. If it crashes, the .dlls may be blocked, still. Right click them and go to properties. On the bottom make sure it doesn't say they're blocked.
5. If you're still crashing, please uninstall the editor, make sure the folder is empty, reinstall it, then try again.

# Update to 1.2 from previous Versions

1. Verify your files on Steam (Right-Click on BG3 Toolkit and select 'Properties', then navigate to Installed Files and click 'Verify integrity of game files')
2. Remove MoonGlasses folder from `Baldurs Gate 3 Toolkit` folder (same as above)
3. Follow regular Installation instructions

# Update to 1.2.0.433 from versions from 1.2.0.0 upwards

1. Move the new MoonGlasses folder into the `Baldurs Gate 3 Toolkit` folder (where the previous MoonGlasses folder is located)
2. When Windows ask you if you want to replace existing files, click yes.
3. That's it!

# Temporarily disable MoonGlasses (back to regular Glasses)

Just move dxgi.dll out of the Toolkit folder; to re-enable just put it back.
Alternatively, for technical users: you can also set the Environment variable `SKIP_MOONGLASSES=1`.

# Uninstall MoonGlasses

Remove dxgi.dll and remove the MoonGlasses folder from the `Baldurs Gate 3 Toolkit` folder.

# See Also

- WORKFLOW GUIDE: https://discord.com/channels/1283055137580912723/1287532159061463040

# Notes

These files are not viruses. They may be flagged to contain a "trojan" only because Harmony (The tool that lets us inject new code into the .dlls for fixing crashes and add new features) can be flagged by Windows systems.

In some cases an error may occur when dragging the files from an open zip archive: "Could not load file or assembly 'file:<...>ModFramework.dll' or one of its dependencies.". To prevent this you must for some reason do exactly this: Right-Click on the zip to open context menu and find the option "Extract All..." and extract it, then drag the extracted files into MoonGlasses. They may seem the same but apparently they are not.

Have fun modding!
                                                                                                
                                                 ++                                             
                                                 %%                                             
                                               ++%%                                             
                                               %%%%                                             
                                               %%**                                             
                                           ++%%****%%++                                         
                                         -+%%::**%%::%%+-                                       
                                         +%::  %%%%  ::*=                                       
                                ::**%%%%%#***%%%%%%%%*******++                                  
                                    ::*****%%%%%%%%*****#%%%%%%%++                              
                                         +%--  %%*#  --%+                                       
                                         -***::##**::***=                                       
                                         .:#*==********:.                                       
                                           ====**##**==                                         
                                               **%%                                             
                                               %%**                                             
                                               %%::                                             
               **                              **                                **             
               **                              ::                                **             
             ++**++                                                            ++**++           
           ++  %%  ++                                                        ++  %%  ++         
        *****%%%%%%*****=                                                =*****%%%%%%*****      
           ++  %%  ++                                                        ++  %%  ++         
             ++**++                                                            ++**++           
               **                                                                **             
               **                                                                **             
                                                                                                
                              ::%%%%%%%%:                :%%%%%%%%::                            
                            ++%%.......:%*+            +*%:.......%%++                          
                          ::%%...........=*::++**%%++::%*...........**::                        
                       %%%%%:::::::::::::::****::::%%%%:::::::::::::::*****                     
                        :*%%......::::::...**::    ::%%...::::::......**+.                      
                          #%..::::.........%%        %%.........::::..**                        
                          #%::.............%%        %%.............::**                        
         =*              :::%%...........*%::        ::%*...........**:::              *=       
         =*            :.   ++**.......:%*+            +**:.......**++   .:            *=       
        +**++                 ::****%%%%:                :********::                 ++**+      
      += +%  ++                                                                    ++  %+ =+    
  *****#%%%%%******                                                            ******%%%%%#*****
      += +%  ++                                                                    ++  %+ =+    
        +**++                                                                        ++**+      
         =*                                                                            *=       
         =*                                                                            *=       
                                                                                                
                                                                                                
                              --                                  --                            
                              **                                  **                            
                              **                                  **                            
                            ++**++                              ++**++                          
                          =+  %%  ++                          ++  %%  +=                        
                       *****%%%%%%******                  ******%%%%%%*****                     
                          =+  %%  ++                          ++  %%  +=                        
                            ++**++                              ++**++                          
                              **                                  **                            
                              **                                  **                            