Third-Party Integrations
ArcPass supports integration with many popular plugins to extend functionality.
Integration Overview
| 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 | ✅ |
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:
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:
- PlayerPoints
- CoinsEngine
- 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:
tiers:
premium:
display-name: "&6Premium"
price: 980
currency-type: points # Use points plugin instead of Vault/CMISee 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:
# 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: groupTitle 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:
reward_title_champion:
type: TITLE
display-name: "&6Champion Title"
value: "&e[&6Champion&e] "
data:
tag-id: "champion"
priority: 100
auto-equip: trueTAB
TAB is a Folia-compatible nametag/tablist plugin.
Requirements:
- TAB 4.0+
Example:
reward_title_legend:
type: TITLE
display-name: "&dLegend Title"
value: "&5[&dLegend&5] "
data:
position: prefix
persistent: trueNametagEdit
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:
# 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:
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:
- DeluxeTags - If available and not Folia
- TAB - If available (Folia compatible)
- PlayerTitle - If available (API integration)
- NametagEdit - If available
- 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:
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: spiralCommon 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:
kill_dragon_boss:
type: daily
display-name: "&cSlay the Dragon"
objectives:
- type: mythicmobs_kill
mob: DragonBoss
amount: 1Jobs Reborn
Jobs Reborn enables job experience quests.
Requirements:
- Jobs Reborn 5.0+
Quest Config:
miner_exp_1000:
type: weekly
display-name: "&eMiner Experience"
objectives:
- type: jobs_exp
job: Miner
amount: 1000Custom Items
Oraxen
Oraxen provides custom items and resource packs.
Requirements:
- Oraxen 1.150+
Item Format:
oraxen:<item_id>Example:
reward_custom_sword:
type: ITEM
display-name: "&6Legendary Sword"
value: "oraxen:legendary_sword"
amount: 1ItemsAdder
ItemsAdder is another custom item plugin.
Requirements:
- ItemsAdder 3.5+
Item Format:
itemsadder:<namespace>:<item_id>Example:
reward_magic_gem:
type: ITEM
display-name: "&dMagic Gem"
value: "itemsadder:myitems:magic_gem"
amount: 5PlaceholderAPI
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
- Confirm Vault or CMI is installed
- Confirm economy plugin works
- Test:
/eco give <player> 100
Title Rewards Not Working
- Confirm a title plugin is installed (DeluxeTags, TAB, PlayerTitle, or NametagEdit)
- Use TAB on Folia
- For PlayerTitle: ensure the title ID exists in PlayerTitle
- Check LuckPerms configuration as fallback
Cosmetic/Particle Rewards Not Working
- Confirm PlayerParticles is installed (8.0+)
- Check the
data.particlevalue matches a valid PlayerParticles effect name - Check the
data.stylevalue matches a valid PlayerParticles style name - Ensure the player is online when claiming the reward
MythicMobs Quest Not Triggering
- Confirm compatible version
- Check mob ID (case-sensitive)
- Ensure player is the killer
Custom Items Not Showing
- Confirm compatible plugin version
- Check item ID format
- Ensure item exists in the plugin