odwdinc / ssbu_amiibo Goto Github PK

Just a start for the Amiibo editor

Python 100.00%

ssbu_amiibo's Introduction

SSBU_Amiibo

Just a start for the Amiibo editor

You will need to provide your own Amiibo Keys in key_retail.bin for Encription and Decription to work Find copy of "KEY RETAIL MUST HAVE TO FLASH AMIIBO.zip" or other copy of "key_retail.bin"

Each Amiibo has to be "upgraded" from the SSB format to SSBU, you should see this message in game the first time you scan a fresh Amiibo in SSBU. After the upgraded the tag is marked and the data block is reformatted to the new SSBU preserving some of the SSB data just reformatted, scaled, etc. If the Amiibo has SSBU data in the data block before the upgraded this data will be interpreted as SSB data not SSBU data.

Download Amiibo Editor

Download the latest Release

Amiibo Editor Setup

Extract the Release.
Place your key_retail.bin into the folder under \src\dist\windows\ui\
Launch the ui.exe

Get your Amiibo Bin Files

If starting with a legit Amiibo skip to 4
Take unmodifide.bin (something.bin, these names are place holders for actual character names) file write to blank Amiibo tag or to N2 Elite.
Load unmodifide Amiibo in SSBU in game (Note, this will perfrom an update to the Amiibo.)
Put-Away Amiibo in SSBU in game (Note, this will save the updates to the Amiibo.)
Once the Amiibo as been updated in-game use eather Tagmo or N2 Elite to get a new bin file (somthing_new.bin)

Edit your Amiibo

Now with completing the above steps of Download Amiibo Editor, Amiibo Editor Setup, and Get your Amiibo Bin Files. You can begin using the editor software and editing your Amiibos.
Open the Amiibo editor(ui.exe) and go to File->Decrypt Amiibo, and select the new bin file (somthing_new.bin). - If you do not see Decrypt Amiibo in the File dropdown, you either have no placed the key_retail.bin in the correct folder, or you may need to restart the ui.exe file.
Make any changes to the Amiibo then SAVE (Note. you can confirm the changes by reopening the save file.) - It is also important to note that you can only have a total 3 slots per amiibo, if using more than 3 slots the save will leave off some of the attributes you selected.
Once happy with changes go to File->Encrypt Amiibo and save to a new bin file (somthing_mod.bin)
With a blank Amiibo tag write the new bin file (somthing_mod.bin) to a tag. - Alternatively, you can restore this information to an existing amiibo if you are using TagMo, it is imporant to note that if you do not have a backup of your original unmodifide.bin file you may not be able to use your amiibo online.

How To Example:

So, you want to create a Super Smash Bros. Ultimate Amiibo. You will need at least 2 tags (Tagmo) or something like the N2 Elite. One will need to be have a stock no mods Amiibo.

If starting with a legitimate Amiibo skip to step 3
Take unmodified .bin (somthing.bin) file, and write it to a blank Amiibo tag or to the N2 Elite.
Load unmodified Amiibo in SSBU in game (Note, this will perform an update to the Amiibo.)
Choose "Put Away" in SSBU (Note, this will save the updates to the Amiibo.)
Once the Amiibo as been updated in-game, use either TagMo or N2 Elite to get a new .bin file (something_new.bin)
Open the Amiibo editor, go to File->Decrypt, and select the new .bin file (something_new.bin).
Make any changes to the Amiibo, then SAVE (Note: you can confirm the changes by reopening the save file.)
Once you're happy with the changes, go to File->Encript and save to a new bin file (something_mod.bin)
With a blank Amiibo tag write the new bin file (somthing_mod.bin) to a tag.

Editor's note: if using TagMo, you can simply use "restore tag" to update the .bin, thereby only using one tag. You may need to check "allow restore to different tag"

Note on Tagmo - Unknown, as I do not use it.

TagMo will not recognize it unless you go into the settings and turn off amiibo file browser, and even still, there's an error in loading the amiibo onto the nfc sticker. it should still work.

ssbu_amiibo's People

Contributors

Stargazers

Watchers

Forkers

angryahab pdxjohnny gatekeeper1122 bencat07 nn9dev bareinhard tlamvip remibruh rlziii mkultraa fengpiaohongjishuzhongxin lonk12

ssbu_amiibo's Issues

Change Amiibo Personality?

You know how there are Personalities like "Calm", "Aggressive", "Show-off", etc, right? is there any chance you'll add them as a changeable option? I am not 100% sure in which datablock this is saved, but my best guess is Either Unk0 or Unk5, as both of those changed when i changed my bowsers personality. If i find more info to help you will note it here too.

EDIT: i changed Unk0 and personality type did not change, so that's out of the window

EDIT: Unk0 seems to be responsible for the Spirit type, 0x40 as the first byte made it Attack while 0x20 made it Neutral

EDIT: Unk5 is not responsible for the personality type... i will be doing further debugging by leveling my bowser up with a spirit

EDIT: oops, it was in the "Full Data" block all along

EDIT: It seems the personalities come with a point/weight system e.g. if you make your amiibo Aggressive 3 times in a row it will be harder to get something else

EDIT: personality lies somewhere between 0x10 and 0x14 on the "Full Data" block (0x178-0x17B in .bind)

EDIT: it is the first byte of my guess... i think. i am not sure, because it may be a float or something? i don't quite understand this yet

EDIT: it's 100% more than one singular byte, but i neither know how many, nor how it exactly works. MAYBE, just MAYBE it uses like a score for each category? (if so, then it may be 5 bytes, not 4)

Changes Not made

this keeps happinging and i used the exe, no stat changes are made an i have 4 marios now not even hacked. help

Key_retail.bin

just a little confuzed on how to get the key.retail.bin file to get the program to work

How to Decrypt Amiibo Bin file?

Could you please help me with this part?

Amiibo not loading nor decrypting...

As the title says, it can't open amiibo files. All bin and bind files appear as 1kb and when opened nothing changes on the gui...

Readme Instructions

The entire read me file is messed up, it makes no sense, plus i cant find anything it says to do after the installation of git and python. all it shows me is just "Setup" and thats it, nothing else added

Some amiibos unreadable

When decrypting the Donkey Kong, Pikachu, Diddy Kong, or Ryu amiibo, it refuses to load. While it successfully decrypts the amiibo, loading the newly decrypted file still doesn't work. The console shows this whenever I attempted to decrypt and load the Donkey Kong amiibo bin file.

TagMo doesn't recognise the moded .bin file

I decrypted an amiibo bin file and modded it, then saved and encrypted it back, but when I put the encrypted .bin file into the tagmo folder, it's not recognized as an amiibo bin file while the original does

Could you make a video tutorial on this?

I'm too stupid to figure out how to do this. I tried getting help from my friend but that didn't help so yeah can you please make a video tutorial?

Regarding online use

In the readme, it says 'it is imporant to note that if you do not have a backup of your original unmodifide.bin file you may not be able to use your amiibo online'.
If I tried to make a friends-only battle arena and I used my modified amiibo, what could go wrong? Because I thought that SSBU couldn't tell the difference between an original amiibo and an edited one.

Decrypting Amiibo Doesn't Work

Whenever I try to decrypt a .bin file this error shows up. Any help?

Getting Started Documentation

Could there be an update to the documentation for a better "getting started" guide?

For instance (Python 3.7 64 bit windows assumed):

Getting Started

git clone https://github.com/odwdinc/SSBU_Amiibo.git
cd SSBU_Amiibo
py -3.6-64 -m venv venv
./venv/Scripts/Activate
py -m pip install --upgrade pip
py -m pip install cryptography pyamiibo
Run py ui.py

The below was what I needed to do to get this up and running, which was easy enough to do, but considering that you'll probably get a lot of kids trying to use the code, it's probably best to have as clear of documentation as you can provide.

Nice utility though!

On android?

Would it be possible to make this into an android apk? That would be better, as I don't really want to get a nfc reader just in case it doesn't work.

Errors when Decrypting

Encountering the following output when attempting to Decrypt:

212
Exception in Tkinter callback
Traceback (most recent call last):
File "tkinter_init_.py", line 1705, in call
File "ssbu_amiibo\ui.py", line 293, in Decrypt
File "ssbu_amiibo\ui.py", line 170, in handaleFile
File "ssbu_amiibo\amiibo_class.py", line 47, in init
File "ssbu_amiibo\amiibo_class.py", line 118, in GetWebData
File "json_init_.py", line 348, in loads
File "json\decoder.py", line 337, in decode
File "json\decoder.py", line 353, in raw_decode
json.decoder.JSONDecodeError: Expecting property name enclosed in double quotes: line 2 column 1 (char 2)

Have already performed fresh installs, reran all commands, attempted to use the old version with modifications etc.
It appears that Decrypting does work, as I can then open this file within the old version which pulls correct data showing Exp, Attack, Defense and Gift.

Only issue is I can't get the old version to detect my *.bin key files, so no Decrypt/Encrypt options available.
It appears that the original post on GBATemp also has someone experiencing this issue as well; however, I am not super familiar with what I may be able to do to resolve it at this point.

Any help/assistance would be lovely.

cant encrypt

i made one amiibo just fine but now im trying to make a second but whenever i try to encrypt it and save it the file doesn't show up. even when i search it doesn't show up.
it saves the new version as a .bind file but when i go to encrypt it doesnt show up
it doent seem to be updating the file when i hit save either

Can't open PowerSaves load

I have the PowerSaves thing, and I try to open the version of my amiibo that I saved with the PowerSaves, and it doesn't open in the editor.

No "Decrypt Amiibo" option?

When I go into File there is no "Decrypt Amiibo" option

Fail to Decode from AmiiboAPI

Some of AmiiboAPI's JSON responses contain newline characters. Since sbuu.GetWebData(self) attempts to decode the JSON via HTTPResponse.readline() the decode will fail in cases where the JSON response contains these newline characters with the following error:

json.decoder.JSONDecodeError: Expecting property name enclosed in double quotes: line 2 column 1 (char 2)

Instead, GetWebData() should use HTTPResponse.read() to ensure it reads the entire JSON response even if newlines are present.

Add distributable releases

Any chance of you setting up distributable releases through TravisCI or something similar?

I could help out if needed.