Web page to play GBF animations.
Click Here to access it.
Based and modified from the chinese wiki player.
- Python 3.11.
- Run
pip install -r requirements.txt
in a command prompt. - See requirements.txt for a list of third-party modules.
There are two possible ways to host this project.
- Copy this repo.
- Setup your CORS Proxy of choice to be able to fetch the assets directly from GBF.
- Change line 3 of
index.js
with the address of your proxy. - If needed, change line 98 of
index.js
(testUri
) to redirect toassets/test.png
or something else. This endpoint is used to test if the Proxy is alive and must return a HTTP 200 code. The corresponding asset is present in theassets/folder
if needed.
- Prepare a lot of free space (a few ten of GB).
- Copy this repo.
- Run
python updater.py -download
to download all the assets. (The script will ask you to confirm by typyingyes
). - Change line 2 of
index.js
: Fromconst LOCAL = false;
toconst LOCAL = true;
Note: This method isn't fully tested, you might encounter bugs. You'll also need to run python updater.py -download
after every update but it won't re-download what's already on disk.
You can tinker with the Game
variable around the line 80 of index.js
if you need to change the path of asset types.
If you need to remove the proxy testing mentionned above, look for the function called successLoading
in index.js
and modify it to look this way:
function successLoading(id)
{
startplayer(id);
}
updater.py
is used to update json/data.json
with new elements.
It's currently compatible with characters (R, SR, SSR, Skins), summons, weapons, enemies and classes released up to today.
There are three main possible command lines:
python updater.py -run
to simply retrieve new/unindexed elements.python updater.py -update list_of__id
to manually update the specified elements, in case they got an uncap for example (You don't need to specify the character style for characters).python updater.py -download
will download all the required assets not present on disk (ONLY USE IT IF YOU'RE PLANNING TO SELF-HOST THE ASSETS).
You can then add the following options before for more control:
-nochange
to not update thechangelog.json
recently updated element list.
And the following if you're using GBFAL:
-gbfal
followed by the url or path to GBFALdata.json
file. You can also set it tohttps://raw.githubusercontent.com/MizaGBF/GBFAL/main/json/data.json
.
-
Some skins and characters reuse the Charge Attack or Attack effect of another version.
As there is no way to programmatically find it, at least currently, you'll have to set those exceptions manually inupdater.py
.
First, you'll likely get aNo special set
error for characters without corresponding charge attack.
Second, characters without corresponding attack effect will use a default one.
To fix any of those two issues, find out the ID of the Character that it's supposed to borrow the files from and openupdate.py
and look forPATCHES
around line 80.
Simply add a new line in the list if the ID of the character isn't present such as it looks that way:"ID_CHARA_WITHOUT_OUGI" : ("ID_OUGI_BORROWED_FROM", "ID_ATTACK_BORROWED_FROM"),
.
Example:
"3040232000": ("3040158000_UU", "phit_3040158000"),
.
Summer Alexiel (3040232000) is using Grand Alexiel (3040158000) Charge Attack and Attack files.
_UU
indicates tells it to use the corresponding level of uncap but you can also set a specific level (like01
,02
,03
, etc...).
You can also addFF
to use the current form in the file name.
Just look at the full list inupdater.py
for more examples.
Once the change is done, runupdater.py
again for the concerned characters. -
In a similar way, some summons share assets, such as the Arcarum ones.
The groups must be defined in theSHARED_SUMMONS
variable. -
Classes also requires to be hardcoded (in
class_lookup
andclass_ougi
).
class_lookup
requires the class main ID and a list of its secondary ID along with its proficiencies IDs.
For example,150201
anddkf
are Dark Fencer IDs. It also uses a swordsw
and daggerkn
. So the result is"150201": ["dkf_sw", "dkf_kn"],
.
class_ougi
is mostly for skins. Some skins use weapon assets for their charge attacks. Those weapons are usually not playable.
Using the-gbfal
flag can fill those gaps for you, if you have access to an up-to-date version. -
Weapons with multiple versions (currently, only the Dark Opus are affected) are separate based on their uncaps. Example
1040212500
,1040212500_02
and1040212500_03
.
This is due to the fact the game doesn't support two different weapons loaded at the same time on different entities.
There are other weird exceptions that I probably forgot, I recommend trying to read the code for more infos.
Downloaded assets are saved in the following folders:
- Manifests in model/manifest/
- CJS in cjs/
- Sheets in img/sp/cjs/
The following files are modified/customized:
- view/cjs_npc_demo.js (has been mostly deobfuscated and heavily modified)
- model/cjs-loader.js (added some customization related to file paths)
- model/manifest-loader.js (the loading indicator is updated here)
- lib/sound.js (to play SFX)
- lib/raid/extension.js (mostly empty, it serves as a placeholder)
Along with:
- index.js (the page main script)
- player.js (loaded in second, add the player to the HTML)
- script.js (loaded in third, contains functions to load the assets)
And possibly more that I forgot.
- Make a HTML demo to make the project easily embeddable on any website.
- Reverse engineer GBF's
lib/raid/extension.js
to make the player more faithful to in-game raid animations.