diff --git a/docs/zzz/api_de.md b/docs/zzz/api_de.md index 56d63a63..59aa3339 100644 --- a/docs/zzz/api_de.md +++ b/docs/zzz/api_de.md @@ -2,12 +2,21 @@ ## Table of Content +- [Wichtige Notizen](#wichtige-notizen) - [Datenstruktur](#datenstruktur) - [Definitionen](#definitions) - [Formeln](#formeln) - [Icons und Bilder](#icons-und-bilder) - [Lokalisierungen](#lokalisierungen) +## Wichtige Notizen + +- UIDs für Waffen sowie Antriebsscheiben sind für den jeweiligen Gegenstand in einem Spielkonto einzigartig. Sie bleiben bei Verbesserungen der Antriebsscheibe/Waffe bestehen und können verwendet werden, um sie über mehrere Abfragen hinweg zu deduplizieren, wenn Sie den Überblick aller Ausrüstungen behalten möchten, die im Schaukasten angezeigt werden. + +- API Antworten werden immer die minimale Anzahl an Daten haben. Um Informationen zu kriegen, müssen sie mit den JSONs in [API-docs/store/zzz](https://github.com/EnkaNetwork/API-docs/tree/master/store/zzz) arbeiten. Wenn sie noch mehr Daten brauchen, gehen sie zu [ZenlessData](https://git.mero.moe/dimbreath/ZenlessData), gepflegt von Dimbreath. + +- Während sie mit Charakter, Waffen und Antriebsscheiben Statistiken arbeiten, sollten sie zu [Formeln](#formeln) gehen. Großes Dankeschön an Mero für das Reverse Engineering um die Formeln zu kriegen. + --- ## Datenstruktur @@ -66,23 +75,23 @@ | Exp | Agent Erfahrung | | Level | Agent Level | | PromotionLevel | Agent Beförderungsstufe | -| TalentLevel | Agent Sinnbild level | +| TalentLevel | Agent Sinnbild Level | | SkinId | Agent Skin ID | | CoreSkillEnhancement | Freigeschaltete Verbesserungen der Kernfähigkeit - A, B, C, D, E, F | -| TalentToggleList | Sinnbild Filmdarstellung Einstellungen | -| WeaponEffectState | W-Motor Signatur Special Effekt Status `[0: AUS, 1: AN]` | -| IsHidden | ... | +| TalentToggleList | Sinnbild Filmdarstellungseinstellungen | +| WeaponEffectState | W-Motor Signatureffektstatus `[0: Kein Effektstatus vorhanden, 1: AUS, 2: AN]` | +| IsHidden | Verstecktstatus des Agenten | | ClaimedRewardList | Agent Beförderungsbelohnungen | | ObtainmentTimestamp | Agent erhalten Datum | | WeaponUid | W-Motor UID | -| [Weapon](#weapon) | Ausgerüstete W-Motor | -| SkillLevelList | Agent skill level dict, überprüfe die Definitionen für Indexe | -| [EquippedList](#EquippedList) | Liste von Disc Laufwerke | +| [Weapon](#weapon) | Ausgerüsteter W-Motor | +| SkillLevelList | Agent Skill Level Dictionary, überprüfe die Definitionen für Indexe | +| [EquippedList](#EquippedList) | Liste von ausgerüsteten Antriebsscheiben | #### Weapon Unter [Formeln](#formeln) erfahren sie, wie man tatsächliche Werte aus den Basiswerten kriegt -Für mehr Info, gehe zu [store/zzz/weapons.json](https://raw.githubusercontent.com/EnkaNetwork/API-docs/refs/heads/master/store/zzz/weapons.json) +Für mehr Informationen, gehe zu [store/zzz/weapons.json](https://raw.githubusercontent.com/EnkaNetwork/API-docs/refs/heads/master/store/zzz/weapons.json) | Name | Beschreibung | | :--- | :--------- | @@ -93,19 +102,19 @@ Für mehr Info, gehe zu [store/zzz/weapons.json](https://raw.githubusercontent.c | BreakLevel | W-Motor Modifikationslevel | | UpgradeLevel | W-Motor Levelphase | | IsAvailable | W-Motor vorhanden | -| IsLocked | Gesperrtstatus der W-Motor | +| IsLocked | Gesperrtstatus des W-Motor | #### EquippedList | Name | Beschreibung | | :--- | :--------- | | Slot | Slot index | -| [Equipment](#equipment) | Equipment Daten | +| [Equipment](#equipment) | Ausrüstungsdaten | #### Equipment | Name | Beschreibung | | :--- | :--------- | -| Uid | Drive Laufwerk UID | +| Uid | Antriebsscheibe UID | | Id | Antriebsscheibe ID | | Exp | Exp | | Level | Antriebsscheibe Level `[0-15]` | @@ -191,26 +200,83 @@ Orientiere dich an der Tabelle unten und [store/zzz/property.json](https://raw.g | 3 | Gefährlicher Überfall | | 4 | Unendliches Gefecht – Sackgasse | +### Skills + +| Index | Beschreibung | +| :--- | :--------- | +| 0 | Standardattacke | +| 1 | Spezialattacke | +| 2 | Dash | +| 3 | Ultimativ | +| 5 | Kernattacke | +| 6 | Unterstützung | + --- ## Formeln +#### Agentstatistiken + +Um die Basisstats von einem Agent auszurechnen, musst du [store/zzz/avatars.json](https://github.com/EnkaNetwork/API-docs/blob/master/store/zzz/avatars.json) benutzen. + +- **Totaler Basiswert:** + `BaseTotalValue = BaseProps[PropertyId] + GrowthValue + PromotionValue + CoreEnhancementValue` +- **Wachstum:** + `GrowthValue = (GrowthProps[PropertyId] * (Avatar.Level - 1)) / 10000` +- **Beförderung:** + `PromotionValue = PromotionProps[Avatar.PromotionLevel][PropertyId]` +- **Kernverbesserung:** + `CoreEnhancementValue = CoreEnhancementProps[Avatar.CoreSkillEnhancement][PropertyId]` + +**NOTIZ:** Es ist empfohlen, die Ergebnisse runter zu runden bevor sie mit anderen Quellen addiert werden. + +### Spielakkurat + +#### W-Motor + +Um mit W-Motor-Statistiken zu arbeiten, musst du die folgenden JSONs benutzen: + \- [WeaponLevelTemplateTb.json](https://git.mero.moe/dimbreath/ZenlessData/src/branch/master/FileCfg/WeaponLevelTemplateTb.json) + \- [WeaponStarTemplateTb.json](https://git.mero.moe/dimbreath/ZenlessData/src/branch/master/FileCfg/WeaponStarTemplateTb.json) + + +- **Hauptattribut:** + `Ergebnis = MainStat.BaseValue * (1 + WeaponLevel.FIELD_XXX / 10000 + WeaponStar.FIELD_YYY / 10000)` + **Beispiel (Level 60, BreakLevel 5):** + `684 = 46 * (1 + 94090 / 10000 + 44610 / 10000)` + +- **Zweitattribut:** + `Ergebnis = MainStat.BaseValue * (1 + WeaponStar.FIELD_ZZZ / 10000)` + **Beispiel (BreakLevel 5):** + `2400 = 960 * (1 + 15000 / 10000)` + +**NOTIZ:** Der W-Motor **Stahlpfote** `[14102]` wurde in diesem Beispiel benutzt. + +#### Antriebsscheibe + +Um mit Antriebsscheibenstatistiken zu arbeiten, musst du [EquipmentLevelTemplateTb.json](https://git.mero.moe/dimbreath/ZenlessData/src/branch/master/FileCfg/EquipmentLevelTemplateTb.json) benutzen. + +Diese Datei gibt den Wert basierend auf seinem Level und seiner Rarität an. + +- **Hauptattribut:** + `Ergebnis = MainStat.PropertyValue * (1 + EquipmentLevel.Field_XXX)` + **Beispiel (Level 14, Rarität 4):** + `2090 = 550 * (1 + 28000 / 10000)` + +### Ungefähr + #### W-Motor -- Hauptattribut -`Ergebnis = MainStat.BaseValue * (1 + 0.1568166666666667 * Level + 0.8922 * BreakLevel)` +- **Hauptattribut:** + `Ergebnis = MainStat.BaseValue * (1 + 0.1568166666666667 * Level + 0.8922 * BreakLevel)` -- Subattribut -`Ergebnis = SubStat.BaseValue * (1 + 0.3 * BreakLevel)` +- **Zweitattribut:** + `Ergebnis = SubStat.BaseValue * (1 + 0.3 * BreakLevel)` #### Antriebsscheibe -- Hauptattribut +- **Hauptattribut:** `Ergebnis = MainStat.PropertyValue + (MainStat.PropertyValue * Level * RarityScale)` -- Subattribut -`Ergebnis = PropertyValue * PropertyLevel` - -#### Rarity Scales +- **Rarity Scales** | Rarität | Skalierung | | :----- | :------ | | 4 | 0.2 |