3D Pinball - Space Cadet Wii: Difference between revisions

3D Pinball - Space Cadet
3D Pinball - Space Cadet
General
Author	MaikelChan
Type	Arcade Games
Version	0.3
License	MIT License
Last Updated	2024/02/09
Links
	Download
	Website
	Source

Latest revision as of 09:34, 15 July 2024

This is a port of 3D Pinball - Space Cadet for Nintendo Wii. It's originally a game that came bundled with Windows from Windows 95 up to Windows XP.

Current status:

Compatible with 3D Pinball - Space Cadet and the Space Cadet table from Full Tilt! Pinball.
No menus, options, or results screen.
Playable with the Wii remote and the GameCube pad.
Supports sound effects and music (music must be supplied in OGG format).
Some bugs may be present, but overall, it's a playable experience.

Changes for Wii Port:

Used native GPU rendering with the GX library for improved performance on the Wii.
Adapted the original game's binary assets to work on the Wii's big endian CPU architecture.

Installation

Note: You will need to get the original PC game on your own to obtain the assets like graphics and sound effects. Those are not provided.

Wii with Homebrew Channel

Copy .dol file:

Rename SpaceCadetPinball.dol to boot.dol.
Copy boot.dol to apps/SpaceCadetPinball/ on your SD card.
Go to the sd folder in the repository and copy its contents to where the .dol file locates (used for loading Homebrew Channel apps).

Copy game assets:

For legal reasons, acquire the original PC game separately to obtain assets like graphics and sound effects. These assets are not included in this repository.
Copy all PC game assets to apps/SpaceCadetPinball/Data/ on your SD card. For Full Tilt! Pinball, copy all files and the SOUND folder located inside the CADET folder.
Since this port doesn't play MIDI files, convert the music to OGG format. Ensure the music has a sample rate no higher than 44100Hz.
- 3D Pinball - Space Cadet - Name the file PINBALL.ogg and place it among other assets in the Data folder.
- Full Tilt! Pinball - Name the file TABA1.ogg and put it among other sound files in the Data/SOUND folder.
If all steps are successful, you should see the game in your Homebrew Channel and be able to run it.

Dolphin emulator

Setup virtual card:

Obtain the Dolphin emulator if you don't have it.
Create and edit a virtual SD card following these instructions.
Mount that virtual card.

Copy .dol file and game assets:

Copy SpaceCadetPinball.dol to apps/SpaceCadetPinball/ on the virtual SD.
Copy all PC game assets to apps/SpaceCadetPinball/Data/ on the virtual SD. For Full Tilt! Pinball, copy all files and the SOUND folder located inside the CADET folder.
Since this port doesn't play MIDI files, convert the music to OGG format. Ensure the music has a sample rate no higher than 44100Hz.
- 3D Pinball - Space Cadet - Name the file PINBALL.ogg and place it among other assets in the Data folder.
- Full Tilt! Pinball - Name the file TABA1.ogg and put it among other sound files in the Data/SOUND folder.

Configure Dolphin and run it:

Open Dolphin, go to Config, then to the Audio tab, and select DSP LLE REcompiler (slow) for audio to work.
In Graphics settings, go to the Hacks tab, and move the Accuracy slider all the way to the left to set it as Safe.
Go to the menu File and then Open....
Locate and open SpaceCadetPinball.dol (or boot.dol if renamed for the Homebrew Channel).
If all configurations are correct, you should be able to run the game on Dolphin.

Controls

Wiimote:

A - Launch the ball

Z/B - Move the left/right paddle

D-Pad Left/Right/Up - Bump table

Minus - Start a new game

Plus - Pause

GameCube Pad:

A - Launch the ball

L/R - Move the left/right paddle

D-Pad Left/Right/Up - Bump table

Y - Start a new game

Start - Pause

Media

Running Windows Space Cadet Pinball on the Nintendo Wii (Michael MJD)

Known source ports

Platform	Author	URL
PS Vita	Axiom	Space Cadet Pinball Vita
Emscripten	alula	GitHub
Nintendo Switch	averne	Space Cadet Pinball NX
webOS TV	mariotaku	GitHub
Android (WIP)	Iscle	GitHub
Nintendo Wii	MaikelChan	3D Pinball - Space Cadet Wii
Nintendo 3DS	MaikelChan	3D Pinball - Space Cadet for 3DS
Nintendo DS	Headshotnoby	3D Pinball - Space Cadet for DS
Nintendo Wii U	IntriguingTiles	GitHub
MorphOS	BeWorld	MorphOS Storage
AmigaOS 4	rjd324	Aminet
Android (WIP)	fexed	GitHub
Web	stech11845	GitHub

Changelog

v0.3

Fixed endianness issues that would break Full Tilt compatibility. Now the Space Cadet table from Full Tilt can be played.
Make text a bit more fitting for the wii by @korbosoft.
Print some errors on screen to better indicate possible failures.

v0.2

The game now loads the good font that's embedded in pinball.exe.
In case that font is not available, the one in PINBALL2.MID is scaled down and has the same color palette as the other font, so it fits better and it's more readable.
Also deleted the font that was included in EmbeddedData.cpp.

v0.1

It can be playable with a Wii Remote or a GameCube pad.
Fully playable with some minor bugs.
It lacks menus or score results window.

External links

GitHub - https://github.com/MaikelChan/SpaceCadetPinball
Open Shop Channel - https://oscwii.org/library/app/SpaceCadetPinball

@@ Line 1: / Line 1: @@
-{{#seo:
-|title=Wii Homebrew Games (Arcade Games) - GameBrew
-|title_mode=append
-|image=3dpinballspacecadetwii.png
-|image_alt=3D Pinball - Space Cadet
-}}
 {{Infobox Wii Homebrews
 |title=3D Pinball - Space Cadet
-|image=3dpinballspacecadetwii.png
+|image=spacecadetpinballwii2.png
 |description=3D Pinball for Wii - Space Cadet.
 |author=MaikelChan
-|lastupdated=2021/10/31
+|lastupdated=2024/02/09
 |type=Arcade Games
-|version=0.2
+|version=0.3
 |license=MIT
-|download=https://dlhb.gamebrew.org/wiihomebrews/3dpinballspacecadetwii.7z
+|download=https://dlhb.gamebrew.org/wiihomebrews/spacecadetpinballwii.7z
 |website=https://github.com/MaikelChan/SpaceCadetPinball
 |source=https://github.com/MaikelChan/SpaceCadetPinball
 }}
-This project is a port of the classic game '''3D Pinball - Space Cadet''' for the Nintendo Wii. Originally bundled with Windows from 95 to XP, this port brings the game to a new platform.
+This is a port of 3D Pinball - Space Cadet for Nintendo Wii. It's originally a game that came bundled with Windows from Windows 95 up to Windows XP.
-Currently, the project is in a playable state with some limitations. There are no menus, options, or results screens yet, but it can be played with a Wii remote or GameCube pad. Sound effects and music can be played if the player supplies the music in OGG format. However, there may still be some bugs present.
+Current status:
+* Compatible with 3D Pinball - Space Cadet and the Space Cadet table from [https://en.wikipedia.org/wiki/Full_Tilt!_Pinball Full Tilt! Pinball].
+* No menus, options, or results screen.
+* Playable with the Wii remote and the GameCube pad.
+* Supports sound effects and music (music must be supplied in OGG format).
+* Some bugs may be present, but overall, it's a playable experience.
-The port was based on a PC decompilation made by k4zmu2a and can be found on [https://github.com/k4zmu2a/SpaceCadetPinball GitHub]. The original decompilation used SDL2 for rendering, but for this Wii port, native GPU rendering with the GX library was implemented as SDL for Wii is considered incomplete and did not utilize the GPU enough, causing slow performance.
+Changes for Wii Port:
+* Used native GPU rendering with the GX library for improved performance on the Wii.
+* Adapted the original game's binary assets to work on the Wii's big endian CPU architecture.
-The necessary changes were also made to make the original game's binary assets work on the Wii, as the Wii's CPU is big-endian rather than little-endian like PC x86. These changes could also be useful for porting to other big-endian devices.
+== Installation ==
+'''Note:''' You will need to get the original PC game on your own to obtain the assets like graphics and sound effects. Those are not provided.
-== How To Run ==
+=== Wii with Homebrew Channel ===
-=== Wii with homebrew channel ===
-# Rename <code>SpaceCadetPinball.dol</code> to <code>boot.dol</code>.
-# Go to the <code>sd</code> folder in this repository, and copy its contents to the root of the SD card you use for loading apps for the Hombrew channel.
-# Copy <code>boot.dol</code> to <code>apps/SpaceCadetPinball/</code> in your SD card.
-# For legal reasons, you will need to get the original PC game on your own to obtain the assets like graphics and sound effects. Those are not contained in this repository.
-# Copy all PC game's assets to <code>apps/SpaceCadetPinball/Data/</code> in your SD card.
-# Optionally, since this port doesn't play MIDI files, you'll need to convert the music to ogg format, and call the file <code>PINBALL.ogg</code>, and put it along the other assets in the <code>Data</code> folder. Make sure that the music has a sample rate no higher than 44100Hz, or it won't play correctly.
-# If everything went fine, you should be able to see the game in your homebrew channel and run it.
-=== Dolphin ===
+Copy .dol file:
-# Get the [https://dolphin-emu.org Dolphin emulator] if you don't have it.
+* Rename <code>SpaceCadetPinball.dol</code> to <code>boot.dol</code>.
-# Create and edit a virtual SD card following [https://wiki.dolphin-emu.org/index.php?title=Virtual_SD_Card_Guide these instructions].
+* Copy <code>boot.dol</code> to <code>apps/SpaceCadetPinball/</code> on your SD card.
-# Mount that virtual card.
+* Go to the [https://github.com/MaikelChan/SpaceCadetPinball/tree/wii/sd sd folder] in the repository and copy its contents to where the .dol file locates (used for loading [[Homebrew Channel Wii|Homebrew Channel]] apps).
-# Follow the steps 4, 5 and 6 in <code>Wii with homebrew channel</code> section.
-# Unmount the SD card, as Dolphin won't be able to access its contents while it's mounted.
-# Open Dolphin, go to <code>Config</code>, then to the <code>Audio</code> tab, and select <code>DSP LLE REcompiler (slow)</code>. Audio won't work without that.
-# Go to <code>Graphics</code> settings, then to the <code>Hacks</code> tab, and move the <code>Accuracy</code> slider all the way to the left to set it as <code>Safe</code>.
-# Go to the menu <code>File</code> and then <code>Open...</code>.
-# Locate and open <code>SpaceCadetPinball.dol</code> (or <code>boot.dol</code> in case you renamed it for the homebrew channel).
-# If everything went fine, you should be able to run the game.
-==Screenshots==
+Copy game assets:
-[[image:3dpinballspacecadetwii.png]]
+* For legal reasons, acquire the original PC game separately to obtain assets like graphics and sound effects. These assets are not included in this repository.
+* Copy all PC game assets to <code>apps/SpaceCadetPinball/Data/</code> on your SD card. For Full Tilt! Pinball, copy all files and the <code>SOUND</code> folder located inside the <code>CADET</code> folder.
+* Since this port doesn't play MIDI files, convert the music to OGG format. Ensure the music has a sample rate no higher than 44100Hz.
+** 3D Pinball - Space Cadet - Name the file <code>PINBALL.ogg</code> and place it among other assets in the <code>Data</code> folder.
+** Full Tilt! Pinball - Name the file <code>TABA1.ogg</code> and put it among other sound files in the <code>Data/SOUND</code> folder.
+* If all steps are successful, you should see the game in your Homebrew Channel and be able to run it.
-==Media==
+=== Dolphin emulator ===
-'''Running Windows Space Cadet Pinball on the Nintendo Wii! - ([https://www.youtube.com/watch?v=gzmszDqN4zs Michael MJD])'''<br>
+Setup virtual card:
-<youtube>gzmszDqN4zs</youtube>
+* Obtain the [https://dolphin-emu.org/ Dolphin emulator] if you don't have it.
+* Create and edit a virtual SD card following [https://wiki.dolphin-emu.org/index.php?title=Virtual_SD_Card_Guide these instructions].
+* Mount that virtual card.
+Copy .dol file and game assets:
+* Copy <code>SpaceCadetPinball.dol</code> to <code>apps/SpaceCadetPinball/</code> on the virtual SD.
+* Copy all PC game assets to <code>apps/SpaceCadetPinball/Data/</code> on the virtual SD. For Full Tilt! Pinball, copy all files and the <code>SOUND</code> folder located inside the <code>CADET</code> folder.
+* Since this port doesn't play MIDI files, convert the music to OGG format. Ensure the music has a sample rate no higher than 44100Hz.
+** 3D Pinball - Space Cadet - Name the file <code>PINBALL.ogg</code> and place it among other assets in the <code>Data</code> folder.
+** Full Tilt! Pinball - Name the file <code>TABA1.ogg</code> and put it among other sound files in the <code>Data/SOUND</code> folder.
+Configure Dolphin and run it:
+* Open Dolphin, go to <code>Config</code>, then to the <code>Audio</code> tab, and select <code>DSP LLE REcompiler (slow)</code> for audio to work.
+* In Graphics settings, go to the Hacks tab, and move the Accuracy slider all the way to the left to set it as Safe.
+* Go to the menu File and then Open....
+* Locate and open <code>SpaceCadetPinball.dol</code> (or <code>boot.dol</code> if renamed for the Homebrew Channel).
+* If all configurations are correct, you should be able to run the game on Dolphin.
 == Controls ==
-=== Wii Remote ===
+'''Wiimote:'''
-A                    :  Launch the ball
-Z                    :  Move the left paddle
+A - Launch the ball
-B                    :  Move the right paddle
+Z/B - Move the left/right paddle
-DPAD Left, Right, Up :  Bump table
+D-Pad Left/Right/Up - Bump table
--                    :  Start a new game
+Minus - Start a new game
-+                    :  Pause
+Plus - Pause
-=== GameCube Pad ===
+'''GameCube Pad:'''
-A                    :  Launch the ball
-L                    :  Move the left paddle
+A - Launch the ball
-R                    :  Move the right paddle
+L/R - Move the left/right paddle
-DPAD Left, Right, Up :  Bump table
+D-Pad Left/Right/Up - Bump table
-Y                    :  Start a new game
+Y - Start a new game
-Start                :  Pause
+Start - Pause
+==Media==
+'''Running Windows Space Cadet Pinball on the Nintendo Wii ([https://www.youtube.com/watch?v=gzmszDqN4zs Michael MJD])'''<br>
+<youtube>gzmszDqN4zs</youtube>
+== Known source ports ==
+{| class="wikitable sortable"
+! Platform
+! Author
+! URL
+|-
+| PS Vita
+| Axiom
+| [[Space Cadet Pinball Vita]]
+|-
+| Emscripten
+| alula
+| [https://github.com/alula/SpaceCadetPinball GitHub]
+|-
+| Nintendo Switch
+| averne
+| [[Space Cadet Pinball NX Switch|Space Cadet Pinball NX]]
+|-
+| webOS TV
+| mariotaku
+| [https://github.com/webosbrew/SpaceCadetPinball GitHub]
+|-
+| Android (WIP)
+| Iscle
+| [https://github.com/Iscle/SpaceCadetPinball GitHub]
+|-
+| Nintendo Wii
+| MaikelChan
+| [[3D Pinball - Space Cadet Wii]]
+|-
+| Nintendo 3DS
+| MaikelChan
+| [[3D Pinball - Space Cadet for 3DS]]
+|-
+| Nintendo DS
+| Headshotnoby
+| [[3D Pinball - Space Cadet for DS]]
+|-
+| Nintendo Wii U
+| IntriguingTiles
+| [https://github.com/IntriguingTiles/SpaceCadetPinball-WiiU GitHub]
+|-
+| MorphOS
+| BeWorld
+| [https://www.morphos-storage.net/?id=1688897 MorphOS Storage]
+|-
+| AmigaOS 4
+| rjd324
+| [http://aminet.net/package/game/actio/spacecadetpinball-aos4 Aminet]
+|-
+| Android (WIP)
+| fexed
+| [https://github.com/fexed/Pinball-on-Android GitHub]
+|-
+| Web
+| stech11845
+| [https://github.com/stech11845/SpaceCadetPinball-web GitHub]
+|}
 ==Changelog==
+'''v0.3'''
+* Fixed endianness issues that would break Full Tilt compatibility. Now the Space Cadet table from Full Tilt can be played.
+* Make text a bit more fitting for the wii by @korbosoft.
+* Print some errors on screen to better indicate possible failures.
 '''v0.2'''
 * The game now loads the good font that's embedded in pinball.exe.
 * In case that font is not available, the one in PINBALL2.MID is scaled down and has the same color palette as the other font, so it fits better and it's more readable.
 * Also deleted the font that was included in EmbeddedData.cpp.
 '''v0.1'''
 * It can be playable with a Wii Remote or a GameCube pad.
@@ Line 93: / Line 165: @@
 * It lacks menus or score results window.
-==External Links==
+==External links==
-* Github - https://github.com/MaikelChan/SpaceCadetPinball
+* GitHub - https://github.com/MaikelChan/SpaceCadetPinball
-* OSCWii - https://oscwii.org/library/app/SpaceCadetPinball
+* Open Shop Channel - https://oscwii.org/library/app/SpaceCadetPinball