This is a desktop application that allows travelers to manage their custom equipment of artifacts and weapons for playable characters and makes it convenient for travelers to calculate the associated statistics based on their equipment using the semantic understanding of how the gameplay works. Travelers can create their bespoke loadouts consisting of characters, artifacts and weapons and share them with their fellow travelers. Supported file formats include a human-readable Yet Another Markup Language (YAML) serialization format and a JSON-based Genshin Open Object Definition (GOOD) serialization format.
This project is currently in its beta phase and we are committed to delivering a quality experience with every release we make. If you are excited about the direction of this project and want to contribute to the efforts, we would greatly appreciate it if you help us boost the project visibility by starring the project repository, address the releases by reporting the experienced errors, choose the direction by proposing the intended features, enhance the usability by documenting the project repository, improve the codebase by opening the pull requests and finally, persist our efforts by sponsoring the development members.
Light mode - Dash
Light mode - Result
Dark mode - Dash
Dark mode - Result
Light mode - Dash
Light mode - Result
Dark mode - Dash
Dark mode - Result
The project depends on the Tesseract OCR project to be able to scan in-game screenshots using the Optical Character Recognition technology. As such, please ensure that the Tesseract OCR application is installed and configured properly.
Install Tesseract OCR from your default package manager.
$ sudo dnf install tesseract
Make note of the place where the Tesseract OCR executable binary is placed.
/usr/bin/tesseract
Install Tesseract OCR from the UB Mannheim GitHub namespace.
https://github.com/UB-Mannheim/tesseract/wiki
Make note of the place where the Tesseract OCR executable binary is placed.
C:\Program Files\Tesseract-OCR\tesseract.exe
Releases for the general usability purposes can be found here.
Releases for the testing debugging purposes can be found here.
Releases that automatically update can be found here.
Select the vision from
the dropdown menu to quickly locate the
character
that you wish to manage the equipment for.
Select the character
from the dropdown menu aligned with the
element
that was selected previously.
Select the level
of the character
constellation from the dropdown menu and statistics of the character will
be calculated automatically.
Select the level
of the character
experience from the dropdown menu and the statistics of the character
will be calculated automatically.
Quickly switch over to either of the
travelers, Lumine
or Aether from the
character menu using
the VENUS or MARS buttons respectively.
Once the character
is selected from the dropdown menu, the compatible
weapon
type is automatically selected.
Select the weapon of
your choice from the dropdown menu that you want to equip.
Select the rank
of the weapon
refinement from the dropdown menu and the statistics of the weapon will
be calculated automatically.
Select the level
of the weapon
experience from the dropdown menu and the statistics of the weapon like
will be calculated automatically.
Load the weapon
equipment from your local storage by using the LOAD button beside the
sections.
Save the weapon
equipment to your local storage by using the SAVE button beside the
sections.
Once the weapon has
been configured, configure the
artifacts by
selecting the artifact
set
from the dropdown menu.
Select the quality
associated with the
artifact
sought from the dropdown menu so that the possible
levels are
populated.
Select the level
of the artifact
experience from the dropdown menu.
Select the
primary stat of
the artifact from the
dropdown menu and the statistics of the artifact will be calculated
automatically.
Select the
secondary stats
of the artifact from
the dropdown menu from each
distribution
area.
Enter the value associated with the
secondary stats
of the
artifact from the
dropdown menu from each
distribution
area.
Alternatively, import the statistics from
artifact
units from in-game screenshots by using the SCAN buttons beside the
distribution areas.
Load the in-game screenshot of the
artifact units into
interface using the LOAD button.
Alternatively, the in-game screenshot of the
artifact units can be inserted from the
clipboard by pressing CTRL
+ V
.
Alternatively, the in-game screenshot of the
artifact units can be inserted by using
the drag and drop action.
Please note that the supported image formats include, but are not limited to, the following.
[image/bmp]
[BMP]
[image/gif]
[GIF]
[image/tiff]
[TIF]
[image/x-tga]
[TGA]
[application/vnd.oasis.opendocument.graphics]
[ODG]
[image/x-icon]
[ICO]
[image/png]
[PNG]
[image/jpeg]
[JPG]
[image/webp]
[WEBP]
[image/vnd.adobe.photoshop]
[PSD]
Please note that the unsupported image formats include, but are not limited to, the following.
[image/svg+xml]
[SVG]
[application/postscript]
[EPS]
Confirm if the correct
Tesseract OCR executable
is selected by using the LOCATE button.
Wipe the in-game screenshot of the
artifact unit from the
configuration area by using the WIPE button.
Import the statistics of the detected
artifact unit by using
the IMPORT button.
Wipe the statistics of the detected
artifact unit by using
from the configuration area by using the WIPE button.
Wait for the statistics to be read from the in-game screenshot of
artifact using Optical
Character Recognition or OCR.
Make corrections wherever the application was unable to correctly recognize
statistics of the
artifact before
importing them.
Confirm if better scanning results are obtained for the statistics
of the artifact from
the details screen.
Confirm if better scanning results are obtained for the statistics
of the artifact from
the inventory screen.
Confirm if better scanning results are obtained for the statistics
of the artifact from
the enhancement screen.
Alternatively, load the artifact
units from your local storage by using the LOAD buttons beside the
distribution areas.
Save the artifact
units to your local storage by using the SAVE buttons beside the
distribution areas.
Wipe the artifact
units from the configuration area by using the WIPE buttons beside the
distribution areas.
Read the
artifact bonuses
available to the character when using two pieces or four-pieces of a
certain artifact
set.
Load the artifact
sets from your local storage by using the LOAD buttons beside the
distribution areas.
Save the artifact
sets to your local storage by using the SAVE buttons beside the
distribution areas.
Wipe the artifact
sets from the configuration area by using the WIPE buttons beside the
distribution areas.
Calculate the
character potential
with the equipped
artifact units or sets
and weapon.
View the calculations of the character potential on the newly created
dialog box.
View the
help details
about the application by clicking on the HELP button from the user
interface.
View the
info details
about the application by clicking on the INFO button from the user
interface.
View the homepage of the
project by clicking on the FORK button from the user interface.
Report software errors or feature requests by clicking on the REPORT
button from the user interface.
Donate to the project by
clicking on the HEART button from the user interface.
$ sudo dnf install git tesseract
$ sudo dnf install python3 python3-pip python3-virtualenv poetry
$ git clone https://github.com/gridhead/gi-loadouts.git
$ cd gi-loadouts
$ virtualenv venv
$ source venv/bin/activate
(venv) $ poetry check
(venv) $ poetry install
(venv) $ poetry show
(venv) $ gi-loadouts
Git - https://git-scm.com/downloads
Tesseract - https://github.com/UB-Mannheim/tesseract/wiki
Python 3 - https://www.python.org/downloads/
Poetry - https://python-poetry.org/
PS > git clone https://github.com/gridhead/gi-loadouts.git
PS > cd gi-loadouts
PS > py -m venv venv
PS > .\venv\Scripts\activate
(venv) PS > py -m pip install poetry
(venv) PS > poetry install
(venv) PS > poetry show
(venv) PS > gi-loadouts.cmd
You can help our efforts by
Star the project repository
Starring our project repository on GitHub not only helps us witness your
support and boost the visibility for the project but it also motivates us
to continue improving and expanding our efforts.
Report the experienced errors
If you encounter any errors that should be taken care of, please file them
as issue tickets on our issue tracker to help us identify problems as it is
when we will be able to address the problems.
Propose the intended features
If you have any ideas that should be introduced in the project, please file
them as issue tickets on our issue tracker to help us understand the
direction you want the project to take in the future.
Document the project repository
Facilitating a comprehensive project documentation not only enhances the
project repository but it also vital for the project's growth among users
and project's approachability among developers.
Write the project codebase
Consider opening a pull request against the project repository to contribute
to the project codebase whether it is for fixing errors, adding features,
amending documentation or modifying assets.
Sponsor the project maintainers
By providing financial support, the maintainers have the means to dedicate
more efforts into the development of the project codebase and ensure
compatibility from each upcoming Genshin Impact release.
All rights to Genshin Impact assets used in this project are reserved by miHoYo Ltd. and Cognosphere Pte., Ltd.
Other properties belong to their respective owners.