https://github.com/genshinsim/gcsim
monte carlo combat simulation for genshin impact
https://github.com/genshinsim/gcsim
game genshin-impact simulation
Last synced: 5 months ago
JSON representation
monte carlo combat simulation for genshin impact
- Host: GitHub
- URL: https://github.com/genshinsim/gcsim
- Owner: genshinsim
- License: mit
- Created: 2021-06-14T13:35:58.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-04-13T01:28:18.000Z (about 2 years ago)
- Last Synced: 2024-04-14T07:10:28.256Z (about 2 years ago)
- Topics: game, genshin-impact, simulation
- Language: Go
- Homepage:
- Size: 125 MB
- Stars: 260
- Watchers: 5
- Forks: 85
- Open Issues: 108
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-genshin-impact - gcsim
README
# Overview
gcsim is a Monte Carlo simulation tool used to model Genshin Impact's combat. The user can input a set of characters, targets, options, and actions to perform, and then gcsim executes these actions. It outputs a variety of results, such as mean DPS and the DPS distribution across iterations. The user can also scroll through a sample of 1 iteration, which comprehensively lists every action, damage instance, reactions, buffs, etc. frame by frame.
# Getting Started
Primary usage of gcsim is through the webapp: [https://gcsim.app](https://gcsim.app). You also can download the latest build and run it as a CLI [here](https://github.com/genshinsim/gcsim/releases). Our [docs](https://docs.gcsim.app/guides/building_a_simulation_basic_tutorial) explain how to write and understand configs.
Any issues or questions can be shared on our [Discord](https://discord.gg/m7jvjdxx7q), where experienced users can take a look.
## Project Status
The project is entirely volunteer driven and under constant development as Genshin Impact is a live service game. A large majority of units, items, and game mechanics have been implemented, however there are limitations described in our [issues](https://github.com/genshinsim/gcsim/issues?q=is%3Aopen+is%3Aissue). Additionally, manpower is limited to provide timely releases especially as 5.8+ units require significant changes to the codebase to support.
## Contributing
Here are a few ways to help improve the quality of gcsim:
- Record exhaustive frame counts of new unit actions, methodology detailed [here](https://docs.gcsim.app/mechanics/frames/).
- Validate gameplay and sim results, ensure the sim can reproduce damage calculations, reactions, and buff uptimes faithfully.
- Build action lists aka "rotations" for any team composition and submit them to our [Config Database](https://simpact.app/) via [Discord](https://discord.gg/m7jvjdxx7q).
- Use gcsim for gear, rotation, and team comparisons, while scrutinizing both expected and unexpected results. This is the best way potential issues can be spotted.
gcsim is always looking for volunteers and developers. If you would like to contribute, please inquire on our [Discord](https://discord.gg/m7jvjdxx7q) and look at the [contributing guidelines](CONTRIBUTING.md).