Modding Tutorials/Assets

From RimWorld Wiki
Jump to navigation Jump to search

Modding Tutorials

In this tutorial you will learn how to extract the base assets of RimWorld.

Requirements[edit]

  1. Unity Assets Bundle Extractor to extract the contents of the unity .asset archives.
  2. or AssetStudio

UnityEx[edit]

To extract the original files from the Unity asset archives we will be using UnityEx which is compatible with Rimworld 1.0's Archives.

  1. Download UnityEx either by searching using your search engine of choice or via this link.
  2. Place the UnityEX.exe somewhere easily locatable (I prefer to place it into the Rimworld Directory).
  3. Run UnityEX.exe and open the .asset file you would like to extract, for example;
    RimWorld\RimWorldWin64_Data\resources.assets
  4. Extract the files you need. If you are extracting .tex files you can use "Extract with convert", this will convert the .tex files to .dds.
  5. The extracted files will be placed into a new folder in the same directory (Unity_Assets_Files) as the .asset file you have extracted.

Unity Assets Bundle Extractor[edit]

To extract the original files from the Unity asset archives we will be using Unity Assets Bundle Extractor which is compatible with Rimworld 1.0's Archives.

  1. Download Unity Assets Bundle Extractor by searching using your search engine of choice or via this link.
  2. Unzip it.
  3. Run AssetBundleExtractor.exe and open the .asset file you would like to extract, for example,
    RimWord\RimWorldWin64_Data\resources.assets
  4. Select the files you need/want. Then, click "Plugins" and select "Export to .png" or "Export sound". Note that this only works when you select files by type: so select only audio files or only textures.
  5. Click OK and select a folder for storage.

AssetStudio[edit]

To extract the original files from the Unity asset archives we will be using AssetStudio which is compatible with Rimworld 1.5's Archives (older versions not tested).

  1. Download AssetStudio by searching using your search engine of choice or via this link, if you are unsure which .NET runtime version you have installed net472 should be fine.
  2. Unzip it.
  3. Run AssetStudioGUI.exe and open the asset file you would like to extract, for example with File -> Load file,
    RimWord\RimWorldWin64_Data\resources.assets
    or for the DLC Asset Bundles with File -> Load folder
    RimWorld\Data\Anomaly\AssetBundles
  4. Switch to the Asset List tab.
  5. Select the files you need/want. Then, right click and select "Export selected assets", works for audio and textures.
  6. Select a folder for storage and click open.

AssetStudio on Linux[edit]

  1. Download AssetStudio by searching using your search engine of choice or via this link. Use the .net 6 version (AssetStudio.net6.v0.16.47.zip)
  2. Install Bottles however is appropriate for your distro. Here is the AUR link for arch users
  3. Unzip AssetStudio.net6.v0.16.47.zip (e.g /home/username/applications/AssetStudio.net6.v0.16.47/)
  4. Open Bottles and and click the + symbol in the top left corner of the UI to 'Create New Bottle'
  5. In the 'Create New Bottle' options window that pops up enter a name (e.g 'AssetStudio') and select 'Application'. You can leave the other options as default.
  6. Once the AssetStudio bottle has been created and has automatically opened the details page click on 'Add Shortcuts...'
  7. Navigate to where you extracted AssetStudio and select 'AssetStudioGUI.exe'
  8. After you have selected the exe you'll be on the bottle Detail page again, this time select 'Dependencies' and from the list choose 'dotnetcoredesktop6'
  9. After the .net dependency is installed you can now click the play button next to 'AssetStudioGUI' and the application will launch
  10. Open the asset file you would like to extract, for example with File -> Load file,
    RimWord\RimWorldWin64_Data\resources.assets
    or for the DLC Asset Bundles with File -> Load folder
    RimWorld\Data\Anomaly\AssetBundles
  11. Switch to the Asset List tab.
  12. Select the files you need/want. Then, right click and select "Export selected assets", works for audio and textures.
  13. Select a folder for storage and click open.

Notes: You could wait unzip AssetStudio in the Bottles prefix folder if you want to want to keep it all together (e.g /home/username/.local/share/bottles/bottles/AssetStudio/drive_c/Program Files/AssetStudio.net6.v0.16.47/). This would require waiting for step 5 to be complete (creating the bottle) prior to unzipping so that the folder structure exists.

AssetStudio.net6.v0.16.47 is used in this tutorial as it uses the most recent version of .net however the dependency for .net472 can be installed in Bottles (dotnet472) so AssetStudio.net472.v0.16.47.zip could presumably be used if there was a need.


See also[edit]