Whitehole

From Super Mario Galaxy wiki
Jump to navigation Jump to search

Whitehole is a Super Mario Galaxy 1 and 2 level editor written in the Java programming language.

Story and Development

Whitehole is the successor to Anarchy in the Galaxy (sometimes just referred to as Anarchy). Both computer programs were developed as stage editors for the Super Mario Galaxy games, where Whitehole added many more features and built-in tools, and most notably, a 3D rendering of the stages (which Anarchy lacked).

Development for Anarchy began sometime in early 2010 or 2011, some even believe before the 2nd Galaxy game came out, by a user(s) known as/by (???). The tool gained popularity as the online Kuribo64 forums opened in 2012, which hosted many of the early Galaxy hacking scenes.

Whitehole wouldn't begin development until 2012, when its earliest builds would be released to Kuribo64's uploader.

From this day on; Whitehole, while other projects to replace it have occurred but all failed (Shibboleet's Takochu, and SuperHackio's Starlight, to name a few), still remains as the main stage editor for Galaxy hackers.

Versions

There are several Whitehole versions in existence and people often get confused about which one to select. Whilehole Neo is the one of recommended use currently. You can get the Java Runtime Environment (JRE) versions for each Whitehole from here

Whitehole 1.6

This Whitehole version has features that were deleted on Whitehole 1.7. Works for SMG1/2. Requires JRE 8 to work.

To setup the object database, grab the objectdb.xml from here and put it in the same place as the Whitehole.jar file.

Whitehole 1.7

Works for SMG1/2. Requires JRE 17 to work.

To setup the object database, grab the objectdb.xml from here and put it in the same place as the Whitehole.jar file.

Note: To be able to open SMG1 with this version you have to follow some extra steps (it involves deleting unused SMG1 zones).

Whitehole for SMG1

Only to be used with SMG1 and for its Zone-Layer built-in editor. Although you can use it to edit SMG1 levels if you want (you cannot update the object database). Requires JRE 8 to work.

Whitehole Despaghettification

Works with SMG1/2. Can run with JRE 11 up to 17.

The object database file objectdb.json should be already in the data folder of the tool so you don’t have to set anything up for it. Despag will auto update the object database each time it is ran.

Whitehole Neo

Works with SMG1/2. Can run with JRE 11 up to 17. It is based on Whitehole Despaghettification and it is currently at its beta stage.

Screenshots

  • TODO

Troubleshooting

If executing Whitehole Despag or 1.7 from Windows and you experience issues (galaxies not opening or part of the rendering screen of the program is blue) paste the following line of code into a Whitehole.bat file in the same place the Whitehole.jar is and double click on it to run the program.

java --add-exports=java.desktop/sun.awt=ALL-UNNAMED -Dsun.java2d.uiScale=1.0 -jar Whitehole.jar

If issues persist, report the bug in the respective tool repository or ask for help in a SMG modding related server.

Notes

  • If your computer has an old graphics card then Whitehole might not render the galaxies corrently. Specifically, Whitehole 1.7 does not work well under Intel Integrated Graphics.
  • Whitehole Despag downloads automatically (each time it is started) its object database.
  • Newer object databases don't work for Whitehole for SMG1.
  • Whitehole Despag does not render gravity areas.

See also