epicartificials blog

Minecraft Dungeons to Minecraft

17.03.2021

Minecraft Dungeons is a dungeon crawler video game developed by Mojang Studios and Double Eleven and published by Xbox Game Studios. It is a spin-off of the sandbox video game Minecraft and was released for Nintendo Switch, PlayStation 4, Windows, and Xbox One on May 26, 2020.

Minecraft Dungeons, for Windows, is developed in Unreal Engine 4. Unreal Engine stores all the assets in .pak files. These files are for obvious reasons encrypted, however the encryption keys to popular game versions has been obtained.

Umodel

official link

Unreal Engine resource viewer (formerly Unreal Model Viewer) is a program for viewing and extracting resources from various games made with Unreal Engine. Sometimes the program is referenced as "umodel", the short of "unreal" and "model viewer".

We can use umodel to extract the Minecraft Dungeons assets.

  1. select the path to your Paks folder in the Minecraft Dungeons install path
  2. override game detection and select the Minecraft Dungeons exact version (currently it uses UE 4.22)
  3. press OK
  4. insert AES key, try one of these: ​ 0x478762BAEC53557F2BB59292B1341F1ADA335163D1335CE338A3A02B78F14271 ​ 0x90F270A4EA6DE0E3BABDC4C8BDC04F46FA5B9087BE8FE76AA859C93C17D04661 ​ 0x0634AF9A409BA6D24FC17B6872124A91F3DBC4C3986F639A5E29C1BB10B2A099

umodel_startup

Once the key is inserted you will be presented with the following explorer:

umodel_explorer

You can inspect the contents of the folders in the explorer, but we want to export the files

  1. scroll up and select folder All packages
  2. right click and click Export folder content
  3. you will be presented with the following window:
  4. choose the export location
  5. select Texture format: either TGA or PNG
  6. press OK

umodel_export

Now we can look through all the textures in PNG format and do whatever we want with them

Blender

official link

Blender is a free and open-source 3D computer graphics software toolset used for creating animated films, visual effects, art, 3D printed models, motion graphics, interactive 3D applications, virtual reality, and computer games.

In order to open the character models we will use Blender. The models are located in Game/Actors/... as a .psa files. Blender doesn't know how to open .psa files by default so we need to download and import this addon.

  1. open Blender
  2. go to Edit > Preferences > Add-ons
  3. press Install... and select the downloaded addon

blender_addon

  1. then we can import our models
  2. go to File > Import > Skeleton Mesh (.psk)
  3. select your .psk model and import
  4. then select your model in blender
  5. again, go to File > Import > Skeleton Anim (.psa)
  6. select your .psa file and import
  7. Now you should be able to play the animation

blender_import

FModel

official link

Created in March 2019, FModel is a .PAK file explorer fully dedicated to Fortnite but also work with some other Unreal Engine's games. It quickly became popular to quickly generate images of new cosmetics added to the game. Over time, new features got added and new users discovered the program.

Umodel does give us access to the models and textures, but not the .uasset files.

Using FModel we can access the rest of the files directly.

  1. select the path to your Paks folder in the Minecraft Dungeons install path
  2. select OK
  3. insert AES key, try one of these: 0x478762BAEC53557F2BB59292B1341F1ADA335163D1335CE338A3A02B78F14271 0x90F270A4EA6DE0E3BABDC4C8BDC04F46FA5B9087BE8FE76AA859C93C17D04661 0x0634AF9A409BA6D24FC17B6872124A91F3DBC4C3986F639A5E29C1BB10B2A099
  4. then go to Files > Packages > Load All
  5. you should see the following:

fmodel_explorer

The bottom left section shows us the content of the folder, the middle section shows us the text files and top right section the texture / model preview.

You can inspect the contents of the folders in the explorer, but we want to export the files

  1. select your desired folder to export, for example Dungeons
  2. right click and press Export
  3. once the output is finished go to Assets > Open Output Folder to see the data

Convert MC Dungeons map to Minecraft

We would like to play Minecraft Dungeons in Minecraft. Minecraft Dungeons stores its maps in objectgroup.json files

They are located in Dungeons/Content/data/lovika/objectgroups/*

The whole level consists of multiple objectgroups and can be found in Dungeons/Content/data/lovika/levels/*

To convert objectgroups to minecraft data we will use Dokucraft ConversionTool written in Python.

We will clone their repo and create a file script.py with the following code in the /examples/ directory

from ConversionTools import ObjectGroupToJavaWorld

objectgroup_path = r'C:\my\dungeons\objectgroups\example\objectgroup.json'
output_world_path = r'C:\MC Java\saves\ExampleWorld'

# Just using the default settings this time
converter = ObjectGroupToJavaWorld(objectgroup_path, output_world_path)
converter.convert()

Once the script is ran with python script.py a minecraft world will be created

And here we go... we can see all the builds in minecraft, with a little resource pack applied it can look like this:

minecraft

#minecraft dungeons #minecraft