# 🔗Compatibility

The compatibility of plugins mainly includes hooks for **item plugins** and **economy plugins**. Unlike other plugins of the same type, we can support them regardless of their appearance.

## **Direct compatibility**

Direct compatibility refers to the use of item plugins or the economy of economic plugins directly in **ItemFormat** or **EconomyFormat**. This compatibility method is the simplest and officially supported.

### <mark style="color:red;">Directly</mark> supported item plugins list

* ItemsAdder
* Oraxen
* EcoItems
* EcoArmor
* MMOItems
* MythicMobs
* eco
* NeigeItems
* ExecutableItems
* Nexo
* CraftEngine

### <mark style="color:red;">Directly</mark> supported economy plugins list

* PlayerPoints
* CoinsEngine
* UltraEconomy
* EcoBits
* PEconomy
* RedisEconomy
* RoyaleEconomy
* VotingPlugin

The following provides an example of directly obtaining items from the **ItemsAdder** plugin through the direct compatibility feature in **ItemFormat** and using economy from **Vault** plugin in **EconomyFormat**:

```yaml
  prices:
    1:
      hook-plugin: ItemsAdder # Item Format
      hook-item: fishing_pack:common_fishing_bait # Item Format
      placeholder: 'common_fishing_bait x10'
      apply: [1,2]
      amount: 10
    2:
      economy-plugin: Vault
      placeholders:
        2: '$10'
        3: '$20'
        4: '$30'
        5: '$40'
      apply: [2,3,4,5]
      cost: [10,20,30,40]
      conditions: []
  rewards:
    1:
      material: GOLDEN_APPLE
      amount: 1~5
      rates:
        default: 3
      edge: very_rare
    2:
      material: DIAMOND
      amount: 5~10
      rate: 6
      edge: rare
    3:
      material: ENCHANTED_GOLDEN_APPLE
      amount: 5~10
      rate: 1
      edge: very_very_rare
```

## PlaceholderAPI: Extra placeholders <a href="#placeholderapi-extra-placeholders" id="placeholderapi-extra-placeholders"></a>

**FlipCard** provides those new placeholders to PlaceholderAPI!

* `%flipcard_times_player_<UIConfig>%` - show the left times of specified UI config.

## MythicDungeons: Extra function <a href="#neigeitems-item-name-translation-hook" id="neigeitems-item-name-translation-hook"></a>

A addon plugin called **ManyouMDExtension** add new function to MythicDungeons.

* Start flip UI - open a flip UI to players.

Download Link: <https://www.spigotmc.org/resources/manyoumdextension-add-more-functions-for-mythicdungeons-for-our-plugins-1-14-1-21-4.99816/>

## NeigeItems: Item Name Translation Hook <a href="#neigeitems-item-name-translation-hook" id="neigeitems-item-name-translation-hook"></a>

Through this hook, the localized names of vanilla items can be automatically displayed in the language set in NeigeItems.

Download NeigeItems here: <https://github.com/ankhorg/NeigeItems-Kotlin/releases>

You should download NeigeItems-xxx.jar (not NeigeItems-api), the file lager than 10MB.

Install it in your server and change it's `language` option in `config.yml` file.

All is done! Now plugin will auto display localized item name for now.

## MythicChanger: Extra Item Format option <a href="#mythicchanger-extra-item-format-option" id="mythicchanger-extra-item-format-option"></a>

Through this hook, based on the [ItemFormat](https://ultimateshop.superiormc.cn/format/itemformat-tm), items can be further modified to their desired appearance.

This feature require your server must install **MythicChanger** plugin, please get it here:

**FREE:** [Click to download](https://www.spigotmc.org/resources/mythicchanger-match-and-modify-all-your-items-without-trouble-1-14-1-21.98523/)

**PREMIUM:** [Click to download](https://www.spigotmc.org/resources/mythicchanger-premium-match-and-modify-all-your-items-without-trouble-1-14-1-21.115913/)

For how to configure the `change-item` section, please read MythicChanger's wiki, [click here](https://simple.superiormc.cn/) to visit. Please note that some of the change rules require **PREMIUM version of MythicChanger, not PREMIUM version of UltimateShop**!

If you are using **premium version of MythicChanger**, it will allow you use custom NBT tag by adding nbt-xxx rule here. You can also use `/mc viewnbt` command to view the hold item NBT info.

```yaml
change-item:
  set-name: '&fGood Diamond Sword'
```

## NBTAPI: Extra Item Format option  <a href="#nbtapi-extra-item-format-option-premium" id="nbtapi-extra-item-format-option-premium"></a>

The format of this option is:

```yaml
nbt:
  <NBT Type>:
    <NBT Key>: <NBT Value>
```

Supported NBT Type: '

* byte
* short
* int
* long
* float
* double
* string

For example:

```yaml
nbt:
  string: 
    customNBT: 'Hello!'
  int:
    anotherNBTComponent.theNBTKey: 5
```