Whitehole Wii

Whitehole
Whitehole
General
Author	Arisotura, SunakazeKun, TheSunCat
Type	Hack Utilities
Version	1.7fix
License	Mixed
Last Updated	2022/04/05
Links
	Download
	Website
	Source

Whitehole (Despaghettification) is a modernized version of Whitehole, a level editor for Super Mario Galaxy and Super Mario Galaxy 2 originally by Arisotura. This is an experimental fork that aims to make the program more stable while newer editors are being developed, such as Blackhole or Takochu. It removes a lot of unused code and broken features that were introduced between versions 1.4 and 1.7.

Several outdated or questionable parts of the code have been upgraded, but there's still a lot more waiting to be improved. Major new additions include support for the new object database, simple galaxy names that are displayed on the main window and a completely new Light Mode and Dark Mode UI. It is also fully compatible with all of SMG1's stages. Tons of bugs introduced in older versions of Whitehole have been fixed as well.

All releases can be found on the releases page.

User guide

Requirements

Whitehole runs off newer Java versions due to JOGL being outdated.

Oracle Java jre 8.
Oracle Java jdk 11.
- Adoptium can be used, but it will not fix some issues.
- With this new Whitehole version, Java requires an update.

How to update Java:

On Linux, install jre-openjdk-headless
On Windows, use a browser to navigate to https://adoptium.net/ and download the executable. Make sure you selected Java 17 (or whatever the latest version is). You can leave the default options for the installer, but make sure "set JAVA_HOME" is selected and proceed with the install. If Java apps stop opening, you may need to restart your computer to apply the registry changes.

If Galaxies do not open, try this command: java --add-exports java.base/java.lang=ALL-UNNAMED --add-exports java.desktop/sun.awt=ALL-UNNAMED --add-exports java.desktop/sun.java2d=ALL-UNNAMED -jar Whitehole.jar

How to use

First you need to obtain the game files, you can use CleanRip to dump the game, and Dolphin Emulator to extract the files from the ISO.

Launch Whitehole, note that you will also need the Object Database file.

Click Select game folder and navigate to [your game file location] > DATA > files and press open.

Then it will display a list of all the existing galaxies. Select one of the galaxies and open it.

Whitehole usage guide.

Controls

Left-mouse drag or Arrows/Numpad - Pan camera

Right-mouse drag - Rotate camera

Mousewheel or PageUp/Down or Numpad 3/9 - Zoom

Left click, hold Ctrl/Shift to select multiple - Select Object

Drag left click on selected object(s) or P+Arrows/Numpad or Press G+Move the mouse - Move Object

R+Arrows/Numpad or R+Move the mouse - Rotate Object

S+Arrows/Numpad or S+Move the mouse - Scale Object

Delete - Delete Object

Ctrl+C/V - Copy/Paste Selection

Ctrl+Z/Y - Undo/Redo

Ctrl+Shift+C - Screenshot

Screenshots

Media

Whitehole Lessons with DudeGamer64 | Lesson 1: Exporting and Playing (DudeGamer64)

Whitehole Tutorial #1: Basic Launch Star Paths (Xandog)

Changelog

Version 1.7

Added:

Some area colors have been changed.
"MessageID.tbl" option added in The BCSV Editor, done by Evanbowl.
More BSCV stuff.
Use proper Shaders.

Bugs:

Dark Mode broke in the Galaxy Editor and BCSV Editor.
Little Endian mode does not work (forced off).

Bug Fixes:

Title bar now shows "Whitehole v1.7" rather than "Whitehole".
"CollisionArea" is now a cube, as it should be.
CloudSky Skybox issues no longer exist.

Version 1.5.5

Added:

Work in progress Obj importer.
Work in progress Keybinds customizer.
Work in progress Riivolution-like mod opener: Open a mod on top of the vanilla game files.

Version 1.5.4 (by TheSunCat)

Key new features:

Select a mod folder to save any modified files to.
Remap main editor keybinds in the Settings menu.
RARC file association and editor.
A visual MSBT editor.
An MSBF editor (will be updated once the format is properly documented).
A camera generator, directly integrated with the level editor (creates CAM_TYPE_XZ_PARA).
A camera previewer.
Copy-and-paste objects at will.
Undo and redo changes.
Up to 3x faster load times.
Many productivity changes, including blender-like shortcuts for common actions.
Discord Rich Presence.
Anti-aliasing.
Screenshot the current view at the press of a button.
A TransparentWall10x10 and 10x20 renderer.
Better power star rendering.
Added openGL compatibility checks to ensure support for older video cards (requires it to be on in the settings).
Made a ton of productivity changes to allow more control with the keyboard (ex: pressing enter when typing a path in the BCSV editor to open it).
General system stability improvements to enhance the user's experience.

Unfinished or semi-implemented features:

A visual CANM (intro cutscene) editor.

Bugfixes:

Fixed objects that are in rotated zones not moving in the correct direction when dragged.
Fixed the Map corrupting if cancel is pressed when asked to save changes.
Fixed whitehole not rendering some custom models that will still work ingame.
Fixed general saving bugs and added a handler for failed saving (thanks shibbo).
Made all error messages clearer and handled better (and with punctuation).

v1.4.3

Added: Full support for paths and path points!
Added: Multi-renderer, which replaces the old Double and Triple renderers.
Added: New object rendering (coins, black holes, ...).
Added: Gravity rendering.
Added: Obj_arg descriptions are displayed to show more information about the current object.
Added: Improved property field names.
Added: Randomized path colors which replace the previous ones.
Added: ShapeModelNo editing and rendering has been completely reworked and it doesn't crash the program anymore..
Fixed: Area rendering for SMG1 has been specified.
Fixed: Wrap and filter modes for BMD and BTI renderers weren't properly configured.
Fixed: Position, rotation and scale copying doesn't work.
Fixed: Editing cutscenes freezes the program when saved.
Fixed: Crash if a non-existing model file can't be loaded.
Misc.: A lot of cleanup, although there's still a lot of terrible code...

v1.4.2.3

Added shape model rendering.
Added a new area renderer.
Added a marker for zones.
Added selection boxes for GravityType, GravityPower and PosName.
Added controls for faster moving, rotating and scaling.
Copy-pasting position, rotation and scale.
The object database URL can be changed.
Improved object rendering.
Various other fixes and tweaks that aren't worth mentioning.

v1.4.2.2 (by SunakazeKun)

Added back ChildObj editing along with some info messages when trying to open certain galaxies and zones.
Added yaz0 encoding when saving as well as options for this.
Added options for UseResource editing in the BCSV editor.
Added some options to switch between themes.
Object selection has been improved:
- You can now type in the name of the object and add it without selecting it from one of the categories.
- More information about the currently selected object, including Obj_args and files.
Improved object rendering.
Improved hash generator.
Fixed a bug with GeneralPos rendering which prevents users from opening SkullFishGalaxy.
Fixed a few bugs with various object settings.
Fixed wrong models, textures and colors after closing and opening a galaxy while viewing one of its zones.
Fixed fake color not loading while not having moved the camera.
Removed the option for downloading the object database from Kuribo64.
Various other fixes and tweaks that aren't worth mentioning.

External links

Database - https://sunakazekun.github.io/galaxydatabase/
GitHub (database) - https://github.com/SunakazeKun/galaxydatabase
GitHub - https://github.com/TheSunCat/Whitehole
GitHub - https://github.com/SunakazeKun/Whitehole-Despaghettification
GBAtemp - https://gbatemp.net/threads/whitehole-v1-4-2-2-a-super-mario-galaxy-level-editor.441853/
GBAtemp - https://gbatemp.net/threads/whitehole-super-mario-galaxy-1-2-level-editor.335218/
Kafuka Boards - https://board.kafuka.org/thread.php?id=442