SunRed/SpaceCadetPinball
1
0
Fork 0
mirror of https://github.com/k4zmu2a/SpaceCadetPinball.git synced 2025-11-04 18:20:17 +01:00
Code Issues Releases Activity
Decompilation of 3D Pinball for Windows – Space Cadet
217 commits 2 branches 8 tags 15 MiB
Find a file
Alexis Murzeau 66a868083a
Add translations (#153) 
* Add translations from v1

* Add font configuration (to be able to use non-latin languages)

* translations: remove includes that are already in pch.h

* translations: rename enums and avoid macros

* Fix crash when the font file doesn't exist

* translations: avoid u8 to avoid reencoding by MSVC

MSVC will read the file as ASCII and reconvert characters as UTF-8, this will corrupt characters as the file is in fact already in UTF-8.

* translations: remove NUMBER in enums

* translations: handle non existing translations gracefuly (don't crash)

Fallback to english if available, else return empty string

* Testing pull collaboration.

* Rollback: remove NUMBER in enums.

* Get rid of namespace, use header instead.

* Collapsed translated text struct and array.

* Fixed build errors and warnings.

* Simplified language list.

* All new types, locals and globals should use CamelCase.

* Removed unnecessary ImGui patch.

* Rearranged TTextBox immediate mode draw.

* Final touches: removed unused declaration in gdrv.
Removed unused Msg entries and added new check.

* Remove placeholder english texts from missing translations

Co-authored-by: Muzychenko Andrey <33288308+k4zmu2a@users.noreply.github.com>
2022-08-31 07:58:03 +03:00
CMakeModules Update FindSDL2.cmake (#53) 2021-10-19 08:06:37 +03:00
Doc Added loader for Full Tilt .dat files, v1. 2021-01-31 17:29:53 +03:00
Platform/Linux Update SpaceCadetPinball.metainfo.xml (#116) 2021-12-29 14:26:49 +03:00
Screenshots Add assets (#113) 2021-12-26 13:06:31 +03:00
SpaceCadetPinball Add translations (#153) 2022-08-31 07:58:03 +03:00
.gitattributes Add .gitignore and .gitattributes. 2020-10-04 09:28:35 +03:00
.gitignore Improve linux building (#111) 2021-12-24 09:09:40 +03:00
CMakeLists.txt Add translations (#153) 2022-08-31 07:58:03 +03:00
CMakeSettings.json Added AddressSanitizer to Windows build config, disabled by default. 2021-11-09 16:50:09 +03:00
CONTRIBUTING.md Fix typo in CONTRIBUTING.md (guarantee) (#123) 2022-01-17 09:14:43 +03:00
LICENSE Create LICENSE 2021-01-29 19:47:23 +03:00
mingwcc.cmake MinGW: added rc compiler to toolchain. 2021-10-19 08:13:21 +03:00
README.md Update README.md (#147) 2022-08-09 10:21:01 +03:00

README.md

SpaceCadetPinball

Summary

Reverse engineering of 3D Pinball for Windows - Space Cadet, a game bundled with Windows.

How to play

Place compiled executable into a folder containing original game resources (not included).
Supports data files from Windows and Full Tilt versions of the game.

Known source ports

Platform Author URL
PS Vita Axiom https://github.com/suicvne/SpaceCadetPinball_Vita
Emscripten alula https://github.com/alula/SpaceCadetPinball
Play online: https://alula.github.io/SpaceCadetPinball
Nintendo Switch averne https://github.com/averne/SpaceCadetPinball-NX
webOS TV mariotaku https://github.com/webosbrew/SpaceCadetPinball
Android (WIP) Iscle https://github.com/Iscle/SpaceCadetPinball
Nintendo Wii MaikelChan https://github.com/MaikelChan/SpaceCadetPinball
Nintendo 3DS MaikelChan https://github.com/MaikelChan/SpaceCadetPinball/tree/3ds
Nintendo Wii U IntriguingTiles https://github.com/IntriguingTiles/SpaceCadetPinball-WiiU
MorphOS BeWorld https://www.morphos-storage.net/?id=1688897
AmigaOS 4 rjd324 http://aminet.net/package/game/actio/spacecadetpinball-aos4
Android (WIP) fexed https://github.com/fexed/Pinball-on-Android
Web stech11845 https://github.com/stech11845/SpaceCadetPinball-web

Platforms covered by this project: desktop Windows, Linux and macOS.







Source

  • pinball.exe from Windows XP (SHA-1 2A5B525E0F631BB6107639E2A69DF15986FB0D05) and its public PDB
  • CADET.EXE 32bit version from Full Tilt! Pinball (SHA-1 3F7B5699074B83FD713657CD94671F2156DBEDC4)

Tools used

Ghidra, Ida, Visual Studio

What was done

  • All structures were populated, globals and locals named.
  • All subs were decompiled, C pseudo code was converted to compilable C++. Loose (namespace?) subs were assigned to classes.

Compiling

Project uses C++11 and depends on SDL2 libs.

On Windows

Download and unpack devel packages for SDL2 and SDL2_mixer.
Set paths to them in CMakeLists.txt, see suggested placement in /Libs.
Compile with Visual Studio; tested with 2019.

On Linux

Install devel packages for SDL2 and SDL2_mixer.
Compile with CMake; tested with GCC 10, Clang 11.
To cross-compile for Windows, install a 64-bit version of mingw and its SDL2 and SDL2_mixer distributions, then use the mingwcc.cmake toolchain.

Packaging status

Some distributions provide a package in their repository. You can use those for easier dependency management and updates.

This project is available as Flatpak on Flathub.

On macOS

  • Homebrew: Install the SDL2, SDL2_mixer homebrew packages.
  • MacPorts: Install the libSDL2, libSDL2_mixer macports packages.

Compile with CMake. Ensure that CMAKE_OSX_ARCHITECTURES variable is set for either x86_64 Apple Intel or arm64 for Apple Silicon.

Tested with: macOS Big Sur (Intel) with Xcode 13 & macOS Montery Beta (Apple Silicon) with Xcode 13.

Plans

  • Decompile original game
  • Resizable window, scaled graphics
  • Loader for high-res sprites from CADET.DAT
  • Cross-platform port using SDL2, SDL2_mixer, ImGui
  • Misc features of Full Tilt: 3 music tracks, multiball, centered textboxes, etc.
  • Maybe: Text translations
  • Maybe: Android port
  • Maybe x2: support for other two tables
    • Table specific BL (control interactions and missions) is hardcoded, othere parts might be also patched

On 64-bit bug that killed the game

I did not find it, decompiled game worked in x64 mode on the first try.
It was either lost in decompilation or introduced in x64 port/not present in x86 build.
Based on public description of the bug (no ball collision), I guess that the bug was in TEdgeManager::TestGridBox