Valheim Unity Project Guide - Valheim-Modding/Wiki GitHub Wiki

Download/install the following:

1. Git
   • Choose the version for your machine. Here is a quick-link to the windows download Install Git on Windows
   • Once Git is installed, reboot your machine and continue through this guide! Rebooting might not be needed in some cases, but it's advised to do so.
2. AssetRipper
   • Extract it somewhere for later. Downloading a version above 1.0.12 seems to corrupt meshes but need more investigation.
3. Unity Hub
   • Click on Download Unity Hub and install it.
4. Unity 2022.3.50f1
   • Click on the link in Install this version with Unity Hub..
   • When installing Unity, you can uncheck all optional modules.

1. Run AssetRipper by launching the AssetRipper.GUI.Free.exe. It will open up a console window as well as a page in your browser. Click File -> Settings

2. Use these settings.

3. Go to File ⟶ Open Folder. Find your Valheim directory and select the top level "Valheim" folder. (You can also drag the folder into AssetRipper).

• If this error shows up you can ignore it.

4. Once loaded, go to Export ⟶ Export all Files and select a new empty directory (i.e. ValheimRIP).

5. Once loaded click Select Folder and then Export and let it complete.

6. You will now have two folders inside your exported folder called AuxiliaryFiles and ExportedProject. Delete AuxileryFiles and rename ExportedProject to something like ValheimRIP and move it to it's permanent location.

7. Find the manifest.json in Packages located in the folder you exported to and add these values. In case your manifest.json got corrupted you can copy-paste it from HERE

   "com.unity.inputsystem": "1.10.0",
   "com.unity.textmeshpro": "3.2.0-pre.5"
   

8. Delete these files + their META files in Assets/Plugins. It is very important you do this before opening your project.

   Unity.InputSystem.dll, 
   Unity.InputSystem.ForUI.dll
   Unity.TextMeshPro.dll
   

9. Restoring shaders.

   1. Download Yaml shaders.
   2. Copy the content of the zip into Assets/Shader and overwrite.

1. Run Unity Hub.

2. Click on Open (or Add in new versions).

   

3. Find the folder where you moved ValheimRIP to.

4. Select ValheimRIP folder and click Open. This will take up to 20-30 mins.

5. If the API Update Required message box appears, click I Made a Backup. Go Ahead!. (This only occur when picking Decompiled.)

   

   If the Do you want to enable the backends? appears, click Yes.

   

6. Wait for the project to fully load (this can take up to 30 mins).

   1. Go to Edit -> Project Settings -> Graphics and change Custom Shaders to Built-in Shader.
   2. Open wood_portal to confirm that effects/particles looks good by playing them.

7. Perform a script recovery if needed (This shouldn't happen if you did step 8 in previous section).

   1. Install NG Script Recovery via Package Manager from the Unity Asset Store
   2. Open NG Script Recovery from the inspector where the missing script is, or from the menu Window -> NG Tools -> NG Missing Script Recovery
   3. In the Project tab select "Prefab", "Asset", "GameObject in Scenes"and "Scenes". Hit the Scan button.
   4. Hit "Start Recovery" to perform an automatic recovery.
   5. You may see a pop-up asking you to import TMP Essentials. Click "Import TMP Essentials" and close the pop-up.
   6. Finish the script recovery by manually picking the best match for any remaining broken object until the process is finished.

8. Click Window and then open AssetBundleBrowser, click the first bundle and then ctrl+A to select all, now delete and wait for it to finish. Depending on your system it might take a little bit and then it will do another import session like when you first opened the rip.

   • If you don't have AssetBundleBrowser, go to the Unity Technologies GitHub page for it and follow the instructions under Installation.

9. You should now have a good rip you can work on. There will still be a few missing materials, scripts in scenes. These are not urgent to fix but you can if you want. For convenience you can put all missing materials to Standard. For fonts you can use any of the TMP ones. This step is only useful if you care about exploring scenes with working shaders, text and if you don't you can ignore this. It's possible to fully restore scenes and correct any shaders to match vanilla. That's however outside of the scope of this guide and you can join any modding Discord for help with that.

10. [Optional] Create a copy of your ValheimRIP folder in the same directory. Rename the copy to something like ValheimRIPCustom. Your ValheimRIP folder will be used as a clean version of the ripped game assets and the ValheimRIPCustom version is where you will duplicate, create new, or edit existing assets.

11. [Optional] Create another copy of your ValheimRIP and call it ValheimTemplate and then delete the content of the Asset folder. You can then copy-paste this project for each mod you want to make. You then use ValheimCustom to export assets into your new clean project. This is beneficial as you only export what you need and not accidentally bring in the whole game from automatic references.

If you need further help you can join any of the modding Discords linked here.

🥳 That's it. Happy modding! Keep reading for more information.

• Dummy shaders are editable and can be used with Shader Replacer but effects/particles looks broken in Unity.

• Yaml shaders are not editable but effects/particles looks correct in Unity (you will need to recover them first).

• Pick Dummy if you want to use Valheims shaders with Shader Replacer and you do not care about effects/particles that looks broken (white/pink squares or other artifact looking graphics)

• Pick Yaml if you want to have effects/particles that look correct and that you can use as reference when replacing them with standard, legacy, custom.

If you are creating assets for the game you will want to make sure your build is compatible with Vulkan and OpenGL graphics. If you do not do this for your project then some items in the game will show up incorrectly, typically untextured bright pink/magenta, for some players and there will be related errors in Player.log.

1. Open your unity development project.
2. Go to Edit -> Project Settings.
3. In the Player tab find the "Other settings".
   1. Uncheck "Auto Graphics API for Windows".
   2. Under "Graphics APIs for Windows" make sure both "Direct3D11" and "Vulkan" are added.
   3. Uncheck "Auto Graphics API for Linux".
   4. Under "Graphics APIs for Linux" make sure both "OpenGLCore" and "Vulkan" are added.

Error message example, showing missing OpenGL support:

Desired shader compiler platform 15 is not available in shader blob
ERROR: Shader Unlit/Color shader is not supported on this GPU (none of subshaders/fallbacks are suitable)

These common error logs can be ignored for now.

Destroy may not be called from edit mode! Use DestroyImmediate instead.
Destroying an object in edit mode destroys it permanently.

Assertion failed on expression: 'CurrentThreadIsMainThread()'

• Mouse does not get locked to the playtest window.
• Some UI elements like the stamina bar don't disappear or will flash.