# Config

Details on the configuration of the Genshin Artifacts plugin

## **Config.yml**

**Display mode:**&#x20;

&#x20;hide-mmo-stats: false/true (defaut: true)

<figure><img src="https://51932323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F47P5RzqFmDrReI0huhIT%2Fuploads%2FuwEMOtrFSsvBpUvDMDJe%2F%7BE014B443-56D0-4F27-BDF1-FB3892F548E6%7D.png?alt=media&#x26;token=d462f2dc-9f72-4ae8-9ce1-57c55682d743" alt=""><figcaption></figcaption></figure>

when false:&#x20;

&#x20;![](https://51932323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F47P5RzqFmDrReI0huhIT%2Fuploads%2FPQXNvhLEKJIaOXcI5vwP%2F%7BF7AC44B8-93CA-498F-B7D3-0C05B19AEE3A%7D.png?alt=media\&token=9fb43e3e-7096-427f-a767-643b107e41dc)

when true:

<figure><img src="https://51932323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F47P5RzqFmDrReI0huhIT%2Fuploads%2Fg5M0U5tsfGwtdI9lp3u5%2F%7B17DED5F7-55AB-4AA6-B4D0-E7534801589E%7D.png?alt=media&#x26;token=9ebcfb88-4946-48c4-b92c-6fcb20270fdf" alt=""><figcaption></figcaption></figure>

&#x20;roll display:

&#x20;  enabled: false/true (default: true)

&#x20;\- Detailt: When enhancing an artifact to level 4, 8, 12, 16, 20 — a random substat, is selected and rolled again. The number in parentheses shows roll count

&#x20;\- Example:

&#x20; CRIT Rate% +3.1% (1)\
&#x20; When you have that score twice, you will get: CRIT Rate% +6.2% (2)\
&#x20; At 3 time: CRIT Rate% +9.3% (3)

<figure><img src="https://51932323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F47P5RzqFmDrReI0huhIT%2Fuploads%2Fmz9kBMzdvh2mpihnSdK2%2F%7BBCD59C16-2127-41C8-B30F-B1DE6641EB17%7D.png?alt=media&#x26;token=fe334274-fbbd-4eab-b7d7-e6f2c32f3271" alt=""><figcaption></figcaption></figure>

**Enhance EXP:**

Customize EXP required to enhance artifacts

&#x20;enhance-exp: (default)

```yaml
   fodder:
     1: 420 -> Exp for enhance other artifacts
     2: 840 -> Exp for enhance other artifacts
     3: 2520 -> Exp for enhance other artifacts
     4: 10080 -> Exp for enhance other artifacts
     5: 40320 -> Exp for enhance other artifacts
   per-rarity:
     1: 0 -> 1-star cannot be enhanced
     2: 2520 -> 3x 2-star fodder per level
     3: 7560 -> 3x 3-star fodder per level
     4: 30240 -> 3x 4-star fodder per level
     5: 120960 -> 3x 5-star fodder per level
   per-level:
     5: -> 5 star
       0: 120960 -> level 0 to 1
       1: 120960 -> level 1 to 2
       ....
```

<figure><img src="https://51932323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F47P5RzqFmDrReI0huhIT%2Fuploads%2FInE9zQAKhcD5hcHoMoY1%2F%7BDF01FC02-F8AD-4DC5-9E7D-06B8C351F0CA%7D.png?alt=media&#x26;token=bc9f0367-56a2-4009-8004-ccd1fb0a6f59" alt=""><figcaption></figcaption></figure>

**Sound & tiers:**

```yaml
enhance-sound: 
  enabled: true ##-> status 
  success: "UI_TOAST_CHALLENGE_COMPLETE"  ##-> success sound
  fail: "BLOCK_NOTE_BLOCK_PLING" ##-> fail sound
  volume: 1.0 ##-> volume
  pitch: 1.0 ##-> pitch
```

```yaml
tiers: (default)
   1: common
   2: uncommon
   3: rare
   4: epic
   5: legendary
```

you can edit tooltips in plugins/MMOItems/tooltips/\*.yml

For Example with tooltips\
![](https://51932323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F47P5RzqFmDrReI0huhIT%2Fuploads%2FXOI9lOKNXPBd1xDMwqn9%2F%7BF1262455-F96F-4595-96C5-F86EA64EFD44%7D.png?alt=media\&token=56b88b9a-61d2-43e5-92ab-5a87764f7d8d)

**Stat Ranges:**

Min/Max for each main stat at 5-star

<figure><img src="https://51932323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F47P5RzqFmDrReI0huhIT%2Fuploads%2FaKrEDqde2WMOtICR3Uwm%2F%7B6571CF3E-DC54-4107-9453-4A1940CB72E7%7D.png?alt=media&#x26;token=5ec2bcd3-2785-4144-9934-5424c1d62951" alt=""><figcaption></figcaption></figure>

you can customize this stats for your server

Example stats custom:

### **5 star range Lv.0 -> Lv.20**

| stats name        | min  | max   | details                                                                                  |
| ----------------- | ---- | ----- | ---------------------------------------------------------------------------------------- |
| FLAT HP           | 717  | 4780  | HP (no percent)                                                                          |
| FLAT ATK          | 47   | 311   | ATK (no percent)                                                                         |
| HP%               | 7%   | 46.6% | Percent of Health points                                                                 |
| ATK%              | 7%   | 46.6% | Percent of Attack Damage                                                                 |
| Elemental Mastery | 28   | 187   | Increase elemental reaction damage                                                       |
| Energy Recharge%  | 7.8% | 51.8% | Increase the elemental charge speed for the ultimate                                     |
| Crit rate         | 9.3% | 62.2% | The probability of landing a critical hit or skill                                       |
| Crit Dmg          | 9.3% | 62.2% | Deals additional damage when critical hits are activated                                 |
| Healing Bonus     | 5.4% | 35,9% | Restores health when using healing abilities                                             |
| Physical dmg bous | 8.7% | 58%   | Receive additional physical damage when attacking                                        |
| Pyro dmg bonus    | 7.0% | 46.6% | Gain additional Pyro damage when using Pyro elemental abilities                          |
| Hydro dmg bonus   | 7.0% | 46.6% | Gain additional Hydro element when using a Hydro elemental damage ability                |
| Cryo dmg bonus    | 7.0% | 46.6% | Deals additional Cryo elemental damage when using a Cryo elemental damage ability        |
| Electro dmg bonus | 7.0% | 46.6% | Deals additional Electro elemental damage when using Electro elemental damage abilities  |
| Anemo dmg bonus   | 7.0% | 46.6% | Deals additional elemental damage to Anemo when using Anemo's elemental damage ability   |
| Geo dmg bonus     | 7.0% | 46.6% | Deals additional Geo elemental damage when using a Geo elemental damage ability          |
| Dendro dmg bonus  | 7.0% | 46.6% | Deals additional elemental damage to Dendro when using Dendro elemental damage abilities |

**Drop System:**

Example:

```yaml
drops:
  enabled: true/false
  global-chance: 0.05 #-> 5%chance mobs killed per players
  min-rarity: 1 #-> 1 star artifacts
  max-rarity: 5 #-> 5 star artifacts
  rarity-weights:
    1: 50 # 50% for 1 star artifact
    2: 30 # 30% 2 star artifact
    3: 15 # 15% 3 star artifact
    4: 4 # 4% 4 star artifact
    5: 1 # 1% 5 star artifact
#mobs priority
  mob-overrides:
    ELDER_GUARDIAN:
      chance: 0.50 #0,5% for drop artifacts
      min-rarity: 4
      max-rarity: 5
    ENDER_DRAGON:
      chance: 1.00 #1% for drop artifacts
      min-rarity: 5
      max-rarity: 5
    WITHER:
      chance: 1.00 #1% for drop artifacts
      min-rarity: 4
      max-rarity: 5
    ZOMBIE:
      chance: 0.02 #0,02% for drop artifacts
```

**Set Effects:**

Potion effects when wearing full artifact set: (minecraft potion effect) "-1 for turn off"

amplifier: 0 = level I, 1 = level II, ...

```yaml
set-effects:
  gladiators_finale:
    2pc:
      effect: INCREASE_DAMAGE
      amplifier: 0        # Strength I
  wanderers_troupe:
    2pc:
      effect: FAST_DIGGING
      amplifier: 0        # Haste I
  noblesse_oblige:
    4pc:
      effect: INCREASE_DAMAGE
      amplifier: 1        # Strength II (after using burst)
  bloodstained_chivalry:
    2pc:
      effect: INCREASE_DAMAGE
      amplifier: 0
  viridescent_venerer:
    2pc:
      effect: SPEED
      amplifier: 0
  crimson_witch:
    2pc:
      effect: FIRE_RESISTANCE
      amplifier: 0
  blizzard_strayer:
    2pc:
      effect: INCREASE_DAMAGE
      amplifier: 0
  heart_of_depth:
    2pc:
      effect: SPEED
      amplifier: 0
  thundersoother:
    4pc:
      effect: INCREASE_DAMAGE
      amplifier: 1
  pale_flame:
    2pc:
      effect: INCREASE_DAMAGE
      amplifier: 0
  emblem_of_severed_fate:
    2pc:
      effect: FAST_DIGGING
      amplifier: 0
  shimenawas_reminiscence:
    2pc:
      effect: INCREASE_DAMAGE
      amplifier: 0
```

**Lore Format:**

Customize artifact lore display (Support bukkit color code) - no hex color

Bukkit color code: \
&#x20; &0 = black\
&#x20; &1 = dark blue\
&#x20; &2= dark green\
&#x20; &3= dark aqua\
&#x20; &4 = dark red\
&#x20; &5 = dark purple\
&#x20; &6 = gold\
&#x20; &7 = gray\
&#x20; &8 = dark gray\
&#x20; &9 = blue\
&#x20; \&a = green\
&#x20; \&b = aqua\
&#x20; \&c = red\
&#x20; \&d = pink\
&#x20; \&e = yellow\
&#x20; \&f = white

PLACEHOLDERS: (only use in plugin not for other plugins)\
&#x20; {rarity\_stars} — star icons colored by rarity, e.g. stars\
&#x20; {rarity\_color} — ChatColor code for rarity (prepend to text)\
&#x20; {level} — current level\
&#x20; {max\_level} — max level for this rarity\
&#x20; {slot\_emoji} — slot emoji (flower/plume/sands/goblet/circlet icons)\
&#x20; {slot\_name} — slot name (Flower of Life, ...)\
&#x20; {main\_emoji} — main stat emoji\
&#x20; {main\_name} — main stat name\
&#x20; {main\_value} — main stat value (formatted, e.g. 4780 or 46.6%)\
&#x20; {separator} — horizontal line (uses separator value below)\
&#x20; {set\_name} — artifact set name\
&#x20; {set\_emoji} — artifact set emoji\
\--------------------------------------substats--------------------------------------\
&#x20; {sub\_emoji} — substat emoji\
&#x20; {sub\_name} — substat name\
&#x20; {sub\_value} — substat value (e.g. +4.1%)\
&#x20; {sub\_rolls} — formatted roll count (e.g. (1) (2) (3)...)\
&#x20; {sub\_rolls\_raw} — raw integer (1, 2, 3...) no formatting/color\
\--------------------------------------icons--------------------------------------\
&#x20; {slot\_icon} — icon for slot (flower/plume/sands/goblet/circlet)\
&#x20; {set\_icon} — icon for artifact set\
&#x20; {main\_icon} — icon for main stat\
&#x20; {rarity\_icon} — icon for rarity\
&#x20; {sub\_icon} — icon for each substat (inside {sub\_loop})

```yaml
lore-format:
  separator: "&8&m                    "
  empty-sub: "&8  ✦ &7???"
  lines:
    - "{rarity_stars}  &8Lv.&7{level}&8/{max_level}"
    - "&7{set_emoji} &e{set_name}"
    - "&7{slot_emoji} &f{slot_name}"
    - ""
    - "&7{main_emoji} &7{main_name}"
    - "    &b{main_value} &8(main stat)"
    - "{separator}"
    - "&8  {sub_emoji} &f{sub_name}  &a{sub_value} {sub_rolls}{sub_loop}"
```

Customize stats | slot | sets | rarity icons

```yaml
icons:

  # Icons per slot
  slot:
    flower: ""
    feather: ""
    sands: ""
    goblet: ""
    circlet: ""

  # Icons per artifact set (use set ID, lowercase)
  set:
    gladiators_finale: ""
    wanderers_troupe: ""
    noblesse_oblige: ""
    bloodstained_chivalry: ""
    viridescent_venerer: ""
    crimson_witch: ""
    blizzard_strayer: ""
    heart_of_depth: ""
    thundersoother: ""
    pale_flame: ""
    emblem_of_severed_fate: ""
    shimenawas_reminiscence: ""

  # Icons per main stat (use enum name, lowercase)
  main:
    flat_hp: ""
    flat_atk: ""
    hp_percent: ""
    atk_percent: ""
    def_percent: ""
    elemental_mastery: ""
    energy_recharge: ""
    crit_rate: ""
    crit_dmg: ""
    healing_bonus: ""
    physical_dmg_bonus: ""
    pyro_dmg_bonus: ""
    hydro_dmg_bonus: ""
    cryo_dmg_bonus: ""
    electro_dmg_bonus: ""
    anemo_dmg_bonus: ""
    geo_dmg_bonus: ""
    dendro_dmg_bonus: ""

  # Icons per substat (use enum name, lowercase)
  substat:
    flat_hp: ""
    flat_atk: ""
    flat_def: ""
    hp_percent: ""
    atk_percent: ""
    def_percent: ""
    energy_recharge: ""
    elemental_mastery: ""
    crit_rate: ""
    crit_dmg: ""

  # Icons per rarity (1-5)
  rarity:
    1: ""
    2: ""
    3: ""
    4: ""
    5: ""
```

Name custom for stats and slots

You can completely customize the stats and slot name to your liking

```yaml
stat-names:

  # Main stats
  main:
    FLAT_HP:
      name: "HP"
    FLAT_ATK:
      name: "ATK"
    HP_PERCENT:
      name: "HP%"
    ATK_PERCENT:
      name: "ATK%"
    DEF_PERCENT:
      name: "DEF%"
    ELEMENTAL_MASTERY:
      name: "Elemental Mastery"
    ENERGY_RECHARGE:
      name: "Energy Recharge%"
    CRIT_RATE:
      name: "CRIT Rate%"
    CRIT_DMG:
      name: "CRIT DMG%"
    HEALING_BONUS:
      name: "Healing Bonus%"
    PHYSICAL_DMG_BONUS:
      name: "Physical DMG Bonus%"
    PYRO_DMG_BONUS:
      name: "Pyro DMG Bonus%"
    HYDRO_DMG_BONUS:
      name: "Hydro DMG Bonus%"
    CRYO_DMG_BONUS:
      name: "Cryo DMG Bonus%"
    ELECTRO_DMG_BONUS:
      name: "Electro DMG Bonus%"
    ANEMO_DMG_BONUS:
      name: "Anemo DMG Bonus%"
    GEO_DMG_BONUS:
      name: "Geo DMG Bonus%"
    DENDRO_DMG_BONUS:
      name: "Dendro DMG Bonus%"

  # Sub stats
  sub:
    FLAT_HP:
      name: "HP"
    FLAT_ATK:
      name: "ATK"
    FLAT_DEF:
      name: "DEF"
    HP_PERCENT:
      name: "HP%"
    ATK_PERCENT:
      name: "ATK%"
    DEF_PERCENT:
      name: "DEF%"
    ENERGY_RECHARGE:
      name: "Energy Recharge%"
    ELEMENTAL_MASTERY:
      name: "Elemental Mastery"
    CRIT_RATE:
      name: "CRIT Rate%"
    CRIT_DMG:
      name: "CRIT DMG%"

# ==============================================================================
# Slot Names — Display names for the 5 artifact slots
# ==============================================================================
slot-names:
  flower: "Flower of Life"
  feather: "Plume of Death"
  sands: "Sands of Eon"
  goblet: "Goblet of Eonothem"
  circlet: "Circlet of Logos"
```

**Converter:**

Add or completely replace the lore of Genshin Artifacts while retaining the stats of the MMO Items

```yaml
convert:
  keep-original-lore: false
```

## **Custom-slot.yml**

&#x20; Item Type (get syntax in plugins/MMOItems/item-types.yml) and make it like that

Example config

```yaml
item-types:

#Example: Flower of Life — a new type inheriting from ACCESSORY, into the ACCESSORY slot in MMOInventory
  HOASUSONG:
    parent: 'ACCESSORY' #parent, for example, accessories, bows, swords...
    name: 'Flower of Life' #name in MMOItems GUI
    display: PINK_TULIP #MMOItems material
    modifier-source: ACCESSORY #MMOInventory decided to replace slots with valid values ​​such as ACCESSORY, ARMOR, MELEE_WEAPON...
    hide-in-game: false #true = hide in /mi browse
    unident-item: #template item Undefined template item optional
      name: '&f#prefix#Flower of Life'
      lore:
        - '&7This item is unidentified. I must'
        - '&7find a way to identify it!'
        - '{tier}'
        - '{tier}&8Item Info:'
        - '{range}&8- &7Lvl Range: &e#range#'
        - '{tier}&8- &7Item Tier: #prefix##tier#'
```

&#x20; Slots

Register MMOItems in the GA slot to be able to roll artifacts

Example config:

```yml
slots:

  # The item ID in MMOItems must match your item file.
  # For example: plugins/MMOItems/item/HOASUSONG.yml has an entry HOA_SU_SONG
  HOA_SU_SONG:
    mmoitems-type: HOASUSONG   # type defined above
    slot: flower
    display-name: "Flower of Life"
    emoji: "❀"
```

### **sets.yml**

GenshinArtifacts - MMOItems Set Definitions, place it to MMOItems/sets.yml file or import it via the sets config\
These sets correspond to Genshin Impact artifact sets\
Set bonuses are applied when a player equips 2 or 4 items from the same set

Example:&#x20;

```yml
GLADIATORS_FINALE:
  name: "&6Gladiator's Finale"
  lore-tag:
    - "&6[Gladiator's Finale]"
  bonuses:
    2:
      attack-damage: 18.0
    4:
      attack-damage: 18.0
      weapon-damage: 35.0

WANDERERS_TROUPE:
  name: "&dWanderer's Troupe"
  lore-tag:
    - "&d[Wanderer's Troupe]"
  bonuses:
    2:
      skill-damage: 80.0
    4:
      skill-damage: 80.0
      weapon-damage: 35.0

NOBLESSE_OBLIGE:
  name: "&bNoblesse Oblige"
  lore-tag:
    - "&b[Noblesse Oblige]"
  bonuses:
    2:
      magic-damage: 20.0
    4:
      magic-damage: 20.0
      attack-damage: 20.0

BLOODSTAINED_CHIVALRY:
  name: "&cBloodstained Chivalry"
  lore-tag:
    - "&c[Bloodstained Chivalry]"
  bonuses:
    2:
      physical-damage: 25.0
    4:
      physical-damage: 25.0
      weapon-damage: 50.0

VIRIDESCENT_VENERER:
  name: "&aViridescent Venerer"
  lore-tag:
    - "&a[Viridescent Venerer]"
  bonuses:
    2:
      magic-damage: 15.0
    4:
      magic-damage: 75.0

CRIMSON_WITCH:
  name: "&4Crimson Witch of Flames"
  lore-tag:
    - "&4[Crimson Witch]"
  bonuses:
    2:
      magic-damage: 15.0
    4:
      magic-damage: 55.0

BLIZZARD_STRAYER:
  name: "&9Blizzard Strayer"
  lore-tag:
    - "&9[Blizzard Strayer]"
  bonuses:
    2:
      magic-damage: 15.0
    4:
      magic-damage: 15.0
      critical-strike-chance: 20.0

HEART_OF_DEPTH:
  name: "&3Heart of Depth"
  lore-tag:
    - "&3[Heart of Depth]"
  bonuses:
    2:
      magic-damage: 15.0
    4:
      magic-damage: 15.0
      weapon-damage: 30.0

THUNDERSOOTHER:
  name: "&eThundersoother"
  lore-tag:
    - "&e[Thundersoother]"
  bonuses:
    2:
      damage-reduction: 40.0
    4:
      damage-reduction: 40.0
      pve-damage: 35.0

PALE_FLAME:
  name: "&fPale Flame"
  lore-tag:
    - "&f[Pale Flame]"
  bonuses:
    2:
      physical-damage: 25.0
    4:
      physical-damage: 25.0
      attack-damage: 18.0

EMBLEM_OF_SEVERED_FATE:
  name: "&5Emblem of Severed Fate"
  lore-tag:
    - "&5[Emblem of Severed Fate]"
  bonuses:
    2:
      cooldown-reduction: 20.0
    4:
      cooldown-reduction: 20.0
      magic-damage: 25.0

SHIMENAWAS_REMINISCENCE:
  name: "&2Shimenawa's Reminiscence"
  lore-tag:
    - "&2[Shimenawa's Reminiscence]"
  bonuses:
    2:
      attack-damage: 18.0
    4:
      attack-damage: 18.0
      weapon-damage: 50.0
```
