Skip to main content
本页面详细说明如何在不同服务端上安装 ArcPass。

支持的服务端

注意不支持 CraftBukkit 和低于 1.18 的版本。

安装步骤

  1. 下载插件

从以下渠道获取最新版本:

GitHub Releases

从 GitHub 下载

KiteMC 许可证平台

购买和下载

  1. 放置文件

将下载的 ArcPass-x.x.x.jar 文件放入服务器的 plugins 文件夹:

  1. 启动服务器

首次启动时,插件会:
  1. 检测服务端类型(Paper/Spigot/Folia)
  2. 生成默认配置文件
  3. 创建数据库(默认 SQLite)
  4. 等待许可证激活

  1. 查看启动日志

正常启动时,您会看到类似以下日志:

生成的文件结构

Folia 服务端特殊说明

ArcPass 完全支持 Folia 的区域化多线程架构:
  • 所有调度器调用使用 Folia 兼容 API
  • 数据库操作异步执行
  • GUI 操作在正确的区域线程执行
无需任何额外配置,插件会自动检测并适配 Folia。

故障排除

插件未加载

检查以下几点:
  1. 确认 JAR 文件名正确(不要重命名)
  2. 检查 Java 版本是否为 17+
  3. 查看控制台是否有错误信息

配置文件未生成

  1. 确认插件文件夹有写入权限
  2. 检查磁盘空间是否充足
  3. 尝试手动创建 plugins/ArcPass 文件夹

依赖插件问题

确保可选依赖插件版本兼容:

下一步

安装完成后,请继续:

激活许可证

配置许可证密钥

查看系统要求

查看完整要求