# 🔗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
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://flipcard.superiormc.cn/info/compatibility.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.