Eikonomiya

pun between "eiko" and "enkanomiya" which is also the name used by enka.network fetching genshin in-game data.

This is a piece of software aiming at:

Regularly fetching equipment of in-game characters characters using Enka.Network and saving them into a local database.
Providing this parsed data locally and continuously with API.
Providing a web interface to work with instead of only my wonky spreadsheets.
Computing additional data easily notably regarding the quality of the artifacts.
Process damage computations automatically and team compositions.

Dependencies

Docker (deployable)

npm (running locally)

Installation

Using Docker

Grab the Docker image on DockerHub or build it yourself by running

docker build -t eikonomiya .

then run it using

docker run -p 3000:3000 -v <full path to data folder>:/app/data eikonomiya

Then go to localhost:3000 to start using Eikonomiya.

Note: Since Docker relies on WSL on Windows, large I/O operations such as the pulling of GO assets with Git may take a while (it takes about 10 minutes on my PC but only a few seconds on my NAS).

Using npm (prod build)

Create a folder named data at the root of the repo, then run

npm run build

to build the application. You can then start it using

npm run start

Using npm (dev build)

Create a folder named data at the root of the repo, then run

npm run dev

to start the application.

API

(to be documented, maybe use swagger ?)

Differences with other Genshin tools

Tool	Pros	Cons
Genshin Optimizer	Powerful tool, elegant and user-friendly interface, allows simulation, details everything	Extremely heavy to use (everything has to be referenced before doing calculations), no automatic synchronization with in-game data.
Aspirine	Powerful tool, allows simulations and can process rotations relatively easily, can sync using Enka.Network	User interface is not that friendly at all, optimizer makes strange choices, not that much details on calculations.
Enka.Network	THE only API that can grab in-game data. Very useful and documented, can draw pretty summary character cards.	No computation or simulation, not the purpose of the tool. Does not (freely at least) save character outside in-game showcase.
Akasha	Huge database storing in-game builds from players not limited to their current showcase, extends Enka functionalities, can rate character builds and check meta	Heavily focused on meta, does not "work" with more niche builds or non-meta teams. Does not feature simulation like previous tools.

While Eikonomiya aims to do a bit of this and that from other tools, the main purpose of the tool is to replace the complex Excel spreadsheets I made since I started played Genshin. Aside from showing which part of each character needs work/farm, it aims to give a simple way to simulate character stats, team compositions and buff stacking.

Schale.gg is a Blue Archive tool that kind of does that, without the complexity of Genshin Optimizer and a more user-friendly and prettier interface than Aspirine. However, it does not sync data with the game. Eikonomiya is heavily inspired by the functionalities offered by Genshin Optimizer and Schale.gg.

Misc

Additional data

Other in-game values not given by Enka.network or Genshin Optimizer are located in the eikonomiya-data repo.

eikofee/eikonomiya