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

# 系统要求

本页面列出运行 ArcPass 的所有系统要求和依赖关系。

## 最低要求

| 组件 | 最低要求 | 推荐配置 |
| - | - | - |
| Minecraft 版本 | 1.18 | 1.20+ |
| Java 版本 | 17 | 21 |
| 服务端 | Spigot | Paper / Folia |
| 内存 | 2GB | 4GB+ |
| 存储空间 | 50MB | 100MB+ |

## 服务端兼容性

### 完全支持

| 服务端 | 版本范围 | 备注 |
| - | - | - |
| Paper | 1.18 - 1.21+ | 推荐，性能最佳 |
| Folia | 1.20 - 1.21+ | 推荐大型服务器 |
| Purpur | 1.18 - 1.21+ | 基于 Paper |
| Spigot | 1.18 - 1.21+ | 标准支持 |

### 部分支持

| 服务端 | 备注 |
| - | - |
| Bukkit | 基本功能可用，部分高级功能受限 |
| 模组服（Forge/Fabric） | 不支持 |

### 不支持

* CraftBukkit
* 1.18 以下版本
* 基岩版服务端

## Java 版本

### Java 17 (最低要求)

ArcPass 使用 Java 17 特性编译，必须使用 Java 17 或更高版本。

### Java 21 (推荐)

推荐使用 Java 21 LTS 版本：

* 更好的性能
* 更低的内存占用
* 长期支持

### 检查 Java 版本

```bash theme={null}
java -version
```

预期输出：

```
openjdk version "21.0.1" 2023-10-17
OpenJDK Runtime Environment (build 21.0.1+12)
OpenJDK 64-Bit Server VM (build 21.0.1+12, mixed mode, sharing)
```

## 依赖插件

### 必需依赖

无。ArcPass 可以独立运行。

### 可选依赖

以下插件可增强 ArcPass 功能：

#### 经济系统

| 插件 | 版本 | 用途 |
| - | - | - |
| Vault | 1.7.3+ | 经济系统桥接 |
| CMI | 9.0+ | 直接经济支持 |

配置经济奖励、购买通行证等级时需要。

#### 权限系统

| 插件 | 版本 | 用途 |
| - | - | - |
| LuckPerms | 5.4+ | 权限奖励、称号前缀 |

配置权限奖励、权限组奖励时需要。

#### 变量系统

| 插件 | 版本 | 用途 |
| - | - | - |
| PlaceholderAPI | 2.11.0+ | 变量占位符支持 |

在计分板、聊天插件中显示 ArcPass 数据时需要。

#### 称号系统

| 插件 | 版本 | 用途 | Folia 支持 |
| - | - | - | - |
| DeluxeTags | 1.8+ | 称号奖励 | ❌ |
| TAB | 4.0+ | 称号奖励（替代） | ✅ |

> [!TIP]
>
> 如果您使用 Folia，请使用 TAB 替代 DeluxeTags。

#### 任务触发器

| 插件 | 版本 | 用途 |
| - | - | - |
| MythicMobs | 5.0+ | 自定义怪物击杀任务 |
| Jobs Reborn | 5.0+ | 职业经验任务 |

#### 自定义物品

| 插件 | 版本 | 用途 |
| - | - | - |
| Oraxen | 1.150+ | 自定义物品奖励 |
| ItemsAdder | 3.5+ | 自定义物品奖励 |

## 数据库

### SQLite (默认)

* 无需额外配置
* 适合小型服务器
* 数据存储在 `plugins/ArcPass/data.db`

### MySQL

* 推荐中大型服务器使用
* 支持多服务器共享数据
* 需要 MySQL 5.7+ 或 MariaDB 10.2+

## 网络要求

### 许可证验证

* 需要连接 `license.kitemc.com`
* 端口：443 (HTTPS)
* 首次验证后会缓存结果

### 防火墙设置

确保服务器可以访问：

```
license.kitemc.com:443
```

## 性能建议

### 小型服务器 (\< 50 玩家)

* 使用 SQLite 数据库
* 默认配置即可

### 中型服务器 (50-200 玩家)

* 使用 MySQL 数据库
* 适当增加缓存大小

### 大型服务器 (200+ 玩家)

* 使用 MySQL 数据库
* 考虑使用 Folia 服务端
* 优化数据库连接池

```yaml theme={null}
# database.yml
mysql:
  pool:
    maximum-pool-size: 10
    minimum-idle: 5
```

## 下一步

确认满足所有要求后：

> **[安装插件](https://www.kitemc.asia/arcpass/setup/installation.md)**
>
> 下载和安装指南

> **[激活许可证](https://www.kitemc.asia/arcpass/setup/license.md)**
>
> 配置许可证密钥


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