Modding Basics 3.0

## Introduction

Hello there!

So, you've heard that it's possible to mod Disney Infinity and are interested in getting started? Well, you've come to the right place! In this tutorial we will teach you the essentials you need to get started modding the game. We'll be going through all the necessary applications needed to decrypt and edit the game's code, as well as all the different files types the game uses to run properly. So without further ado, let's get started!

## Finding the assets folder

The first thing you need to do before we start modding the game is to find the assets folder, which is located within the main game's folder. By default, Steam should have installed it in C:\Program Files (x86)\Steam\steamapps\common\Disney Infinity 3.0 Gold Edition, though if you made your own install folder then be sure to check that instead. Once you find it you should see the assets folder inside, Congratulations!

You can check out what some of the folders inside have, but you'll notice that it's impossible to open any of the zip files in them. That's because we'll be needing a special tool to decrypt the zips, QuickBMS.

## Decrypting the game zips

The game's zip files are encrypted since Disney doesn't want anyone to mess with them. So, in order to decrypt them, we're going to need a program called QuickBMS and a script made for it called disney\_infinity.bms. Go ahead and download the two files below to get started.

QuickBMS

Disney\_infinity.bms

### Tutorial

1. Download and unpack QuickBMS into a folder of your liking, be sure to also copy the BMS script (disney\_infinity.bms) into the same folder QuickBMS is in.
2. Drag and drop disney\_infinity.bms onto QuickBMS.exe.
3. You will be asked to choose a zip file to extract.
4. click on the zip you want to decrypt in Disney Infinity 3.0 Gold Edition\assets and select open.
5. You will then be asked to choose the output folder. So find the folder you wish the files to be extracted to and press save.
6. Once QuickBMS says it's finished press any button to close it it and you've successfully extracted the file!

Sub-Tutorial on how to apply changes in-game:

1. Change the name of the original zip file so the game doesn't read it anymore (i.e. presentation.old.zip).
2. Make sure to put all the extracted files in the same folder the original zip was in, otherwise the game won't be able to read them!

Another important thing to note is if there was a folder that got extracted that has the same name as a folder in /Disney Infinity 3.0 Gold Editon\assets. Then you need to merge them together for the game to read it (For example, extracting assets\presentation\presentation.zip gives you a folder named **flash**, so be sure to move it to assets so it can combine with the flash folder there.

## File types the game uses

### .Lua

.lua files are text files with lua code in them. Some .lua files are obfuscated and encrypted however, and require unluac to edit (See below).

### .Tbody

.tbody files are the game's texture files. They're actually renamed .dds files. To edit them see Texture Swaps

### .Oct

.oct files are the files that gather the .ibuf and .vbuf (the mesh), skeleton, and textures to make sure the mesh has textures and a skeleton.

### .Ibuf and .Vbuf

.ibuf and .vbuf files are the mesh of the character.

### .Bent

the .bent files are the ones that control all the animations of the characters, scenarios, etc.

At the moment their modification is limited and they can only be modified in a hex editor.

### .Animtreeoverrides

.animtreeoverrides files are the animation overrides of a character.

### .Mtb

.mtb files are what the game uses to assign textures to things, they can be viewed with a hex editor to find textures as well. For more information check out this page.

### .Dnax

dnax files are similar to the .lua files, as they're written in lua code.

### .Sx

.sx files are the script a dnax file tells the game to use.

### .Bnk

.bnk files are video files in the Bink video format.

### .Kb2

The same as the .bnk files. A bink video

More file names will be added as they become discovered!

## Decrypting files with Unluac

While a lot of .lua and .dnax files can be edited with a text editor without any issues, some of them are encrypted and require the use of extra tools. So in this section we'll be teaching you how to use them!

### Unluac

You're going to have to install something called unluac. In order to use unluac you'll need to install Java first, and if you already have Java, that's great!

You can grab unluac from here: SourceForge

And if you don't have Java you can download it here: Java

#### Set up

1. Make a folder for decompiling and name it whatever you like (I simply called mine's "unluac").
2. Copy and paste unluac there.
3. Make a new text document and write: `java -jar unluac.jar file.lua > decrypted_file.lua`
4. Then save it as a .bat file or save it as a .txt file and rename it to a .bat file.
5. Search for the encrypted .lua or .dnax file you'd like to decompile, and copy and paste it to your decompiling folder.
6. Rename whatever file you selected to "**file.lua**" and drag and drop it onto unluac.bat. It should spit out decrypted\_file.lua, which should be decrypted and ready to edit!

For the game to read your new decrypted file, remember to put it in the same place you found it. I would also recommend backing up or renaming the original file in case something happens (I put .old in between the file's name and extension. i.e. logicattributesbase**.old**.lua).

Now go ahead and run the game to make sure it worked!

## Useful folders

There are quite a few important folders for the game that I would recommend most people decrypt, as they will be quite handy for modding. I've listed a few of them below, but feel free to explore the game's files yourself and see what things you can make with them!

1. assets\gamedb\core\core.zip
2. assets\presentation\presentation.zip
3. everything in assets\textures except for textures.zip
4. assets\startup.zip
5. assets/startup2.zip

## Outro

There you have it! Now that you've made it through the basics, you should have everything you need to start modding! For some more modding tutorials of Disney Infinity 3.0, click here.

And make sure to do this one about modding in missing characters

## References

1. ↑ aluigi. (2015, October 31). Disney Infinity 3.0 [web forum].

Retrieved January 30, 2023, from https://zenhax.com/viewtopic.php?f=9&t=1674&hilit=disney+infinity.

Backup via the internet archive