Enhancment Progress Calculator

A wrapper around the Genshin Impact Enhancment Progress Calculator page. Contains a database of all characters, weapons and artifacts. Also the only way to receive talents.

To request calculator endpoints that require user's in-game information, you must first be logged in. Refer to the authentication section for more information.

Accessing the Database

# get a list of all characters
characters = await client.get_calculator_characters()

# get a list of all weapons
weapons = await client.get_calculator_weapons()

# get a list of all artifacts
artifacts = await client.get_calculator_artifacts()

# search for a specific character/weapon/artifact
characters = await client.get_calculator_characters(query="Xi")

# filter the returned characters/weapons/artifacts
weapons = await client.get_calculator_weapons(rarities=[5, 4])

# get all other artifacts in a set
artifacts = await client.get_complete_artifact_set(7554)

# get a list of synced characters (must be logged in)
# only returns the characters you have and ensures all level fields are provided
characters = await client.get_calculator_characters(sync=True)

# get the details of a character
# includes their weapon, artifacts and talents
details = await client.get_character_details(10000002)

Example Of Calculation

Basic Calculation

The calculator uses builders to set data. All methods return self so they're chainable.

# create a builder object
builder = client.calculator()
# calculate resoources needed to level up Hu Tao from lvl 1 to lvl 90
builder.set_character(10000046, current=1, target=90)
# calculate the amount of resources needed for a Staff of Homa from level 20 to level 70
builder.set_weapon(13501, current=20, target=70)

# execute the builder
cost = await builder.calculate()
print(cost)

# you may also chain the builder (recommended)
cost = await (
    client.calculator()
    .set_character(10000046, current=1, target=90)
    .set_weapon(13501, current=20, target=70)
)

# calculate the amount needed for a 5* gladiator's nostalgia
artifact_id = 7554
cost = await (
    client.calculator()
    .add_artifact(artifact_id, current=0, target=20)
)

# or calculate for a full set
cost = await (
    client.calculator()
    .set_artifact_set(artifact_id, current=0, target=20)
)

Calculation based off a character

If we assume we're calculating resources for the currently logged in user we can simply get their weapon and artifact levels directly.

# Let's use the currently equipped weapon, artifacts and talents
cost = await (
    client.calculator()
    .set_character(10000046, current=1, target=90)
    .with_current_weapon(target=70)
    .with_current_artifacts(target=20) # every artifact will be set to lvl 20
    .with_current_talents(target=7) # every artifact will be set to lvl 7
)

# you may want to upgrade only specific talent or artifact types
cost = await (
    client.calculator()
    .set_character(10000046, current=80, target=90)
    # upgrade only the flower and feather
    .with_current_artifacts(flower=16, feather=20)
    # upgrade only the burst
    .with_current_talents(burst=10)
)

Batch Calculation

You can calculate multiple characters at once using a batch builder, each character can also have their own weapon (optional).

character1 = (
    client.calculator()
    .set_character(10000052, current=1, target=90)
    .set_weapon(11509, current=1, target=90)
    .set_artifact_set(9651, current=0, target=20)
    .with_current_talents(current=1, target=10)
)
character2 = (
    client.calculator()
    .set_character(10000020, current=1, target=90)
    .set_weapon(11401, current=1, target=90)
    .set_artifact_set(7551, current=0, target=20)
    .with_current_talents(current=1, target=10)
)

batch = client.batch_calculator().add_character(character1).add_character(character2)
result = await batch.calculate()
print(result)