Author Topic: swbf-unmunge Step By Step Basics  (Read 4183 times)


  • BOB clan
  • Internet Addict
  • *****
  • Posts: 2569
  • Awards Award for extensive modding contributions and/or donations to TWD Battlefront ICW2 Participant
    • View Profile
    • Awards
  • Xbox: RepubliqueCMDR
swbf-unmunge Step By Step Basics
« on: October 07, 2017, 01:03:16 AM »

Hello, lets talk step by step about SleepKiller's SWBF Unmunge commandline tool.

If you need to take game assets and use them ingame, you follow the 'munge'/compile process,
but what if you need compiled *.LVL files back in their original state?

If you're reading this, you probably already know that SleepKiller's fancy new tool exists, and
that it can do the above mentioned process for you (albeit, it's not complete as of 10/6/2017), but
how do we use it?

Lets assume you don't even have the tool yet, what's the first step?
Swbf-unmunge topic is the tools official topic by it's creator,
but we're looking for the tool download itself, which is here, on its GitHub releases page.

The most recent stable version today (10/7/2017) is "v0.6.1", so let's describe that process first.

Simply click the link that our red arrow points to, which downloads a zip containing our tool.
When it's finished downloading, you'll need to extract it to a folder (because there are several files,
and you don't want them all over your desktop, for example).
I'll extract them to my desktop in a new folder "SWBFUnmunge."

Now we'll need an *.LVL file to experiment on, so I'll get load.lvl from my game's directory:
C:/Program Files/LucasArts/Star Wars Battlefront/GameData/Data/_LVL_PC/Load/load.lvl
You can choose whatever file you wish, but I'll assume you're using this one.

Lets copy/paste it to /SWBFUnmunge/ where our tool is, just for fun.

swbf-unmunge.exe is the actual tool, and it works by commands, so let's create our command just to test it out.
There are two generic ways to run the correct command, and the proper usage is described on the tool's front page here.
1. Open command prompt
    (cmd.exe, and depending on the location of LVL files you're using, you might right click it and 'Run As
    Administrator'), and navigate to the folder we extracted swbf-unmunge:
        I'll type cd C:/Users/Jon/Desktop/SWBFUnmunge/
        Next, we'll type swbf-unmunge
        If this works, it should output the correct usage, as displayed:
        If not, you should see an error about the command not existing,
        meaning you're 'cd'ed in the wrong directory.
    If all went well, type swbf-unmunge -file load.lvl -version swbf -outversion swbf -imgfmt png
    After the command runs, you should see the files populate in a new folder "/load/" in the same directory as in
    input file we used "load.lvl", we asked the tool to export PNG files, so you should be able to see the textures
    of load.lvl inside the newly created folder, along with any other assets. Pretty cool!

2. If you're cool like me, you can type 'cmd' into the address bar of the file explorer, if you're currently in
    /SWBFUnmunge/, where we extracted swbf-unmunge.exe and it's files.
    This will open a new command window, already 'cd'ed to the directory of your file explorer.
    type swbf-unmunge -file load.lvl -version swbf -outversion swbf -imgfmt png

*Editing more in future with more explanations, and how to use all the options, and (optionally) my GUI*

« Last Edit: March 02, 2018, 12:31:35 AM by RepComm »


  • Imperial Smiletrooper
  • Moderators
  • Internet Addict
  • ****
  • Posts: 2582
  • Awards Special Award for those that play the original SWBF Special Award for those that play SWBF2 Players of DICE's SWBF (2015) title. Releasing Multiple Mods on
    • View Profile
    • Awards
  • PSN: giftheck
  • Steam ID:
Re: swbf-unmunge Step By Step Basics
« Reply #1 on: October 07, 2017, 05:00:03 AM »
Much appreciated, RepComm  :tu:
Works in Progress:

--Star Wars: Battlefront 1.25: "First Order-Resistance War Expansion"
--Main Play Mod Reboot
--DICE Edition Mod
--PSP Map conversions
--Scarif: Beach
--Future Legacy Reboot


  • Member
  • **
  • Posts: 11
    • View Profile
    • Awards
Re: swbf-unmunge Step By Step Basics
« Reply #2 on: August 08, 2019, 11:35:09 AM »

Hello, lets talk step by step about SleepKiller's SWBF Unmunge commandline tool.

edit by Led--no need to quote all of that.

please help me...
my .lvl file does not exist. What may be happened?

Thank you
« Last Edit: August 08, 2019, 11:37:09 AM by Led »


  • The Tesla of BF2
  • Master Modder
  • Frequent Poster
  • ***
  • Posts: 269
  • Awards Recognizes someone who most generously donated funds to the site or the site
    • View Profile
    • Classic Battlefront Console Mods
    • Awards
  • Steam ID:
  • Xbox: AnthonyBF2
  • Origin ID: BabyWookiee777
Re: swbf-unmunge Step By Step Basics
« Reply #3 on: August 08, 2019, 06:50:32 PM »
I assumed someone else would have done this by now but I guess not, so I will.

1) make a batch file, and put this code in it:
swbf-unmunge.exe -file shell.lvl -version swbf_ii -outversion swbf_ii -imgfmt tga -platform pc -verbose -mode extract

2) put the batch file alongside swbf-unmunge.exe and the LVL file you want to rip

3) double click the batch file to rip the file

4) right-click the batch file, select "edit" to change the parameters to edit different files, platform type, or game type

I've found this to be much easier than any of the other methods people have posted.
Never let a person named AnthonyBF2 touch your BF2.


  • Member
  • **
  • Posts: 11
    • View Profile
    • Awards
Re: swbf-unmunge Step By Step Basics
« Reply #4 on: August 08, 2019, 10:43:03 PM »
Thank you very much  :tu:


SimplePortal 2.3.7 © 2008-2020, SimplePortal