Skip to content

Third-Party Integrations

ArcPass supports integration with many popular plugins to extend functionality.

Integration Overview

PluginFunctionFolia Support
VaultEconomy system
CMIEconomy (direct)
PlayerPointsPoints currency
CoinsEnginePoints currency
TokenManagerPoints currency
LuckPermsPermission rewards
PlaceholderAPIPlaceholder variables
DeluxeTagsTitle rewards
TABTitle rewards
NametagEditTitle rewards
PlayerTitleTitle rewards
PlayerParticlesCosmetic particle rewards
MythicMobsCustom mob quests
Jobs RebornJob quests
OraxenCustom item rewards
ItemsAdderCustom item rewards

Economy System

Vault

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
reward_gold_1000:
  type: ECONOMY
  display-name: "&6Gold x1000"
  value: "1000"

CMI

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.

Points System

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

PlayerPoints

PlayerPoints is the most popular points plugin.

Requirements:

  • PlayerPoints 2.0+

Uses:

  • Tier purchases (via currency-type: points)

CoinsEngine

CoinsEngine is a multi-currency economy plugin.

Requirements:

  • CoinsEngine 2.0+

TokenManager

TokenManager provides a token-based currency system.

Requirements:

  • TokenManager 3.0+

Points Priority

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

  1. PlayerPoints
  2. CoinsEngine
  3. TokenManager

Using Points for Tier Purchases

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

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

See Pass Configuration for details.

Permission System

LuckPerms

LuckPerms is the most popular permission plugin.

Requirements:

  • LuckPerms 5.4+

Features:

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

Examples:

yaml
# 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

Title System

DeluxeTags

DeluxeTags is a title management plugin.

WARNING

DeluxeTags does not support Folia. Use TAB instead on Folia servers.

Requirements:

  • DeluxeTags 1.8+
  • LuckPerms (recommended)

Example:

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

TAB

TAB is a Folia-compatible nametag/tablist plugin.

Requirements:

  • TAB 4.0+

Example:

yaml
reward_title_legend:
  type: TITLE
  display-name: "&dLegend Title"
  value: "&5[&dLegend&5] "
  data:
    position: prefix
    persistent: true

NametagEdit

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.

PlayerTitle

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
# 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
reward_temp_title:
  type: COMMAND
  display-name: "&eLimited Title (30 days)"
  value: "plt player setTitle %player% 5 30"

Title Priority

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

Cosmetic System

PlayerParticles

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
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

Quest Triggers

MythicMobs

MythicMobs allows custom mob kill quests.

Requirements:

  • MythicMobs 5.0+

Quest Config:

yaml
kill_dragon_boss:
  type: daily
  display-name: "&cSlay the Dragon"
  objectives:
    - type: mythicmobs_kill
      mob: DragonBoss
      amount: 1

Jobs Reborn

Jobs Reborn enables job experience quests.

Requirements:

  • Jobs Reborn 5.0+

Quest Config:

yaml
miner_exp_1000:
  type: weekly
  display-name: "&eMiner Experience"
  objectives:
    - type: jobs_exp
      job: Miner
      amount: 1000

Custom Items

Oraxen

Oraxen provides custom items and resource packs.

Requirements:

  • Oraxen 1.150+

Item Format:

oraxen:<item_id>

Example:

yaml
reward_custom_sword:
  type: ITEM
  display-name: "&6Legendary Sword"
  value: "oraxen:legendary_sword"
  amount: 1

ItemsAdder

ItemsAdder is another custom item plugin.

Requirements:

  • ItemsAdder 3.5+

Item Format:

itemsadder:<namespace>:<item_id>

Example:

yaml
reward_magic_gem:
  type: ITEM
  display-name: "&dMagic Gem"
  value: "itemsadder:myitems:magic_gem"
  amount: 5

PlaceholderAPI

PlaceholderAPI lets you use ArcPass data in other plugins.

Requirements:

  • PlaceholderAPI 2.11.0+

See PlaceholderAPI Documentation for full variable list.

Check Integration Status

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).

Troubleshooting

Economy Rewards Not Working

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

Title Rewards Not Working

  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

Cosmetic/Particle Rewards Not Working

  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

MythicMobs Quest Not Triggering

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

Custom Items Not Showing

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