The level editor features a large 20,000 x 10,000 "stage" that can be used, with the outer edge featuring a thick, default-blue wall. The level editor has a shape limit of 600, and an art limit of 1000 (see below to find out how much an object takes up in shapes or art, and how to increase the art and shape limits). When entering the level editor, the help box to the right will show a welcome message. The left side controls what feature is currently being used, but by default, it will not be on any.
A character must always be present in the stage, so Wheelchair Guy will be the default character when entering the level editor. His default starting x-coordinate is 300, and his default starting y-coordinate is 5,100. The camera will automatically be at that location upon entering.
The smallest possible shape in the editor is a 2 x 2 polygon triangle, while the biggest possible shape is a 20,000 x 10,000 polygon shape that takes up the entire map. The smallest possible shape made by the shape tool is a 5 x 5 circle, and the biggest is a 5,000 by 5,000 rectangle.
The level editor dropdown menu appears in the top-left corner of the level editor. It includes these seven options:
- Test Level: This allows one to play their level in its current state as if it were a finalized user level, allowing them to check for bugs and make sure the level works as it is supposed to. You can also test the level by simply press the "T" key on your keyboard. To stop testing, press "T" again.
- Level Options: This will make another menu appear in the middle of the screen. This menu only includes two options: the level backdrop and the background color. The available backdrops are blank, green hills, and city. Green hills features a background similar to that in Happy Green Hills, while City features a background full of buildings, similar to the buildings available as special items. The other option, background color, allows you to change the background with only color, instead of using non interactive shapes for background. The background color you select will be visible during gameplay, but not while you edit.
- Save Level: This allows users to upload their levels to the Total Jerkface servers. One may choose their level's name and add comments to it in the save menu. Levels can be made public after saving, allowing it to be played via the "browse user levels" menu. Once a level has been made public, it can no longer be overwritten. Edited public levels can only be saved as a new level. Alternatively, levels can be saved in text form as XML data (check the LevelXML page for more information about level XML data). Only registered users may save their levels. You can save it as a new level, which will come up in the load level menu, or overwrite the level, which will save over the old level. If you click on this option before testing, a message will appear telling you to test your levels before saving. It is recommended that users should use the XML saving system to ensure level data is not lost.
- Load Level: This level brings up the user's list of saved levels, along with a text box for importing XML data for levels, and a button to delete the selected level. Like saving levels, only registered users may load levels.
- New Level: This erases the current level completely. The user is warned that this option cannot be undone.
- Show help: This toggles help boxes which appear by default. Help boxes may also be removed without the show help toggle by click on the "x" on the top right corner of the help box.
- Debug Draw: This shows all physics and shapes when testing your level.
- Main Menu: This will bring you to go back to the main menu. Upon clicking it, it says "Are you sure you'd like to exit to the main menu? Unsaved work will be lost FOREVER".
- + / = (plus/equals key)/ Mouse Wheel Up - Zoom into level editor (will zoom in where cursor is located).
- - (minus key)/ Mouse Wheel Down - Zoom out from level editor (will zoom out where cursor is located).
- 1 - Selection Tool.
- 2 - Shape Tool.
- 3 - Poly Tool.
- 4 - Joint Tool.
- 5 - Special Item Tool.
- 6 - Text Tool.
- 7 - Trigger Tool.
- Left Mouse Click - Select a category, check tick boxes, place down object, select anything placed in stage, move around menu's (hold mouse button), move around anything placed (hold mouse button), etc..
- Hold Shift + Left Mouse Click - Select multiple shapes/objects/NPCs or deselect a single object without deselecting everything that is currently selected.
- Hold Space + Left Mouse Click - Click and drag to pan around the level editor area.
- Tab - move to next typing selection (on the on-screen menu). Pressing Tab without anything selected will select any text placed in the level.
- Backspace - Deletes whatever is selected.
- Control + Z - Undo last action.
- Control + Y - Redo last action.
- Control + Up - Raise shape/object/NPC depth closer.
- Control + Down - Raise shape/object/NPC depth further.
Note: 'Depth' means what layer it is on, having something with the closest depth will mean it's in front of everything else, while the furthest depth will be behind everything.
- T - Test level, press again to exit testing.
- F - While testing your level, press F to place a current-location marker, when you exit testing, there will be a large red circle indicating where you pressed F, testing the level again will remove any placed markers. It can be used 100 times each test.
- W - Increase height of shape/object (if it can be adjusted).
- S - Decrease height of shape/object (if it can be adjusted).
- D - Increase width of shape/object (if it can be adjusted).
- A - Decrease width of shape/object (if it can be adjusted).
Note: Hold Shift to increase/decrease by 10 each time. Multiple selected shapes/objects can be modified at the same time.
- Z - Rotate shape/object/NPC counter-clockwise (if it can be rotated).
- X - Rotate shape/object/NPC clockwise (if it can be rotated).
Note: Hold Shift to rotate by 10 each time. Multiple selected shapes/objects can be modified at the same time.
- Up Arrow Key - Move shape/object/NPC up by one.
- Down Arrow Key - Move shape/object/NPC down by one.
- Left Arrow Key - Move shape/object/NPC left by one.
- Right Arrow Key - Move shape/object/NPC right by one.
Note: Hold Shift to move 10 times more than the normal rate. The amount moved depends on what level of zoom you are in, further out = larger jumps in movement. Multiple selected shapes/objects/NPCs can be moved at the same time.
- C - Copy shape/object/NPC.
- V - Paste shape/object/NPC, hold Shift to paste it at the exact same spot it was copied.
Main article: Shapes
Shapes are the base object for Happy Wheels. They are used to make art, ground and basically are 90% of the level most of the time. There are 3 different shapes: rectangles, circles and triangles.
Shapes can be fixed in place so that they will never move or budge, while if set as "unfixed" ("fixed" unchecked) makes them act as a natural object that falls. Shapes can also "sleep", which makes them frozen until they collide with something. The interactive toggle determines whether shapes are physically "there", or simply background objects. Non-interactive shapes cannot be set to sleep, and they lower the art count rather than the shape count. Non-interactive objects and non-fixed objects can be grouped.
By holding Ctrl + up or down arrow key, you can alter the depth of the shape/group, which changes which shape/group can overlap what shape/group. Holding Ctrl + down will make the object fall down a layer while Ctrl + up will move it up a layer. Selecting a shape (or multiple) and pressing C and then V clones the shape at the center of the visible screen, if Shift + V is pressed, it will paste the shape on the same coordinates they were copied. You can delete a shape by selecting it and pressing backspace (delete for Macs).
As of version 1.41, individual shapes can be given collision settings, which determine what type of object can hit each shape:
- 1. Collides with everything.
- 2. Collides with objects, but not characters or character vehicles.
- 3. Collides with nothing, usually for joints and background physics.
- 4. Collides with all objects except other collision 4 shapes.
- 5. Collides only with fixed shapes.
- 6. Collides only with fixed shapes and other shapes with collision set to this value.
As of Version 1.61, you can cut a hole in the center of circles, useful for making wheels on cars or bikes, this, however, is only a visual effect, so nothing can be placed inside. Jim stated that this was a requirement of the physics engine.
As of Version 1.77, you can now select any color in the level editor using the color dropper in the color selector. This replaces the older way to grab a color from anywhere in the level editor, which was by dragging the circle inside the color spectrum onto somewhere outside the color selector.
Main article: Polygons
Polygons are an alternative to shapes. They are used to create more complex objects besides squares, circles and triangles. All polygons have a maximum of 10 vertices when interactive, and 50 when not. When a polygon is interactive, you are limited to make shape edges clockwise. When not interactive, you can place edges in any direction. They have the same properties as shapes: opaqueness, density and collision. You cannot change the shape or the interactive/non-interactive properties of a polygon once it is made.
Main article: Joint Tool
Joints are used to attach one object to another and to add motors to objects. Motors are most commonly used to create wheels (attaching a circle shape to a base using a motored joint), but many levels have alternate uses for motors, such as doors, swings, and spinning obstacles. To make a simple spinning object, place an unfixed shape, add a joint to it, and set "enable motor". The v1.79 update adds sliding joints which only slide on a single axis.
Motors spin objects counter-clockwise by default, but placing a "-" in front of the Motor Speed value causes the motor to spin the object clockwise. If a joint is placed onto an object with no other shape behind it, the object will be jointed to the background.
The pin joint is the original kind of joint added in the origional release of Happy Wheels. Selecting the "limit rotation" box allows you to determine stopping points for your motor. When the motor reaches either of the values in the "Upper angle" and "Lower angle" areas, it will cease to spin. A stopped motor will act as a fixed object unless an object of greater force than the current Motor Torque hits it.
After v1.45, the pin joints were redesigned to have pointing arrows, rather than being just a circle. The reason for this is currently unknown, but it may be so people will understand that objects are supposed to rotate counter-clockwise when the motor speed is set to a positive number.
Motors can be applied to joints by checking the "enable motor" box allowing either a rotation or a slide motor depending on what joint you are using.
- Motor Torque is the force used to rotate a joint. Known as "motor force" for the sliding joint, an object of high density cannot be rotated when a motor has a low amount of torque. The maximum Motor Torque value is 99999.
- Motor Speed determines how fast a motor spins. It does not independently determine the force of a motor, however, so a motor of very high speed can still be easily stopped by an low-density object if the motor has a low Motor Torque. The maximum Motor Speed is 20.
Sliding JointThe sliding joint was added in the v1.79 update and allows mechanics like an elevator to be made much more easily. Checking the "limit range" box allows you to determine when the object jointed to the sliding joint will stop moving. An "axis angle" bar on the top allows you to adjust the angle at which the sliding joint slides. Just like the pin joint, the sliding joint has an "enable motor" box, as well as a "collide connected" box.
Main Article: Special Items
Special items are a variety of detailed items, with many being destroyable, such as fruit, electronics, and tables. These items have a high shape count compared to regular shapes. Some have many toggles, while others are simply placed on the stage.
Main Article: Text
The Text tool allows you to type text or numbers, and place it in a level. Text is non-interactive.
There are currently 5 font types:
1. Helvetica, regular.
2. Helvetica, bold. This is the default font.
3. Helvetica, a lot more bold.
4. Clarendon, regular.
5. Clarendon, bold.The size of the text ranges from 10 - 100. Its default size is 15.
Alignment can be changed on the text, with left alignment, middle alignment, and right alignment possible.
Text can be rotated, colored, and transparentized. It can also be grouped.
You can also attach it to a trigger to change the opacity or slide the text.
Main article Trigger Tool
The trigger tool is used to activate various objects, such as jets, fans, and even wrecking balls. It can also play sound effects and to win the level. If a trigger is used to win a level, you do not have to be alive.
Pressing "F" while testing a level will play a "ping" sound and create a flag point in the level editor to see where you were when you pressed it. This is useful for seeing where you land from a high distance. A flag point looks quite like the old pin joint, except it's larger, is pinkish-red, and has lower opacity. The feature was implemented in the v1.49 update. Testing the level again after placing the flag point will cause it to disappear. You are allowed 100 of these in one test.
Playable Character OptionsClicking the character in the level editor will give you multiple options, like changing it to one of the other playable characters, editing coordinates, making the character forced, and hiding the vehicle. Forcing a character will result in the publicly saved level only allowing that specific character to be played. Hiding the vehicle will remove the character's vehicle so it will not be used in the level. If you check it off on a dual character such as Irresponsible Dad, Moped Couple, or Santa Claus, the secondary character(s) will be gone along with the vehicle.
On v1.58, a new tool that allows functioning custom vehicles to be made was included.
You can enter groups/vehicles by double clicking on a grouped object, and editing it instead of breaking the group and editing it. When double clicking to enter a group, anything outside of the group will darken, and anything that is not part of the group can not be edited until the group is deselected. To exit group editing, double click something that is not part of the group (such as the background).
Pressing "T" while editing a group will result in the red message at the top of the editor to display "exit group before testing level".
- As per the v1.51 update, it seems that the level editor may crash for no apparent reason when you try to test a level. This could happen for a number of reasons: you need a new graphics card, update your drivers, etc.
- On Macs and some Windows computers, sometimes levels such as 'don't moves' don't work because they were made on a different computer. For example, a Windows XP user-created 'don't move' level won't work on a Mac. This happens due to different computers having different processors, which process the game differently. This is also the reason for accurate and inaccurate replays.
- As of v1.75 update, if you use the scroll wheel to zoom in or out, it also moves your browser page up and down. Jim has stated this will be fixed but it's a low priority issue.
The level editor has many glitches and exploits that can create unintentionally strange effects in playable levels, these include:
- Black Hole Glitch. This glitch will teleport the player and everything un-fixed to the top left of the screen, it happens when the player hits a shape with incorrect values. To make a Black Hole, place any shape and uncheck 'Fixed' then in 'Density' type: "." . and press enter, it will change the value to say NaN. Place the shape on the map, and when you come in contact with it, you will be teleported to the top-left of the screen (you will not be able to do anything, so restarting is necessary). This glitch can also work for some special objects, such as: Spikes, Boosts, Fans, Blade weapons, etc. On the 'Rotation' of the object, type: - and press enter so that it turns into NaN. The shape will not be able to rotate any longer and will always remain in the default rotation. When doing this the shape will become 'Un-interactive' so it can be seen in-game but you will go right through it, and it will have no effect on you (note: The black hole glitch only works if your characters heart touches the shape).
- Melt Glitch: This glitch will have the player and un-fixed objects 'melt', they will get pulled downwards until they fall through the bottom of the map. To perform this glitch, place a Spring Platform onto the map, then place a Black Hole (explained above) above the Spring Platform, so that, when hit, it will hit the Black Hole. This will cause the top Spring Platform piece to disappear (and go to the top left of the screen) and everything else will slowly "melt" downwards. If you attempt to do this with a Paddle Platform, instead of the melt glitch, everything will turn into a black hole. The Melt Glitch does not work on rails, because the rail does not have a toggle for being fixed or un-fixed. Though, buildings can't be toggled as fixed or un-fixed, but you'll melt into them anyway.
- Ultimate Spin: To perform this glitch, place a Pin Joint with a motor torque of 99999 onto any non-fixed object (it can be a shape or a special item), then set the motor speed to "NaN", which is done by typing "-" into the Motor Speed value and pressing enter. Once this has been done the object will spin at a ridiculously fast speed and can easily destroy very strong objects. Even 5x5 shapes can be deadly with this glitch applied.
- Art limit message glitch: This glitch occurs when in the level editor, if the shape or art limit is reached and you don't delete any shapes, quit out of the level editor and don't save, the red text: 'You've reached the art limit. Delete some art objects' will remain still on the screen even when you're not in the level editor.
- Shape/Art limit glitch: This glitch makes the shape/art limit increase, but the level itself does not change. Jason says it is a side effect of the v1.56 update. To perform the glitch, save the level, then load the level a couple of times.
- Debug Draw glitch: This glitch occurs when the player enables the debug draw option, leaves the level editor, returns, and tests the level. The "debug draw" feature remains enabled even though it automatically disables itself when the player leaves the editor.
- In the past (the specific date is unknown), when you click on a pink or blue button, a clicking sound plays. This has been removed, it is unknown why.
- It has been confirmed that the upcoming app will have a level editor, however, it is unknown how the level editor layout will look like.
- Jim based the keyboard shortcuts on Adobe Flash shortcuts. Rotating, copying, and pasting are all the same in Adobe Flash.
- The lighting in the Level Editor comes from the right of the stage, as shown from Building 2.
- Collision 5 and 6 shapes can't collide with fixed collision 2 and 4 shapes, even though it was stated that they can collide with fixed shapes.
Differences in Public and Level Editor Levels
- In the level editor, you cannot pause or rate a level.
- To end a level, you have to press "T" to stop.
- You can't view or save a replay in the editor.
- The "VICTORY" logo doesn't appear in the level editor when you win the level.
For a tutorial on how to make a running NPC and buttons, click here.