___________________________________________
                   
                                 - GreedFall - 

                        Better GreedFall Vortex Extension
                             
                                     [PC]
                  ___________________________________________

                                 July 3, 2020
                                Version: 1.01

                        Written by:  Dheu
                             Email:  Dheuster@gmail.com
                       Use subject:  GreedFall Alternate Vortex Plugin v1.00


                                QUICK SUMMARY
-------------------------------------------------------------------------------
Updates the Vortex GreedFall Extension to place any downloaded mods into a 
unique directory for each mod. Combined with "Mod Slot Support" (mod) this
will allow Vortex users to run most mods together without conflict. 

-------------------------------------------------------------------------------
I. > > > > Details
-------------------------------------------------------------------------------

  The default Vortex Extension for GreedFall does not place mods in unique
  directories. It extracts the archives to GreedFall's mod directory 
  as-is. This causes many if not most of GreedFall's mods to conflict with 
  each other. Sometimes Vortex lets you know but most of the time it isn't 
  aware.
  
  This extension causes Vortex to install each mod into a directory named 
  after the extracted archive. This allows installation of multiple mods 
  that edit the same game resources and gives them a unique and typically 
  identifiable parent directory.
  
  The KEY to this Vortex extension is the modding tool "Mod Slot Support". 
  The tool will scan and fix most conflicting mods. In addition to organizingThis
  your mods parent diretcories, this extension recognizes if Mod Slot Support 
  is installed and add a run-tool button to the Vortex Dashboard if it is. 
  (You have to run the tool after installing new mods to resolve conflicts). 

-------------------------------------------------------------------------------
II. > > > > Installation
-------------------------------------------------------------------------------

A) Clean Up
  
   1) If you previously downloaded GreedFall mods with Vortex, go to the Mods 
      tab within Vortex, select each GreedFall mod and select "Uninstall". 
     
      This cleans up the directory in GreedFall, but dont worry, the mods
      are still on your machine and listed by vortex.
     
      The only mod you should REMOVE is "Mod Slot Support", if you previously
      installed it with Vortex. 
     
   2) Visit the GreedFall mods directory and remove any vortex related files 
      such as "vortex.deployment.json".  If you exclusively used Vortex to 
      install mods, the directory should be empty once you delete the vortex 
      support files. 
    
      If you manually installed mods that were not known to vortex, there 
      may be some legitimate mods still remaining. You can decide whether 
      you want to start from scratch (all managed with vortex) or leave
      your non-vortex mods. My advice: If you see files/directroeis under
      datalocal and you don't know what mod they belong to, then delete them. 

B) Download Mod Slot Support

   Even if you already downloaded it manually in the past, remove it and 
   install the latest just to be certain you have the latest. 

   https://www.nexusmods.com/greedfall/mods/120   
        
C) Install Extension  
  
   1) With Vortex Running, Go to the "Extensions" Tab. You should see a
      drag-n-drop area to "Drop Files" in the bottom right corner. Drag
      the file "game-greedfall.zip" from the 7-zip window to your desktop
      then drag the file from your Desktop into the Drop Files area.

      Alternatively, you can hit Browse and locate the extracted
      "game-greedfall.zip" file.
 
   2) (After Restart) Ensure the new vortex extension is installed.

       Under "Extensions", if you scroll down to Game: GreedFall, you should see
       author name "Dheuster"

       The new extension also recognizes "Mod Slot Support", so you should see
       a new button in the GreedFall Dashboard to run it. (Don't push the
       button yet).
            
D) Re-Enable Mods

   Go to the Mods Tab and Re-Enable all the mods you uninstalled. When the 
   mods are extracted, they will now go to unique directories. 
   
   
E) Run Mod Slot Support

   On the Vortex Dashboard, you will find a button to run Mod Slot Support 
   right next to the button to launch the game. Run Mod Slot Support and 
   type "y" when prompted to reolve conflicts or merge localization tables. 
   
   The tool provides conflict feedback to let you know if there were mods that 
   could not be resolved and which (if any) mods are likely not functioning 
   properly. 
  
-------------------------------------------------------------------------------
III. > > > > Usage
-------------------------------------------------------------------------------

  Use vortex as normal. The main thing is that you remember to run the 
  "Mod Slot Support" tool from the vortex dashboard after installing new 
  GreedFall mods.
  
-------------------------------------------------------------------------------
IV. > > > > Un-Install
-------------------------------------------------------------------------------

Within Vorex:

  1) In the Mods tab, Select "Uninstall" for all GreedFall Mods
  2) In the Mods tab, click Open -> Open Game Mods Folder. 
     Run datalocal\!ModSlotSupport\uninstall.cmd
  3) In the Extensions Tab, Disable the GreedFall extension (Author Dheuster) 
     and then select Remove
  4) (After Restart) [code]In the Mods tab re-enable all your GreedFall mods.