> ## 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.

# System Requirements

<span id="system-requirements" />

This page lists all requirements and dependencies for running ArcPass.

<h2 id="minimum-requirements">
  Minimum Requirements
</h2>

| Component | Minimum | Recommended |
| - | - | - |
| Minecraft Version | 1.18 | 1.20+ |
| Java Version | 17 | 21 |
| Server Software | Spigot | Paper / Folia |
| RAM | 2GB | 4GB+ |
| Storage | 50MB | 100MB+ |

<h2 id="server-compatibility">
  Server Compatibility
</h2>

<h3 id="fully-supported">
  Fully Supported
</h3>

| Server | Version Range | Notes |
| - | - | - |
| Paper | 1.18 - 1.21+ | Recommended, best performance |
| Folia | 1.20 - 1.21+ | Recommended for large servers |
| Purpur | 1.18 - 1.21+ | Paper-based |
| Spigot | 1.18 - 1.21+ | Standard support |

<h3 id="partial-support">
  Partial Support
</h3>

| Server | Notes |
| - | - |
| Bukkit | Basic features work, some advanced features limited |
| Modded (Forge/Fabric) | Not supported |

<h3 id="not-supported">
  Not Supported
</h3>

* CraftBukkit
* Versions below 1.18
* Bedrock servers

<h2 id="java-version">
  Java Version
</h2>

<h3 id="java-17-minimum">
  Java 17 (Minimum)
</h3>

ArcPass is compiled with Java 17 features. Java 17+ is required.

<h3 id="java-21-recommended">
  Java 21 (Recommended)
</h3>

We recommend Java 21 LTS:

* Better performance
* Lower memory usage
* Long-term support

<h3 id="check-java-version">
  Check Java Version
</h3>

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

Expected output:

```
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="plugin-dependencies">
  Plugin Dependencies
</h2>

<h3 id="required">
  Required
</h3>

None. ArcPass can run standalone.

<h3 id="optional-dependencies">
  Optional Dependencies
</h3>

These plugins enhance ArcPass functionality:

<h4 id="economy">
  Economy
</h4>

| Plugin | Version | Purpose |
| - | - | - |
| Vault | 1.7.3+ | Economy bridge |
| CMI | 9.0+ | Direct economy support |

Required for economy rewards and tier purchases.

<h4 id="permissions">
  Permissions
</h4>

| Plugin | Version | Purpose |
| - | - | - |
| LuckPerms | 5.4+ | Permission rewards, prefix/suffix |

Required for permission and group rewards.

<h4 id="placeholders">
  Placeholders
</h4>

| Plugin | Version | Purpose |
| - | - | - |
| PlaceholderAPI | 2.11.0+ | Placeholder variables |

Required for displaying ArcPass data in scoreboards, chat plugins, etc.

<h4 id="title-systems">
  Title Systems
</h4>

| Plugin | Version | Purpose | Folia |
| - | - | - | - |
| DeluxeTags | 1.8+ | Title rewards | ❌ |
| TAB | 4.0+ | Title rewards (alternative) | ✅ |

<Tip>
  Use TAB instead of DeluxeTags if running Folia.
</Tip>

<h4 id="quest-triggers">
  Quest Triggers
</h4>

| Plugin | Version | Purpose |
| - | - | - |
| MythicMobs | 5.0+ | Custom mob kill quests |
| Jobs Reborn | 5.0+ | Job experience quests |

<h4 id="custom-items">
  Custom Items
</h4>

| Plugin | Version | Purpose |
| - | - | - |
| Oraxen | 1.150+ | Custom item rewards |
| ItemsAdder | 3.5+ | Custom item rewards |

<h2 id="database">
  Database
</h2>

<h3 id="sqlite-default">
  SQLite (Default)
</h3>

* No additional setup
* Suitable for small servers
* Data stored in `plugins/ArcPass/data.db`

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

* Recommended for medium/large servers
* Supports multi-server data sharing
* Requires MySQL 5.7+ or MariaDB 10.2+

<h2 id="network-requirements">
  Network Requirements
</h2>

<h3 id="license-validation">
  License Validation
</h3>

* Connects to `license.kitemc.com`
* Port: 443 (HTTPS)
* Results cached after initial validation

<h3 id="firewall-settings">
  Firewall Settings
</h3>

Ensure server can access:

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

<h2 id="performance-recommendations">
  Performance Recommendations
</h2>

<h3 id="small-servers-50-players">
  Small Servers (\< 50 players)
</h3>

* Use SQLite database
* Default configuration is fine

<h3 id="medium-servers-50-200-players">
  Medium Servers (50-200 players)
</h3>

* Use MySQL database
* Increase cache sizes

<h3 id="large-servers-200-players">
  Large Servers (200+ players)
</h3>

* Use MySQL database
* Consider Folia server
* Optimize connection pool

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

<h2 id="next-steps">
  Next Steps
</h2>

After confirming requirements:

<Columns cols={2}>
  <Card title="Install Plugin" icon="download" href="/en/arcpass/setup/installation">
    Download and install guide
  </Card>

  <Card title="Activate License" icon="key" href="/en/arcpass/setup/license">
    Configure license key
  </Card>
</Columns>


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