Loadouts for Genshin Impact

This is a desktop application that allows travelers to manage their custom equipment of artifacts and weapons for playable characters, and to make 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 in the near future, 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 fixing releases by reporting the experienced errors, choose the project direction by proposing the intended features, enhance the project usability by documenting the project repository, improve the project codebase by opening the pull requests and finally, persist our maintenance efforts by sponsoring the development members.

Screenshots

• Light mode - Console (Arlecchino)
  

• Dark mode - Console (Xianyun)
  

• Light mode - Results (Arlecchino)
  

• Dark mode - Results (Xianyun)
  

• Help
  

• Info
  

Download

Stable releases

Releases for the general usability purposes can be found here.

Nightly releases

Releases for the testing debugging purposes can be found here.

Usage

1. Select the vision from the dropdown menu to quickly locate the character that you wish to manage the equipment for.
   

2. Select the character from the dropdown menu aligned with the element that was selected previously.
   

3. Select the level of the character experience from the dropdown menu and the statistics of the character will be calculated automatically.
   

4. Select the level of the character constellation from the dropdown menu and statistics of the character will be calculated automatically.
   

5. Quickly switch over to either of the travelers, Lumine or Aether from the character menu using the VENUS or MARS buttons respectively.
   
   

6. Once the character is selected from the dropdown menu, the compatible weapon type is automatically selected.
   

7. Select the weapon of your choice from the dropdown menu that you want to equip.
   

8. Select the level of the weapon experience from the dropdown menu and the statistics of the weapon like will be calculated automatically.
   

9. Select the rank of the weapon refinement from the dropdown menu and the statistics of the weapon will be calculated automatically.
   

10. Save the weapon equipment to your local storage by using the SAVE button beside the sections.
    

11. Load the weapon equipment from your local storage by using the LOAD button beside the sections.
    

12. Once the weapon has been configured, configure the artifacts by selecting the artifact set from the dropdown menu.
    

13. Select the quality associated with the artifact sought from the dropdown menu so that the possible levels are populated.
    

14. Select the level of the artifact experience from the dropdown menu.
    

15. Select the primary stat of the artifact from the dropdown menu and the statistics of the artifact will be calculated automatically.
    

16. Select the secondary stats of the artifact from the dropdown menu from each distribution area.
    

17. Enter the value associated with the secondary stats of the artifact from the dropdown menu from each distribution area.
    

18. Save the artifact units to your local storage by using the SAVE buttons beside the distribution areas.
    

19. Load the artifact units from your local storage by using the LOAD buttons beside the distribution areas.
    

20. Wipe the artifact units from the configuration area by using the WIPE buttons beside the distribution areas.
    

21. Read the artifact bonuses available to the character when using two pieces or four-pieces of a certain artifact set.
    

22. Save the artifact sets to your local storage by using the SAVE buttons beside the distribution areas.
    

23. Load the artifact sets from your local storage by using the LOAD buttons beside the distribution areas.
    

24. Wipe the artifact sets from the configuration area by using the WIPE buttons beside the distribution areas.
    

25. Calculate the character potential with the equipped artifact units or sets and weapon.
    

26. View the calculations of the character potential on the newly created dialog box.
    

27. View the help details about the application by clicking on the HELP button from the user interface.
    

28. View the info details about the application by clicking on the INFO button from the user interface.
    

29. View the homepage of the project by clicking on the FORK button from the user interface.
    

30. Donate to the project by clicking on the HEART button from the user interface.
    

Development

On GNU/Linux distributions

1. Ensure that the necessary packages are available on the operating system installation.

   $ sudo dnf install git
   $ sudo dnf install python3 python3-pip python3-virtualenv poetry
   

2. Clone your fork to the local storage and make it your current working directory.

   $ git clone https://github.com/gridhead/gi-loadouts.git
   $ cd gi-loadouts
   

3. Create a virtual environment and activate it for installing project dependencies.

   $ virtualenv venv
   $ source venv/bin/activate
   

4. Install the project dependencies after verifying the correctness of the configuration.

   (venv) $ poetry check
   (venv) $ poetry install
   

5. Start the application after verifying that the dependencies have been installed.

   (venv) $ poetry show
   (venv) $ gi-loadouts
   

6. Once done with making changes in a separate branch, make a pull request to contribute.

On Microsoft Windows

1. Ensure that the necessary packages are available on the operating system installation.

   Git - https://git-scm.com/download/
   Python 3 - https://www.python.org/downloads/
   

2. Clone your fork to the local storage and make it your current working directory.

   PS > git clone https://github.com/gridhead/gi-loadouts.git
   PS > cd gi-loadouts
   

3. Create a virtual environment and activate it for installing project dependencies.

   PS > py -m venv venv
   PS > .\venv\Scripts\activate
   

4. Install the project dependencies after installing the dependency management tools.

   (venv) PS > py -m pip install poetry
   (venv) PS > poetry install
   

5. Start the application after verifying that the dependencies have been installed.

   (venv) PS > poetry show
   (venv) PS > gi-loadouts.cmd
   

6. Once done with making changes in a separate branch, make a pull request to contribute.

Contribution

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.

Disclaimer

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.