Hex Edit your Levels and Make Better Playlists [Additional Blocks & NPCs for Level Editor]

Overview

* This guide will show you how to edit your levels with Hex Editor, which means getting more stuff to work with and that leads to some creative people making even more creative levels, sky’s the limit. This is a very complex process but extremly easy to learn!MY OTHER BATTLEBLOCK THEATER GUIDESCreate your own Head!Currencies Explained!Weapons and Melee Explained!

How and Why to Hex Edit your Playlist?

Hex edited levels will most likely crash on Mac and Linux!

In-Game Level Editor excludes some blocks and sceneries, you can use the Hex Editor to manually add those directly in the Playlist’s data. If used correctly you can make really creative and fun levels that will stand out from the rest of workshop Playlists, it’s not too hard when you get the hang of it.

First you will need to download a Hex Editor, my personal recommendation is HxD Hex Editor[mh-nexus.de]

Mac/Linux HEX Editor alternative[www.wxhexedit.org]

Go into the game and create a NEW Playlist with at least one level and then save it.

Open the Playlist file with Hex Editor, the file should be in:
C:Program Files (x86)Steamuserdata{your 9 digit number}238460remote
or
C:Program FilesSteamuserdata{your 9 digit number}238460remote

There may be only one number if you haven’t logged in with other Steam accounts on your PC. If there are multiple search each one. You are searching for the file with the same name as your Playlist.

I would recommend changing numbers per row to half of your level Width:

This is the file structure:

The File

Playlist and Level Names

If you plan on changing those make sure not to change the length of their name, this can corrupt the file.

Level 1 Data

This is what we are looking for, the Level itself. You can identify this part by searching for row of 08 and 07 Hex Values, those 2 are normal solid blocks in 2 different colors, just like in the game.
Each value represents a single block in-game.

Level Scenery

This part defines the scenery of the level, it comes right before 07s and 08s but after the rows of 00s. Each value here represents something different;

1. Width (You can change it to a smaller value than one defaulty allowed)
2. Height (You can change it to a smaller value than one defaulty allowed)
3. Game Type (You can change this in-game, unused values have broken gamemodes)
4. Block Style (You can change this in-game)
5. Sky Color (You can change this in-game)
6. Background Style (You can change this in-game)
7. Special Foreground
8. Special Background
9. Block Color 1 (You can change this in-game)
10. Block Color 2 (You can change this in-game)
11. Water Color (You can change this in-game)
12. Plant Color (You can change this in-game)
13. Unknown
14. Time Limit (You can change this in-game)
15. Unknown

You can Hex Edit Special Foreground and Background to something not available in Editor’s Menu, like Gift Shop. Values for these are below. If you change any of the values here to an unused value (like FF) you will make them transparent, so you can make a lot of cool levels that don’t have Background, Foreground, Sky Color…

Level Blocks

This part defines Blocks that are used within the level. Newly created Levels have only 07s, 08s and 00s. As said, 07s and 08s are normal solid Blocks in one of two randomly generated colors that you can change in-game. 00 is Air or Empty Space. First and last row will always be 07s and 08s (top and bottom of the level) and occasionally you will see two 07s or 08s next to each other; these indicate the blocks on the side of the level, you can use these 2 values to determinate where the new row starts. Hex Values of all blocks are below, BOLDED ones are not available in Level Editor.
Good luck.

Level 2 Data

Level Scenery

. . .

Level Blocks

. . .

Level 3 Data

Level Scenery

. . .

Level Blocks

. . .

. . .

If you find new values be kind to leave a comment with them so I can update the guide!

Special Foreground & Background Values

01 – Gift Shop
02 & 0D – Level Selection (Furrbottom’s Feature New)
03 – Level Selection (Ruined)
04 – Level Selection (Ruined)
05 – Level Selection (New)
06 – Level Selection (New, Lights)
07 – Level Selection (Riot)
08 – Level Selection (Large Riot)
09 – Level Selection (Fire)
0A – Level Selection (Vault)
0B – Level Selection (Furrbottom’s Feature Ruined)
0C & 0E – Level Selection (New, Less Lights)
0F – Theater Enterance (Game Start)
10 – Theater Lobby
11 – Theater Terrace
12 – Prisoner Bedroom
13 – Chapter 1 & 2 Selection
14 – Chapter 3 & 4 Selection
15 – Chatper 5 & 6 Selection
16 – Chapter 7 Selection
17 – Chapter 8 Selection
18 – The Stage Backroom
19 – Finale #1
1A – Finale #2
1B – Finale #3
1C – Finale #4
1D – Finale #5
1E – Finale #6
1F – Finale #7
20 – Finale #8
21 – Finale #9
22 – Finale #10
23 – Finale #11
24 – Finale #12
25 – Finale #13
26 – Finale #14
27 – Finale #15
28 – Finale #16
2B – Hall of Dudes

29 Foreground Value 2A Background Value – Theater Enterance (Game Ending)
00 Foreground Value 29 Background Value – Unused Tutorial
2A Foreground Value FF Background Value – Vault Scenery

You are not required to use the same value for Foreground and Background, you can mix them up!

Hex Values – Blocks

00 – Air (Empty Space)
07 – Block (Color 1)
08 – Block (Color 2)
17 – Invisible Cloud
18 – Invisible Block
74 – Invisible Wall (ˢᶦᵈᵉʷᵃʸˢ ᶜᶫᵒᵘᵈ ⁻ ʸᵒᵘ ᶜᵃᶰ’ᵗ ᵖᵃˢˢ ᵗʰʳᵒᵘᵍʰ ˢᶦᵈᵉˢ, ᵇᵘᵗ ᶜᵃᶰ ᶠʳᵒᵐ ᵗᵒᵖ ᵃᶰᵈ ᵇᵒᵗᵗᵒᵐ)

14 – Cloud
15 – Ice
16 – Lava Block
0D – Bubblegum Block
19 – Blocker (ᵇᶫᵒᶜᵏˢ ˢᵗᵘᶠᶠ ᶫᶦᵏᵉ ʰᵒᵛᵉʳᵇʳᶦᵈᵍᵉ, ᶫᵃˢᵉʳˢ, ᴬᴵ⋅⋅⋅ ᵈᵒᵉˢᶰ’ᵗ ᵇᶫᵒᶜᵏ ᵖᶫᵃʸᵉʳˢ)

12 – Ferdinand (Color 1) (ˢᶦᵈᵉʷᵃʸˢ ᵐᵒᵛᶦᶰᵍ ᵖᶫᵃᵗᶠᵒʳᵐˢ ʷᶦᵗʰ ᶠᵃᶜᵉ)
13 – Ferdinand (Color 2)

72 – Chapter Door (Closed) (ʸᵒᵘ ᶜᵃᶰ’ᵗ ᵖᵃˢˢ ᵗʰʳᵒᵘᵍʰ ˢᶦᵈᵉˢ, ᵇᵘᵗ ᶜᵃᶰ ᶠʳᵒᵐ ᵗᵒᵖ ᵃᶰᵈ ᵇᵒᵗᵗᵒᵐ)

C0 – Block (Team 1) (ᵗᵉᵃᵐ ᶜᵒᶫᵒʳᵉᵈ ᵇᶫᵒᶜᵏ)
C1 – Block (Team 2)
DF – Block (Random Color 1) (ʳᵃᶰᵈᵒᵐ ᶜᵒᶫᵒʳ ᵉᵛᵉʳʸ ᵗᶦᵐᵉ)
E0 – Block (Random Color 2)
E1 – HoverBridge

E4 – Broken Trigger Block (Color 1) (ᵇᶫᵒᶜᵏ ᵗʰᵃᵗ ᵈᶦˢˢᵃᵖᵉᵃʳˢ ʷʰᵉᶰ ᵇᵘᵗᵗᵒᶰ ᶦˢ ᵖʳᵉˢˢᵉᵈ ᵉˣᶜᵉᵖᵗ ᵗʰᶦˢ ᵛᵉʳˢᶦᵒᶰ ᶦˢ ᵇʳᵒᵏᵉᶰ)
E5 – Broken Trigger Block (Color 2)

Hex Values – Functional Blocks

09 – Platform (Color 1) (ᵐᵒᵛᵉᵃᵇᶫᵉ ᶠᶫᵒᵃᵗᶦᶰᵍ ᵇᶫᵒᶜᵏ)
0A – Platform (Color 2)

0B – Water (Color 1)
0C – Water (Color 2)

0E – Rocket Platform (Color 1)
0F – Rocket Platform (Color 2)

10 – Treadmill (Left)
11 – Treadmill (Right)

1B – Fake Block (Color 1)
1C – Fake Block (Color 2)

21 – Hover Bridge Source (Right)
22 – Hover Bridge Source (Left)

47, 48, 49, 4A & 4B – Exploding Block
50, 51, 52, 53, 54, 55, 56, 57, 4C, 4D, 4E & 4F – Puzzle Block

64, 65 & 66 – Jumping Board (Left)
67, 68 & 69 – Jumping Board (Right)
8E – Boulder
90 – Boat
BB – Ball Ejector

BC – Basket (Team 1)
BD – Basket (Team 2)
BE – Goal (Team 1)
BF – Goal (Team 2)

C2 – Horse Flag (Team 1)
C3 – Horse Flag (Team 2)

CA – King of the Hill Block (Inactive)
CB – King of the Hill Block (Active)

Hex Values – Enterances & Exits

01 – Enterance
02 – Enterance (Secret) (ᶫᵒᵒᵏˢ ᶫᶦᵏᵉ ᵃ ᶰᵒʳᵐᵃᶫ ᵇᶫᵒᶜᵏ)

03 – Exit
04 – Exit (1/3 Gems Collected) (ʷᶦᶫᶫ ᵘᵖᵈᵃᵗᵉ ᵗᵒ ʳᵉᵃᶫ ᵛᵃᶫᵘᵉ ᶦᶠ ʸᵒᵘ ᵖᶦᶜᵏ ᵘᵖ ᵃ ˢᵗʳᵃʷᵇᵉʳʳʸ)
05 – Exit (2/3 Gems Collected) (ʷᶦᶫᶫ ᵘᵖᵈᵃᵗᵉ ᵗᵒ ʳᵉᵃᶫ ᵛᵃᶫᵘᵉ ᶦᶠ ʸᵒᵘ ᵖᶦᶜᵏ ᵘᵖ ᵃ ˢᵗʳᵃʷᵇᵉʳʳʸ)
06 – Exit (3/3 Gems Collected) (ʷᶦᶫᶫ ᵘᵖᵈᵃᵗᵉ ᵗᵒ ʳᵉᵃˡ ᵛᵃˡᵘᵉ ᵒᶰ ˡᵉᵛᵉˡ ˢᵗᵃʳᵗ)
70 – Gift Shop Exit (ᵉᶰᵈˢ ᵗʰᵉ ᶫᵉᵛᵉᶫ ʷʰᵉᶰ ᵘˢᵉᵈ)
71 – Gift Shop Enterance (ᵉᶰᵈˢ ᵗʰᵉ ᶫᵉᵛᵉᶫ ʷʰᵉᶰ ᵘˢᵉᵈ)
78 – Chapter Selection Door (ᵉᶰᵈˢ ᵗʰᵉ ᶫᵉᵛᵉᶫ ʷʰᵉᶰ ᵘˢᵉᵈ)
88 – Purrham’s Hat (ᵉᶰᵈˢ ᵗʰᵉ ᶫᵉᵛᵉᶫ ʷʰᵉᶰ ᶜᵒᶫᶫᵉᶜᵗᵉᵈ)
89 – Chapter Key (ᵉᶰᵈˢ ᵗʰᵉ ᶫᵉᵛᵉᶫ ʷʰᵉᶰ ᶜᵒᶫᶫᵉᶜᵗᵉᵈ)
1A – Secret Level Block
6F – Exit (Secret) (ᶫᵒᵒᵏˢ ᶫᶦᵏᵉ ᵃ ᶰᵒʳᵐᵃᶫ ᵇᶫᵒᶜᵏ, ᵉᶰᵈˢ ᵗʰᵉ ᶫᵉᵛᵉᶫ ʷʰᵉᶰ ᵘˢᵉᵈ)

Hex Values – NPCs (Non-Player Character)

86 – Cat (Gem)
87 – Cat (Strawberry)

91 – Cat (Agressive)
AA – Cat (Less Agressive) (ʷᵉᵃᵖᵒᶰ ᶜᵃᵗ ʷᶦᵗʰᵒᵘᵗ ʷᵉᵃᵖᵒᶰˢ, ᶫᵉˢˢ ᵃᵍʳᵉˢˢᶦᵛᵉ ᵗʰᵃᶰ ᶰᵒʳᵐᵃᶫ ʷᵉᵃᵖᵒᶰᶫᵉˢˢ ᶜᵃᵗ)
9D – Cat (Flying Disc)
9E – Cat (Grenade)
9F – Cat (Boomerang)
A0 – Cat (Dodgeball)
A1 – Cat (Fireball)
A2 – Cat (Ice Cannon)
A3 – Cat (Fan)
A4 – Cat (Dart Gun)
A5 – Cat (Forceball)
A6 – Cat (Vacuum)
A7 – Cat (Paper Airplane)
A8 – Cat (FrogBomb)
A9 – Cat (Acid Bubble)

92 – Raccoon
93 – UFO Cat
94 – Toaster (Block)
97 – Robot
8F – Cannon
CC – Black Cat Monster (ᶠᶫᶦᵉˢ ᵃʳᵒᵘᶰᵈ ˢᵉᵃʳᶜʰᶦᶰᵍ ᶠᵒʳ ᵖᶫᵃʸᵉʳˢ ᵃᶰᵈ ˢᵗᵘᶰˢ ᵗʰᵉᵐ ᵒᶰ ᶜᵒᶰᵗᵃᶜᵗ, ᶜᵃᶰ ᵇᵉ ᵏᶦᶫᶫᵉᵈ ᵇʸ ᶠᶦʳᵉᵇᵃᶫᶫ ᵒʳ ᶫᵃˢᵉʳˢ, ᵉᶰᵈˢ ᵗʰᵉ ᶫᵉᵛᵉᶫ ʷʰᵉᶰ ᵏᶦᶫᶫᵉᵈ)

98 – Wonderwuzzle (ˢᵐᵃᶫᶫ ʳᵉᵈ ᵇᶦʳᵈ ᵗʰᵃᵗ ᶦᶰᵈᶦᶜᵃᵗᵉˢ ᵃ ˢᵉᶜʳᵉᵗ ᶫᵉᵛᵉᶫ ᶦˢ ᵖʳᵉˢᵉᶰᵗ ᵒᶰ ᶜᵘʳʳᵉᶰᵗ ᶫᵉᵛᵉᶫ)
8D – Horse

99 – DuckShark Egg (Left)
9A – DuckShark Egg (Right)
9B – DuckShark Sign (Green)
9C – DuckShark Sign (Red)

95 – Sawblade (Up)
96 – Sawblade (Down)

Hex Values – Pickups

1F – Fake Block (Color 1, Strawberry)
20 – Fake Block (Color 2, Strawberry)
1D – Fake Block (Color 1, Gem)
1E – Fake Block (Color 2, Gem)

81 – Gem (ᶦᵗ ʷᶦᶫᶫ ᵗᵘʳᶰ ᶦᶰᵗᵒ ᵃ ˢᵗʳᵃʷᵇᵉʳʳʸ ᶦᶠ ᵘᵖᶫᵒᵃᵈᵉᵈ ᵗᵒ ʷᵒʳᵏˢʰᵒᵖ)
82 – Yarn (ᶦᵗ ʷᶦᶫᶫ ᵗᵘʳᶰ ᶦᶰᵗᵒ ᵃ ᵖᵘᵐᵖᵏᶦᶰ ᵖᶦᵉ ᶦᶠ ᵘᵖᶫᵒᵃᵈᵉᵈ ᵗᵒ ʷᵒʳᵏˢʰᵒᵖ)
83 – Strawberry
84 – Golden Hat (ᶦᵗ ʷᶦᶫᶫ ᵈᶦˢˢᵃᵖᵉᵃʳ ᶦᶠ ᵘᵖᶫᵒᵃᵈᵉᵈ ᵗᵒ ʷᵒʳᵏˢʰᵒᵖ)
85 – Pumkin Pie

6A – Checkpoint

8A – Wings Pickup
8B – Jetpack Pickup
8C – Fan Pickup

You can’t use this to farm Gems and Yarn, they won’t count.

Hex Values – Fans, Ladders & Spikes

27 & 28 – Right Fan (Color 1)
29 & 2A – Left Fan (Color 2)
2B & 2C – Up Fan (Color 1)
2D & 2E – Down Fan (Color 2)

37 – Up Ladder (Color 1)
38 – Up Ladder (Color 2)
39 – Right Ladder (Color 1)
3A – Right Ladder (Color 2)
3B – Left Ladder (Color 1)
3C – Left Ladder (Color 2)
3D – Down Ladder (Color 1)
3E – Down Ladder (Color 2)

2F – Up Spikes (Color 1)
30 – Up Spikes (Color 2)
31 – Right Spikes (Color 1)
32 – Right Spikes (Color 2)
33 – Left Spikes (Color 1)
34 – Left Spikes (Color 2)
35 – Down Spikes (Color 1)
36 – Down Spikes (Color 2)

Hex Values – Portals & Trigger Blocks

3F – Up Portal (Color 1)
40 – Up Portal (Color 2)
41 – Down Portal (Color 1)
42 – Down Portal (Color 2)
43 – Left Portal (Color 1)
44 – Left Portal (Color 2)
45 – Right Portal (Color 1)
46 – Right Portal (Color 2)

C4 & E2 – Trigger Button (Color 1)
C5 & E3 – Trigger Button (Color 2)
C6 – Trigger Block (Color 1)
C7 – Trigger Block (Color 2)
C8 – Trigger Rocket Platform (Color 1)
C9 – Trigger Rocket Platform (Color 2)

Hex Values – Lasers

23 – Laser Source (Right)
24 – Laser Source (Down)
25 – Laser Source (Left)
26 – Laser Source (Up)

CF – Laser Startup (Left)
D0 – Laser Heatup (Left)
D1 – Laser (Left)
D2 – Laser End (Left)

D3 – Laser Startup (Right)
D4 – Laser Heatup (Right)
D5 – Laser (Right)
D6 – Laser End (Right)

D7 – Laser Startup (Up)
D8 – Laser Heatup (Up)
D9 – Laser (Up)
DA – Laser End (Up)

DB – Laser Startup (Down)
DC – Laser Heatup (Down)
DD – Laser (Down)
DE – Laser End (Down)

Hex Values – Moving Blocks

58 – Moving Block (Color 1)
59 – Moving Block (Color 2)
5A – Moving Block (Color 1, Vibrating)
5B – Moving Block (Color 2, Vibrating)

5C – Moving Block (Color 1, Moving Right)
5D – Moving Block (Color 2, Moving Right)
5E – Moving Block (Color 1, Moving Left)
5F – Moving Block (Color 2, Moving Left)
60 – Moving Block (Color 1, Moving Up)
61 – Moving Block (Color 2, Moving Up)
62 – Moving Block (Color 1, Moving Down)
63 – Moving Block (Color 2, Moving Down)

Hex Values – Decorations

73 – Chapter Door (Open)

75 & 76 – Finale Enterance (Unuseable, Shows Controls)
77 – Finale Enterance (Unuseable, Doesn’t Show Controls)

79 – Grass (Type 1)
7A – Grass (Type 2)
7B – Grass (Type 3)
7C – Grass (Type 4)
7D – Grass (Type 5)
7E – Grass (Type 6)
7F – Grass (Type 7)
80 – Grass (Type 8)

Grass attracts Horses and makes them stay in place.

AB – Arrow Sign (Left)
AC – Arrow Sign (Right)
AD – Arrow Sign (Up)
AE – Arrow Sign (Down)

AF – Tutorial Sign (Throw)
B0 – Tutorial Sign (W)
B1 – Tutorial Sign (Electricity)
B2 – Tutorial Sign (Water)
B3 – Tutorial Sign (Spikes)
B4 – Tutorial Sign (Death)
B5 – Tutorial Sign (Mystery)
B6 – Tutorial Sign (Boat)
B7 – Tutorial Sign (Helping Friend)
B8 – Tutorial Sign (Rocks)
CD – Tutorial Sign (Horse)
CE – Tutorial Sign (Sliding)

Tutorial Signs can be used to block Hoverbridges and Lasers.

6B – Checkpoint (Activated)
6C, 6D & 6E – Level Enterance (Unuseable)
B9 – Lamp
BA – Trading Post (ᵈᶦˢᵃᵖᵖᵉᵃʳˢ ᵒᶰᶜᵉ ᵗʰᵉ ᶫᵉᵛᵉᶫ ˢᵗᵃʳᵗˢ)

Warning, General Info & Examples

Please DO NOT use this to make broken levels and upload them to the Workshop, the point of this guide is to open up the Level Editor with more blocks and enemies to use and not to clog the Workshop with broken levels. Editing levels with Hex Editor and uploading them to Workshop won’t get you banned.

Here are some awesome workshop examples which were made by Hex Editing:
[link]
I can add yours here too, only requirement is that it’s good and uses bolded value blocks few times, post a link to it in comments.

Rate The Guide!

If this guide has helped you, please, rate it up, it took some time to make this guide and an upvote would be appreciated! Also. if you wish to find this guide again make sure to favorite it! You can do all this on top of the page, thanks! You can check my other guides and follow me if you like my work here!

You can view my other Battleblock Theater guides here!