Page 1 of 5

The SMBX "SMB3" Overhaul API Mod v1.0.2

Posted: Sun Jul 26, 2015 3:42 pm
by XerX
Hello SMBX community! I present to you, something that I bet a lot of you have been wanting for a long time; More SMB3.

"What do you mean?" You ask. Well I'll tell you!



What is the "SMB3 Overhaul API Mod"?

The "SMB3 Overhaul API Mod" is a HUD Mod for SMBX, replacing the old SMW-esque HUD for a more traditional SMB3 Hud. This is all possible thanks to LunaLua.
Spoiler: show
Image
Here is our new HUD. You like it? I sure do. Everything on the HUD is functional. Yes, even the PBar functions, and makes the sound when you hit top speed and are ready to fly. This API combines the "leveltimer" api and the "smb3goalcard" api, while also adding new features. To avoid any issues, it is advised that you do not use the two api with this one. Another thing to note is that the ItemReserve is not usable with this mod. It has been deactivated, for obvious reasons. (Also adds to that SMB3 charm.)

ONE MORE THING TO MENTION IS: If your level has a floor on the last two block spaces of your level, you must pull down the level boundaries by 2 blocks, otherwise the HUD will overlap anything on that layer. I can't do anything about that due to how SMBX's camera is programmed.

LIKE THIS
Spoiler: show
Image
OR ELSE YOU'LL GET THIS
Spoiler: show
Image
I'll guide you through what each of the HUD elements are.
Image
1. The Level Name : This uses SMBX's most useless feature, and makes it more useful. The Level Name feature under Level Settings > Advanced now has a use, and is displayed here. Max 11 characters. Any more than that and it defaults to "LEVEL".
2. Lives/Star Counter
3. Score
4. PBar : This functions pretty close to how the PBar in SMB3 did. You build up speed, the bar fills up. When it's full, you can fly. (The PBar only works for Player 1.)
5. Coin Counter
6. Timer : (Uses Luigifan2010's timer API, Slightly edited.)
7. Goal Cards : (Uses my SMB3 Goal Card API. Slightly edited).

So how do I get started?

First off, make sure you have the latest LunaLua. The oldest release supported is 0.7.0.3 BETA. You can get the latest here : http://engine.wohlnet.ru/LunaLua/

Then download the API.
When it's downloaded, extract the files somewhere and do the following :
1 . Copy/Paste the smb3overhaul.lua file and smb3overhaul folder into your LuaScriptsLib folder which should be in the root of your SMBX folder. (../SMBX/LuaScriptsLib/).
2 . Make a new file in your project folder called LunaWorld.lua.
3 . Add _smb3overhaul = loadAPI("smb3overhaul"); to the file.
4 . In your onLoad function, you can toggle certain settings on/off.

Code: Select all

	_smb3overhaul.setSecondsLeft(TIME);
	_smb3overhaul.setTimerState(true/false);
	_smb3overhaul.usesPBar(true/false);
	_smb3overhaul.useEasyMode(true/false);
	_smb3overhaul.usesCard(true/false);
	_smb3overhaul.disableSpinJump(true/false);

MINIMALISTIC VERSION

Image

Today I'm releasing a minimalistic version of the Overhaul mod, for those who don't want to sacrifice the design of their levels by extending the bottom bounds by two blocks.
Based off the SMAS4 SMB3 HUD Style.

Image

Info :
Spoiler: show
SETUP

1 . Copy/Paste the smb3overhaulMIN.lua file and smb3overhaulMIN folder into your LuaScriptsLib folder which should be in the root of your SMBX folder. (../SMBX/LuaScriptsLib/)

IMPLEMENTING INTO YOUR SMBX EPISODE/LEVEL

1 . Make a new file in your project folder called LunaWorld.lua.
2 . Add _smb3overhaul = loadAPI("smb3overhaulMIN"); to the file.
3 . In your onLoad function, you can toggle certain settings on/off.

Code: Select all

_smb3overhaul.setSecondsLeft(TIME);
_smb3overhaul.setTimerState(true/false);
_smb3overhaul.usesPBar(true/false);
_smb3overhaul.useEasyMode(true/false);
_smb3overhaul.usesCard(true/false);
_smb3overhaul.disableSpinJump(true/false);

Download : Download Minimalistic Version 1.0

If this seems too confusing, follow step 1 then after, you can just use the example LunaWorld.lua file provided in the ZIP, which is in the README folder.

Credit to Mike Santiago for the timer api.
Special thanks to Mike Santiago and Kevsoft for the help and support.


If you have any questions/bug reports, please post them here.

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Sun Jul 26, 2015 3:44 pm
by TheKingOfBoos
Woah :O This is intensely awesome!

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Sun Jul 26, 2015 3:44 pm
by Axiom
this
is
glorious

one thing to note: it is completely safe to have both the individual mods (smb3goalcard and leveltimer) installed, just do not run all 3 together. you have to either pick: smb3goalcard + leveltimer, or smb3overhaul mod. (or smb3goalcard individually or leveltimer individually)

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Sun Jul 26, 2015 5:52 pm
by XerX
There was an update to the API. Please redownload the newest version. (Same link).

Changes
-Added "easymode". Replicates SMB3 Powerup structure. Fire/Leaf/Ect > Big > Small instead of Fire/Leaf/Ect > Small.

If you wish to toggle this off, open your LunaWorld.lua and add this line in the onLoad().

Code: Select all

_smb3overhaul.useEasyMode(true);

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Sun Jul 26, 2015 6:04 pm
by meowflash
#2classic4me

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 3:04 am
by Artemis008
This refuses to work for me,I followed all your steps exactly the way I was supposed to and it still doesn't work.

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 3:08 am
by XerX
Artemis008 wrote:This refuses to work for me,I followed all your steps exactly the way I was supposed to and it still doesn't work.
You are certain that these files/folders are in "LuaScriptsLib"?

"smb3overhaul.lua"
"smb3overhaul folder"

If so, then what about your LunaWorld.lua? What do you have saved in that file, which should be in your project folder. It should look something like this.

Code: Select all

_smb3overhaul = loadAPI("smb3overhaul");

function onLoad()
	_smb3overhaul.setSecondsLeft(500);
	_smb3overhaul.setTimerState(true);
	_smb3overhaul.usesCard(true);
	_smb3overhaul.usesPBar(true);
	_smb3overhaul.useEasyMode(true);
end

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 3:42 am
by Artemis008
I checked everything,it just doesn't work.

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 3:46 am
by XerX
Are you using LunaLua 0.7.0.3 BETA? Make sure your folder looks similar to this :Image

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 7:38 am
by Axiom
I think it has to be "lunaworld.lua" instead of "LunaWorld.lua". Also, if you're referencing this inside of a lunadll.lua file, make sure the lunadll.lua file is inside of the level's custom graphics folder, even if it doesn't have any custom graphics.

You can verify your LunaLua version by launching SMBX in game mode and checking the top left corner. If your version isn't 0.7.0.3 Beta or greater, you'll need to redownload LunaLua

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 12:39 pm
by Artemis008
Maybe this could help.
Image
Image
Image
Image

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 1:05 pm
by XerX
Artemis008 wrote:Maybe this could help.
Spoiler: show
Image
Image
Image
Image
I found your problem. The api's folder is named incorrectly. It has to have the exact same name. (smb3overhaul).

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 1:50 pm
by Artemis008
I just fixed that and it still won't work.

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 2:00 pm
by XerX
Question. Is that the folder that contained the smb3overhaul.lua file? What's inside that SMB3 Overhaul folder?

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 2:06 pm
by Artemis008
This is whats inside the smb3 overhaul folder.

Image

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 2:59 pm
by XerX
Artemis008 wrote:This is whats inside the smb3 overhaul folder.

Image
You need to move the 'smb3overhaul' folder inside THAT folder into your LuaScriptsLib folder. It contains the needed graphics and sounds.

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 5:45 pm
by Axiom
Artemis008 wrote:This is whats inside the smb3 overhaul folder.

Image
Put the contents inside your LuaScriptsLib folder. Namely the smb3overhaul folder and smb3overhaul.lua

Also, did you check your LunaLua version?

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 6:44 pm
by MECHDRAGON777
You made the score 1 two many zeros!
09999990 is the max score according to this!

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 6:50 pm
by Emral
MECHDRAGON777 wrote:You made the score 1 two many zeros!
09999990 is the max score according to this!
It's the SMB3 scoreboard, so I'm guessing he increased the max score. Not like you'll ever reach it, though.

Re: The SMBX "SMB3" Overhaul API Mod

Posted: Mon Jul 27, 2015 8:26 pm
by MECHDRAGON777
Enjl wrote:
MECHDRAGON777 wrote:You made the score 1 two many zeros!
09999990 is the max score according to this!
It's the SMB3 scoreboard, so I'm guessing he increased the max score. Not like you'll ever reach it, though.
I reached it. It does not go to the last digit, I will upload a screenshot as proof.
Image