Classic64

A plugin for ClassiCube which uses libsm64 to insert a playable Mario from Super Mario 64 into the game.

This project was not created by, or is related with the developers of the Minecraft mod "Retro64".
ClassiCube is a custom Minecraft Classic client written in C.

Compiling the plugin

Windows

• Download the MSYS2 development environment, launch MSYS2 MinGW x64 and install the dependencies: pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-make mingw-w64-x86_64-tools mingw-w64-x86_64-SDL2.
  • To compile for 32-bit, open MSYS MinGW x86 instead, and replace x86_64 with i686 in the command
• Follow these instructions to compile libClassiCube.a (needed to compile the plugin)
• Run make.

A folder named "dist" will be created and inside will sit the plugin dll file "Classic64.dll". Copy this to your ClassiCube plugins folder.

Linux

Install gcc, g++ and make using your package manager:

# For Ubuntu and derivatives like Linux Mint and Pop!_OS:
sudo apt install gcc g++ make

# For Arch Linux and derivatives like Manjaro:
sudo pacman -S gcc make

By default, the makefile will compile with SDL2 for providing sound, so you must install the dependency as well:

# For Ubuntu and derivatives like Linux Mint and Pop!_OS:
sudo apt install libsdl2-dev

# For Arch Linux and derivatives like Manjaro:
sudo pacman -S sdl2

Running the plugin

You are required to supply a dumped copy of your Super Mario 64 US ROM, placed inside the plugins folder, with the filename "sm64.us.z64". Otherwise the plugin will refuse to work.

This plugin works on Windows and Linux, 32-bit and 64-bit. macOS has not been tested.

How to play

To turn into Mario, run the command /model mario64. This will let everyone on the server using this plugin know that you're playing as Mario, and will display the model on their end.

If you are on a server with hacks enabled (flying, speed, etc) but the "/model" command is not allowed, you can run the client-side command /client mario64 force. If the server is running the Classic64 MCGalaxy plugin, everyone will see the client-side change as well.

Running client-side commands with MessageBlocks or Bots

If you're making a map intended for Mario, you can alter certain aspects of the plugin through your map by using MessageBlocks, or Bots! (Only on MCGalaxy servers)

The format is &0!mario64, followed by one of the client-side commands listed below.

Examples:
If you want to play music ID 27 (Correct Solution) when breaking a white wool block: /mb white &0!mario64 music 27
If you want to instantly kill Mario when a bot kills the player: /bot deathmessage <bot-name> &0!mario64 kill

Client-side commands

All client-side commands start with /client mario64

• /client mario64 music <ID 0-33>
  Plays music from Super Mario 64.
  To stop music, use music ID 0.

• /client mario64 cap <option>
  Change Mario's cap.
  You can choose one of these options: off, on, wing, metal

• /client mario64 kill
  Kills Mario instantly.

• /client mario64 force
  Force-switch between Mario and the default model.
  Useful if the /model command is disallowed but hacks are enabled.

• /client mario64 settings <option> [value]
  Change plugin settings.
  To show all settings, use /client mario64 settings
  To show information about a setting (what it does, current value, etc), leave out the value argument: /client mario64 settings <option>
  Settings are saved to a file named "Classic64.cfg" in your ClassiCube folder.