> ## Documentation Index
> Fetch the complete documentation index at: https://www.kitemc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Third-Party Integrations

<span id="third-party-integrations" />

ArcPass supports integration with many popular plugins to extend functionality.

<h2 id="integration-overview">
  Integration Overview
</h2>

| Plugin | Function | Folia Support |
| - | - | - |
| Vault | Economy system | ✅ |
| CMI | Economy (direct) | ✅ |
| PlayerPoints | Points currency | ✅ |
| CoinsEngine | Points currency | ✅ |
| TokenManager | Points currency | ✅ |
| LuckPerms | Permission rewards | ✅ |
| PlaceholderAPI | Placeholder variables | ✅ |
| DeluxeTags | Title rewards | ❌ |
| TAB | Title rewards | ✅ |
| NametagEdit | Title rewards | ❌ |
| PlayerTitle | Title rewards | ✅ |
| PlayerParticles | Cosmetic particle rewards | ✅ |
| MythicMobs | Custom mob quests | ✅ |
| Jobs Reborn | Job quests | ✅ |
| Oraxen | Custom item rewards | ✅ |
| ItemsAdder | Custom item rewards | ✅ |

<h2 id="economy-system">
  Economy System
</h2>

<h3 id="vault">
  Vault
</h3>

Vault is the most common economy bridge plugin.

**Requirements:**

* Vault 1.7.3+
* Any Vault-compatible economy plugin (e.g., EssentialsX)

**Uses:**

* Economy rewards
* Tier purchases

**Example:**

```yaml theme={null}
reward_gold_1000:
  type: ECONOMY
  display-name: "&6Gold x1000"
  value: "1000"
```

<h3 id="cmi">
  CMI
</h3>

CMI is a comprehensive server management plugin. ArcPass supports CMI economy directly.

**Requirements:**

* CMI 9.0+

CMI economy takes priority over Vault when both are installed.

<h2 id="points-system">
  Points System
</h2>

ArcPass supports points/voucher plugins as an alternative currency for tier purchases.

<h3 id="playerpoints">
  PlayerPoints
</h3>

PlayerPoints is the most popular points plugin.

**Requirements:**

* PlayerPoints 2.0+

**Uses:**

* Tier purchases (via `currency-type: points`)

<h3 id="coinsengine">
  CoinsEngine
</h3>

CoinsEngine is a multi-currency economy plugin.

**Requirements:**

* CoinsEngine 2.0+

<h3 id="tokenmanager">
  TokenManager
</h3>

TokenManager provides a token-based currency system.

**Requirements:**

* TokenManager 3.0+

<h3 id="points-priority">
  Points Priority
</h3>

When multiple points plugins are installed, ArcPass uses the first available:

1. **PlayerPoints**
2. **CoinsEngine**
3. **TokenManager**

<h3 id="using-points-for-tier-purchases">
  Using Points for Tier Purchases
</h3>

To use points instead of Vault/CMI economy for a tier, set `currency-type: points` in the pass configuration:

```yaml theme={null}
tiers:
  premium:
    display-name: "&6Premium"
    price: 980
    currency-type: points  # Use points plugin instead of Vault/CMI
```

See [Pass Configuration](/en/arcpass/config/passes) for details.

<h2 id="permission-system">
  Permission System
</h2>

<h3 id="luckperms">
  LuckPerms
</h3>

LuckPerms is the most popular permission plugin.

**Requirements:**

* LuckPerms 5.4+

**Features:**

* Permission rewards
* Group rewards
* Prefix/suffix
* Temporary permissions

**Examples:**

```yaml theme={null}
# Permanent permission
reward_fly:
  type: PERMISSION
  display-name: "&bFlight"
  value: "essentials.fly"

# Temporary (7 days)
reward_temp_vip:
  type: PERMISSION
  display-name: "&e7-Day VIP"
  value: "group.vip"
  data:
    duration: 604800

# Group
reward_rank_elite:
  type: PERMISSION
  display-name: "&6Elite Rank"
  value: "group.elite"
  data:
    type: group
```

<h2 id="title-system">
  Title System
</h2>

<h3 id="deluxetags">
  DeluxeTags
</h3>

DeluxeTags is a title management plugin.

<Warning>
  DeluxeTags does not support Folia. Use TAB instead on Folia servers.
</Warning>

**Requirements:**

* DeluxeTags 1.8+
* LuckPerms (recommended)

**Example:**

```yaml theme={null}
reward_title_champion:
  type: TITLE
  display-name: "&6Champion Title"
  value: "&e[&6Champion&e] "
  data:
    tag-id: "champion"
    priority: 100
    auto-equip: true
```

<h3 id="tab">
  TAB
</h3>

TAB is a Folia-compatible nametag/tablist plugin.

**Requirements:**

* TAB 4.0+

**Example:**

```yaml theme={null}
reward_title_legend:
  type: TITLE
  display-name: "&dLegend Title"
  value: "&5[&dLegend&5] "
  data:
    position: prefix
    persistent: true
```

<h3 id="nametagedit">
  NametagEdit
</h3>

NametagEdit is a nametag editing plugin.

**Requirements:**

* NametagEdit 4.0+

NametagEdit sets titles as player nametag prefixes. It is used as a fallback when other title plugins are not available.

<h3 id="playertitle">
  PlayerTitle
</h3>

PlayerTitle is a popular title plugin with built-in particle effects, buff system, and GUI management.

**Requirements:**

* PlayerTitle 4.0+

ArcPass integrates with PlayerTitle via its developer API. Titles must be pre-created in PlayerTitle, then referenced by their integer ID in the reward config.

**Example:**

```yaml theme={null}
# Using data.title-id to specify PlayerTitle's integer ID
reward_arena_champion:
  type: TITLE
  display-name: "&6Arena Champion"
  value: "&e[&6Champion&e] "
  data:
    title-id: 5  # PlayerTitle's title ID

# Or embed the ID in the reward key
title_5:
  type: TITLE
  display-name: "&6Arena Champion"
  value: "&e[&6Champion&e] "
```

<Tip>
  For time-limited titles via PlayerTitle, use a COMMAND reward type:

  ```yaml theme={null}
  reward_temp_title:
    type: COMMAND
    display-name: "&eLimited Title (30 days)"
    value: "plt player setTitle %player% 5 30"
  ```
</Tip>

<h3 id="title-priority">
  Title Priority
</h3>

ArcPass tries to grant titles in this order:

1. **DeluxeTags** - If available and not Folia
2. **TAB** - If available (Folia compatible)
3. **PlayerTitle** - If available (API integration)
4. **NametagEdit** - If available
5. **LuckPerms** - As prefix/suffix fallback

<h2 id="cosmetic-system">
  Cosmetic System
</h2>

<h3 id="playerparticles">
  PlayerParticles
</h3>

PlayerParticles is the most popular cosmetic particle plugin, offering 118+ particle effects and 38 styles.

**Requirements:**

* PlayerParticles 8.0+

ArcPass integrates with PlayerParticles via its developer API. When a COSMETIC reward with `data.particle` is claimed, the particle effect is automatically applied to the player.

**Example:**

```yaml theme={null}
cosmetic_particle_flame:
  type: COSMETIC
  display-name: "&cFlame Particle Effect"
  description: "Unlock flame particle effect"
  icon: BLAZE_POWDER
  value: "particle_flame"
  data:
    particle: FLAME       # PlayerParticles effect name
    style: trail          # PlayerParticles style name

cosmetic_particle_enchant:
  type: COSMETIC
  display-name: "&5Enchant Particle Effect"
  icon: ENCHANTED_BOOK
  value: "particle_enchant"
  data:
    particle: ENCHANT
    style: spiral
```

**Common particle effects:** `FLAME`, `END_ROD`, `ENCHANT`, `TOTEM_OF_UNDYING`, `HEART`, `CRIT`, `SPELL_WITCH`, `DRIP_LAVA`

**Common styles:** `normal`, `spiral`, `trail`, `aura`, `burst`, `orbit`, `pulse`

<h2 id="quest-triggers">
  Quest Triggers
</h2>

<h3 id="mythicmobs">
  MythicMobs
</h3>

MythicMobs allows custom mob kill quests.

**Requirements:**

* MythicMobs 5.0+

**Quest Config:**

```yaml theme={null}
kill_dragon_boss:
  type: daily
  display-name: "&cSlay the Dragon"
  objectives:
    - type: mythicmobs_kill
      mob: DragonBoss
      amount: 1
```

<h3 id="jobs-reborn">
  Jobs Reborn
</h3>

Jobs Reborn enables job experience quests.

**Requirements:**

* Jobs Reborn 5.0+

**Quest Config:**

```yaml theme={null}
miner_exp_1000:
  type: weekly
  display-name: "&eMiner Experience"
  objectives:
    - type: jobs_exp
      job: Miner
      amount: 1000
```

<h2 id="custom-items">
  Custom Items
</h2>

<h3 id="oraxen">
  Oraxen
</h3>

Oraxen provides custom items and resource packs.

**Requirements:**

* Oraxen 1.150+

**Item Format:**

```
oraxen:<item_id>
```

**Example:**

```yaml theme={null}
reward_custom_sword:
  type: ITEM
  display-name: "&6Legendary Sword"
  value: "oraxen:legendary_sword"
  amount: 1
```

<h3 id="itemsadder">
  ItemsAdder
</h3>

ItemsAdder is another custom item plugin.

**Requirements:**

* ItemsAdder 3.5+

**Item Format:**

```
itemsadder:<namespace>:<item_id>
```

**Example:**

```yaml theme={null}
reward_magic_gem:
  type: ITEM
  display-name: "&dMagic Gem"
  value: "itemsadder:myitems:magic_gem"
  amount: 5
```

<h2 id="placeholderapi">
  PlaceholderAPI
</h2>

PlaceholderAPI lets you use ArcPass data in other plugins.

**Requirements:**

* PlaceholderAPI 2.11.0+

See [PlaceholderAPI Documentation](/en/arcpass/placeholders) for full variable list.

<h2 id="check-integration-status">
  Check Integration Status
</h2>

On startup, console shows integration status:

```
[ArcPass] Vault economy hook enabled.
[ArcPass] PlayerPoints hook enabled.
[ArcPass] LuckPerms permission hook enabled.
[ArcPass] PlaceholderAPI expansion registered.
[ArcPass] TAB integration enabled!
[ArcPass] MythicMobs integration enabled!
[ArcPass] Jobs Reborn integration enabled!
[ArcPass] Oraxen integration enabled!
[ArcPass] ItemsAdder integration enabled!
[ArcPass] PlayerTitle hook enabled (API mode).
[ArcPass] PlayerParticles hook enabled (API mode).
```

<h2 id="troubleshooting">
  Troubleshooting
</h2>

<h3 id="economy-rewards-not-working">
  Economy Rewards Not Working
</h3>

1. Confirm Vault or CMI is installed
2. Confirm economy plugin works
3. Test: `/eco give <player> 100`

<h3 id="title-rewards-not-working">
  Title Rewards Not Working
</h3>

1. Confirm a title plugin is installed (DeluxeTags, TAB, PlayerTitle, or NametagEdit)
2. Use TAB on Folia
3. For PlayerTitle: ensure the title ID exists in PlayerTitle
4. Check LuckPerms configuration as fallback

<h3 id="cosmetic-particle-rewards-not-working">
  Cosmetic/Particle Rewards Not Working
</h3>

1. Confirm PlayerParticles is installed (8.0+)
2. Check the `data.particle` value matches a valid PlayerParticles effect name
3. Check the `data.style` value matches a valid PlayerParticles style name
4. Ensure the player is online when claiming the reward

<h3 id="mythicmobs-quest-not-triggering">
  MythicMobs Quest Not Triggering
</h3>

1. Confirm compatible version
2. Check mob ID (case-sensitive)
3. Ensure player is the killer

<h3 id="custom-items-not-showing">
  Custom Items Not Showing
</h3>

1. Confirm compatible plugin version
2. Check item ID format
3. Ensure item exists in the plugin


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.