Skip to content

ZeoNyph/LiS-MapImport

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

README

These two scripts help with importing .umap files from Life is Strange: Remastered, and its materials into Blender.

This was only tested on Blender 4.3, so I'm unsure on whether it works on older versions, but feel free to try it out.

Requirements

  • A Steam copy of Life is Strange: Remastered.
  • Blender (preferably 4.3)
  • FModel
  • UModel

Usage

Extracting Assets

  • Export the .umap file you wish to import into Blender using FModel as a .json file.
  • Export the required assets from the game files using UModel (it might be easier to export all the files from Packages/Environment and Packages/Objects rather than exporting them individually).
    • Make sure the static meshes are exported as .gltf files and the textures as .tga files.

Blender Addon

This is the preferred way of importing maps from LiS:R into Blender.

  • Download LiSR_mapimporter.py from the latest release in the Releases tab of this GitHub page.
  • Install the addon by going to Edit > Preferences > Add-Ons, and in the top right drop-down menu, selecting Install from Disk and select the downloaded file. Installing the addon via Add-Ons
  • To import a map, go to the sidebar of your 3D Viewport, selecting LiS:R Importer, inputting the location of your extracted assets and the .umap JSON file, and pressing the 'Import Map' button. Addon location
    • For the exported assets, the extracted asset folders must be contained as per the following file path: BASE_DIR\LiS\Content\EXPORTED_ASSETS Directory example

Standalone Scripts

Alternatively, you can use standalone scripts via Blender's text editor to import maps.

  • Clone this repository into a folder of your choice.
  • In a Blender project, open the 'Scripting' workspace, and open original_scripts/map_mesh_import.py in the text editor.
  • Replace the example directories with the directories where you have your .json file and your exported assets.
    • For the exported assets, the extracted asset folders must be contained as per the following file path: BASE_DIR\LiS\Content\EXPORTED_ASSETS Directory example
  • Run map_mesh_import.py. Depending on how many assets the map has, it may take a while and Blender will be unresponsive while it imports all the meshes, so be patient.
  • Once the models have been imported, open original_scripts/map_material_cleanup.py in the text editor, and replace the example material directory with the exported assets' base directory.
  • Run map_material_cleanup.py. This may also take a while depending on how many textures there are to load.
  • Congrats, you now have a fully imported map from the game!

Credits

  • GanonMaster for the original scripts that I heavily based this off of.
  • bosterm93 for testing out the scripts.

About

Blender scripts to import .umap files from Life is Strange: Remastered

Resources

License

Stars

Watchers

Forks

Contributors

Languages