Live at https://forwardfeed.github.io/ER-nextdex/static/
A web application about the Elite Redux pokemon game, acts as a documentation. ER is made thanks to pret-pokeemerald hence all other games based on this work may reuse a significan part of this project.
requires git, npm and nodejs, and protoc This will initialize the project
git submodule update --init
npm install
npm run protoc
npm run build
# this should spawn an error and it's normal
# nextdex_config.json should appear and you need to edit the field project_root
npm run run
# this will pull the latest into Alphatest
npm run run -- -sv 2 -rd -o Alphatest
There is two part in this project:
from the source files of the game.
It requires TSC or any typescript compiler (transpiler) but more critically a nodeJS environnement. No dependecies are used in this games.
Commands:
- build: just a shortcut to tsc
- run: will execute the program, see below for specification, if nothing is specified it will output in out/gameData.json with the path specified in nextdex_config.json using structure version 0
Run Arguments: - -o --output : name of the output to gamedata{arg}.json - -ip --input-path: override the path of the root folder in nextdex_config.json - -sv --structure-version: indicate which version of the parsing alg to use, since the codebase evolves with the version, it may be necessary, it always be an integer so in the code you can do: if(version > 3 && version < 5) { read this way } else {read this way} - -so --sprites-only: Do not parse for gamedata.json and only outputs all the sprites of pokemon found in out/sprites, i advice to use the python script sprites_utils.py after used that. - -rd -redirect-data: Do not redirect gameData.json to /out/ but directly to the UI folder at /static/js/data/
Quick tip, if you use git on your pokemon project you can get back to a previous version with these bash commands
git log --all --grep='V0.0.1' where V0.0.1 is the message of a commit marking the version of the game. Copy the commit sha1 hash and then you can do
git checkout 'the sha1 you got'. Then now you can fetch the data with this software to then git switch - to get back to where you where originally.
By default the data is outputed to out/, you can change that with the variable OUTPUT in src/main.ts
It requires an HTTP server since it uses JS modules. If you code with VSC for example you may use live-server add-on.
Aside this it is just a static html web app
to offer comparison between two game version, you must use the -c or --comparify argument. I have made myself an horrible bash shortcut for it:
find ./static/js/data/ -name "gameDataV*.json" -print0 | xargs -0 sh -c 'npm run run -- -rd -c "\"[$@]\"" -ca out/gameDataVVanilla.json out/' _It does not work by the way because bashhell, but if you copy paste the command being run by npm in terminal logs it works. The reason is probably demonic or something, I don't know I'm not a techno priest.
For vanilla, you need the --ca or --comparify-additionnal AND a compactified vanilla data. But the file or the code that allowed me to do it is currently a lost media, so I built src/restore_vanilla.ts as a cope.
It is created upon launching the data fetcher Fields: - "project_root": absolute path of your game files, YOU MUST ADAPT THIS FIELD - "verified": automatic, will set itself to true if you fed a right project_root.
holds the gamefile parsing and compactify into a data called gameData.js, outputed to out/ Althougt it shouldn't, most of the parameters are inside the code and not as environnement variable or configuration files You run it with npm or tsc
Build of the src/ application
Output dir by default of some files.
a simple vanilla js + jquery + css + HTML Web application, this is what is live and should be interacted with as a end user.
The script I have in python in postbuild don't really work, I actually use the one I made https://github.com/ForwardFeed/taillow there.
There's an experimental devDex and docker the dev dex is a program that will use a webhook from a github repository to get informations on new pushes on push, the nextdext reparse the file and output a new gameData. on a server that will be hosted only (would be great if it was password locked)
Handle the github token, in order to have the program to work with private repository a github token is needed. the token is passed with the whole file configuration using docker secret files --secret id=FILENAME,src=LOCAL_FILENAME
