1
0
Fork 0
A C library for everyone's favorite game: Super Mario Sunshine. Forked from https://github.com/BitPatty/Super-Mario-Sunshine-C-Kit
This repository has been archived on 2024-02-06. You can view files and clone it, but cannot push or open issues or pull requests.
Find a file
masterf0x d753dc4703 Merge pull request #2 from QbeRoot/pal-port
Fixed broken US functions and added PAL support
2017-09-23 12:13:55 -05:00
examples Updated library and linker with more functions 2016-09-25 11:50:37 -07:00
ports/pal Fixed broken US functions and added PAL support 2017-09-22 15:11:32 +02:00
bin2gecko.exe Updated library and linker with more functions 2016-09-25 11:50:37 -07:00
bin2gekko.exe Add files via upload 2016-07-07 18:55:28 -05:00
build.bat Updated library and linker with more functions 2016-09-25 11:50:37 -07:00
cmd.bat Updated library and linker with more functions 2016-09-25 11:50:37 -07:00
DOLInsert.exe Updated library and linker with more functions 2016-09-25 11:50:37 -07:00
dollinker Updated library and linker with more functions 2016-09-25 11:50:37 -07:00
linker Add files via upload 2016-07-07 18:55:28 -05:00
marioUS.MAP Add files via upload 2016-07-07 18:55:28 -05:00
patchdol.bat Updated library and linker with more functions 2016-09-25 11:50:37 -07:00
README.md Fixed broken US functions and added PAL support 2017-09-22 15:11:32 +02:00
sms.c Updated library and linker with more functions 2016-09-25 11:50:37 -07:00
sms.h Updated library and linker with more functions 2016-09-25 11:50:37 -07:00
sms.map Add files via upload 2016-07-07 18:55:28 -05:00
sms.s Add files via upload 2016-07-07 18:55:28 -05:00
sms2.c Updated library and linker with more functions 2016-09-25 11:50:37 -07:00
smsFuncs Fixed broken US functions and added PAL support 2017-09-22 15:11:32 +02:00

Super Mario Sunshine - C Kit

A WIP C library for everyone's favorite game: Super Mario Sunshine. The tools in this will allow you to compile C code which can be patched into Super Mario Sunshine.

#What can this do?

The library allows you to compile PPC code that replace functions and interact with objects in Super Mario Sunshine. The code can be either put into a gecko code with a max size of 229 lines or be patched into Super Mario Sunshine's Start.dol.

This is only for Super Mario Sunshine at the moment. (I'll probably make another kit for some other games in the future, though only me working on them; I don't want to involve Miluaces into the pain. ^ ^' )

#Neato!... Well, how do I set this up?

  1. Clone or download the c kit.
  2. Install devkitPro for PPC somewhere on your harddrive. The batch files are set up for it to be located at C:\devkitPro\devkitPPC, but you can edit the batch files to account for your install location.
  3. If you want to patch Start.dol, extract it from your Super Mario Sunshine image and copy it into the c kit directory.
  4. To compile C code, drag the source file onto build.bat for a gecko code or patchdol.bat to patch Start.dol.
  5. The gecko code should be copied into your clipboard or a new .dol file with your source files name will be created.

#Alright. Do you have any examples to show?

Yes, actually. Here's an item spawning example from Miluaces:

include "sms.h"

int laststate; //Last state

int OnUpdate(MarDirector* director) {	
	int (*GameUpdate)(MarDirector* director) = GetObjectFunction(director, Director_GameUpdate);
	
	MarioActor* mario = GetMarioHitActor();
	ItemActor* item = 0;
	
	if (!laststate){
		if (ControllerOne->buttons & PRESS_DU)	//Dpad up spawns a coin
			item = MakeObjAppear(*gpItemManager, OBJ_COIN);
		else if (ControllerOne->buttons & PRESS_DL) //Dpad left spawns a 1-up
			item = MakeObjAppear(*gpItemManager, OBJ_ONEUP);
		else if (ControllerOne->buttons & PRESS_DR) //Dpad right spawns a rocket nozzle
			item = MakeObjAppear(*gpItemManager, OBJ_ROCKETNOZZLE);
		else if (ControllerOne->buttons & PRESS_DD) //Dpad down spawns a turbo nozzle
			item = MakeObjAppear(*gpItemManager, OBJ_TURBONOZZLE);
	}
	
	// If no dpad buttons are pressed, reset laststate
	if (!(ControllerOne->buttons & (PRESS_DU | PRESS_DL | PRESS_DR | PRESS_DD)))
		laststate = 0;
	
	//If item was assigned, set it up
	if (item != 0){
		//Set laststate to 1 to prevent more than one item spawning from one button press
		laststate = 1;
		
		//Set item position
		item->position.x = mario->position.x;
		item->position.y = mario->position.y + 200.0f;
		item->position.z = mario->position.z;
		
		//Set item velocity
		item->velocity.y = 20.0f;
		
		//Make item moveable
		item->flags = item->flags & ~ITEMFLAG_STATIC;
	}
	
	return GameUpdate(director);
}

There are more examples in the repository.

#My code compiled! What do I do now?

Either build a new SMS image with your dol file or enter your gecko code to see your code run in game.


More examples and updates to the lib will surely come at the right moment. For support with this check out the Blastsoft Studios Discord ( https://discord.gg/mN9nf ). Also visit SMS Realm ( http://smsrealm.net/board/ ) to discuss SMS hacking with other users.