Skip to main content
ArcPass 支持与多种流行插件集成，扩展功能和玩法。

​
集成概览

​
经济系统

​
Vault

Vault 是最常用的经济系统桥接插件。 安装要求：
  • Vault 1.7.3+
  • 任意 Vault 兼容的经济插件（如 EssentialsX）
用途：
  • 经济奖励（给予金币）
  • 购买通行证档位
配置示例：

​
CMI

CMI 是一款功能全面的服务器管理插件，ArcPass 支持直接使用 CMI 经济。 安装要求：
  • CMI 9.0+
CMI 经济优先于 Vault，如果同时安装，将使用 CMI。

​
点卷系统

ArcPass 支持多款点卷插件作为替代货币，用于购买通行证档位。

​
PlayerPoints

PlayerPoints 是最流行的点卷插件。 安装要求：
  • PlayerPoints 2.0+
用途：
  • 购买通行证档位（通过 currency-type: points 配置）

​
CoinsEngine

CoinsEngine 是一款多币种经济插件。 安装要求：
  • CoinsEngine 2.0+

​
TokenManager

TokenManager 提供基于 Token 的货币系统。 安装要求：
  • TokenManager 3.0+

​
点卷优先级

当同时安装多个点卷插件时，ArcPass 按以下顺序使用第一个可用的：
  1. PlayerPoints
  2. CoinsEngine
  3. TokenManager

​
使用点卷购买档位

在通行证配置中，将 currency-type 设置为 points 即可使用点卷替代 Vault/CMI 经济：
详见 通行证配置。

​
权限系统

​
LuckPerms

LuckPerms 是最流行的权限管理插件。 安装要求：
  • LuckPerms 5.4+
功能：
  • 权限奖励
  • 权限组奖励
  • 前缀/后缀设置
  • 临时权限
配置示例：

​
称号系统

​
DeluxeTags

DeluxeTags 是一款称号管理插件。
DeluxeTags 不支持 Folia。如果您使用 Folia 服务端，请使用 TAB 替代。
安装要求：
  • DeluxeTags 1.8+
  • LuckPerms（推荐）
配置示例：

​
TAB

TAB 是一款支持 Folia 的名牌/Tab 列表管理插件。 安装要求：
  • TAB 4.0+
配置示例：

​
NametagEdit

NametagEdit 是一款名牌编辑插件。 安装要求：
  • NametagEdit 4.0+
NametagEdit 将称号设置为玩家名牌前缀。当其他称号插件不可用时作为回退方案。

​
PlayerTitle

PlayerTitle 是一款功能丰富的称号插件，支持粒子特效、属性 Buff 和 GUI 管理。 安装要求：
  • PlayerTitle 4.0+
ArcPass 通过 PlayerTitle 的开发者 API 进行集成。称号需要先在 PlayerTitle 中创建，然后在奖励配置中引用其整型 ID。 配置示例：
如需通过 PlayerTitle 发放限时称号，可使用 COMMAND 奖励类型：

​
称号优先级

ArcPass 按以下顺序尝试发放称号奖励：
  1. DeluxeTags - 如果可用且非 Folia
  2. TAB - 如果可用（支持 Folia）
  3. PlayerTitle - 如果可用（API 集成）
  4. NametagEdit - 如果可用
  5. LuckPerms - 作为前缀/后缀回退

​
装饰系统

​
PlayerParticles

PlayerParticles 是最流行的装饰粒子插件，提供 118+ 种粒子效果和 38 种样式。 安装要求：
  • PlayerParticles 8.0+
ArcPass 通过 PlayerParticles 的开发者 API 进行集成。当玩家领取带有 data.particle 的 COSMETIC 奖励时，粒子效果会自动应用到玩家身上。 配置示例：
常用粒子效果： FLAME、END_ROD、ENCHANT、TOTEM_OF_UNDYING、HEART、CRIT、SPELL_WITCH、DRIP_LAVA 常用样式： normal、spiral、trail、aura、burst、orbit、pulse

​
任务触发器

​
MythicMobs

MythicMobs 是一款自定义怪物插件，可创建击杀 MythicMobs 怪物的任务。 安装要求：
  • MythicMobs 5.0+
任务配置：
也可以使用通用格式：

​
Jobs Reborn

Jobs Reborn 是一款职业系统插件。 安装要求：
  • Jobs Reborn 5.0+
任务配置：

​
自定义物品

​
Oraxen

Oraxen 是一款自定义物品和资源包插件。 安装要求：
  • Oraxen 1.150+
物品格式：
配置示例：

​
ItemsAdder

ItemsAdder 是另一款自定义物品插件。 安装要求：
  • ItemsAdder 3.5+
物品格式：
配置示例：

​
PlaceholderAPI

PlaceholderAPI 让您可以在其他插件中使用 ArcPass 的数据。 安装要求：
  • PlaceholderAPI 2.11.0+
详细的变量列表请查看 PlaceholderAPI 文档。

​
检测集成状态

启动服务器后，查看控制台日志确认集成状态：

​
故障排除

​
经济奖励不生效

  1. 确认 Vault 和经济插件已安装
  2. 检查经济插件是否正常工作
  3. 查看控制台是否有错误信息

​
称号奖励不生效

  1. 确认称号插件已安装（DeluxeTags、TAB、PlayerTitle 或 NametagEdit）
  2. 对于 Folia，必须使用 TAB
  3. 使用 PlayerTitle 时，确保称号 ID 在 PlayerTitle 中已存在
  4. LuckPerms 可作为最终回退方案

​
装饰/粒子奖励不生效

  1. 确认 PlayerParticles 已安装（8.0+）
  2. 检查 data.particle 值是否与 PlayerParticles 的效果名称匹配
  3. 检查 data.style 值是否与 PlayerParticles 的样式名称匹配
  4. 确保玩家在领取奖励时在线

​
MythicMobs 任务不触发

  1. 确认 MythicMobs 版本兼容
  2. 检查怪物 ID 是否正确（区分大小写）
  3. 确保玩家是击杀者

​
自定义物品不显示

  1. 确认 Oraxen/ItemsAdder 版本兼容
  2. 检查物品 ID 格式是否正确
  3. 确保物品在对应插件中已定义