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

# 系统要求

<span id="系统要求" />

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

<h2 id="最低要求">
  最低要求
</h2>

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

<h2 id="服务端兼容性">
  服务端兼容性
</h2>

<h3 id="完全支持">
  完全支持
</h3>

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

<h3 id="部分支持">
  部分支持
</h3>

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

<h3 id="不支持">
  不支持
</h3>

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

<h2 id="java-版本">
  Java 版本
</h2>

<h3 id="java-17-最低要求">
  Java 17 (最低要求)
</h3>

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

<h3 id="java-21-推荐">
  Java 21 (推荐)
</h3>

推荐使用 Java 21 LTS 版本：

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

<h3 id="检查-java-版本">
  检查 Java 版本
</h3>

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

<h2 id="依赖插件">
  依赖插件
</h2>

<h3 id="必需依赖">
  必需依赖
</h3>

无。ArcPass 可以独立运行。

<h3 id="可选依赖">
  可选依赖
</h3>

以下插件可增强 ArcPass 功能：

<h4 id="经济系统">
  经济系统
</h4>

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

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

<h4 id="权限系统">
  权限系统
</h4>

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

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

<h4 id="变量系统">
  变量系统
</h4>

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

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

<h4 id="称号系统">
  称号系统
</h4>

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

<Tip>
  如果您使用 Folia，请使用 TAB 替代 DeluxeTags。
</Tip>

<h4 id="任务触发器">
  任务触发器
</h4>

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

<h4 id="自定义物品">
  自定义物品
</h4>

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

<h2 id="数据库">
  数据库
</h2>

<h3 id="sqlite-默认">
  SQLite (默认)
</h3>

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

<h3 id="mysql">
  MySQL
</h3>

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

<h2 id="网络要求">
  网络要求
</h2>

<h3 id="许可证验证">
  许可证验证
</h3>

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

<h3 id="防火墙设置">
  防火墙设置
</h3>

确保服务器可以访问：

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

<h2 id="性能建议">
  性能建议
</h2>

<h3 id="小型服务器-50-玩家">
  小型服务器 (\< 50 玩家)
</h3>

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

<h3 id="中型服务器-50-200-玩家">
  中型服务器 (50-200 玩家)
</h3>

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

<h3 id="大型服务器-200-玩家">
  大型服务器 (200+ 玩家)
</h3>

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

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

<h2 id="下一步">
  下一步
</h2>

确认满足所有要求后：

<Columns cols={2}>
  <Card title="安装插件" icon="download" href="/arcpass/setup/installation">
    下载和安装指南
  </Card>

  <Card title="激活许可证" icon="key" href="/arcpass/setup/license">
    配置许可证密钥
  </Card>
</Columns>


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