Getting Started

This guide will help you install and configure ArcPass in under 5 minutes.

Prerequisites

Before starting, ensure your server meets these requirements:

Requirement	Minimum Version
Minecraft Server	Paper 1.18+ / Spigot 1.18+ / Folia 1.20+
Java	17 or higher
License	Valid ArcPass license key

Optional Dependencies

Plugin	Purpose
Vault	Economy system support
PlaceholderAPI	Placeholder variables
LuckPerms	Permission rewards

Step 1: Install the Plugin

Download the latest ArcPass-x.x.x.jar from the download page
Place the JAR file in your server’s plugins folder
Restart the server

On first startup, the plugin generates default configuration files:

plugins/ArcPass/
├── config.yml          # Main configuration
├── database.yml        # Database settings
├── license.yml         # License configuration
├── lang/               # Language files
├── passes/             # Pass configurations
├── quests/             # Quest configurations
├── rewards/            # Reward definitions
└── gui/                # GUI configurations

Step 2: Activate License

Edit plugins/ArcPass/license.yml:

# License key (obtained from KiteMC after purchase)
license-key: "YOUR-LICENSE-KEY-HERE"

# Show license status messages
show-status: true

Save the file and run /arcpass admin reload or restart the server.

How to get a license?Visit KiteMC License Center to purchase a license. After purchase, you can view your key on the License Management Page.

Step 3: Basic Configuration

3.1 Language Setting

Edit config.yml to set the default language:

locale:
  # Default language for new players
  default: zh_CN
  # Allow players to change their language
  allow-change: true

3.2 Database Configuration

Default uses SQLite, no additional setup needed. For MySQL:

# database.yml
type: mysql
mysql:
  host: localhost
  port: 3306
  database: arcpass
  username: root
  password: your_password

Step 4: Start a Season

ArcPass requires an active season to function properly.

Option 1: Using Commands

/arcpass admin season start Season1

Option 2: Using Admin GUI

Run /arcpass admin to open admin panel
Click “Start Season” button
Enter season name in chat
Confirm to start

Step 5: Test Features

Now you can test ArcPass basic features:

Command	Description
`/arcpass`	Open main pass interface
`/arcpass quests`	View current quests
`/arcpass level`	View level and experience
`/arcpass admin`	Open admin panel (requires permission)

Next Steps

Congratulations! You’ve completed the basic ArcPass setup. Next you can:

Configure Pass Tiers and Rewards

Customize pass tiers and level rewards

Set Up Quest System

Configure daily, weekly, and seasonal quests

Customize GUI Interface

Beautify your pass interface

Integrate Third-Party Plugins

Connect Vault, LuckPerms, and more

Need Help?

FAQ

Check FAQ for common issues

Discord Community

Join our community for support

Getting started

Setup guide

Configuration

Usage

Developer API

Help

Getting Started

Prerequisites

Optional Dependencies

Step 1: Install the Plugin

Step 2: Activate License

Step 3: Basic Configuration

3.1 Language Setting

3.2 Database Configuration

Step 4: Start a Season

Option 1: Using Commands

Option 2: Using Admin GUI

Step 5: Test Features

Next Steps

Configure Pass Tiers and Rewards

Set Up Quest System

Customize GUI Interface

Integrate Third-Party Plugins

Need Help?

FAQ

Discord Community

​Prerequisites

​Optional Dependencies

​Step 1: Install the Plugin

​Step 2: Activate License

​Step 3: Basic Configuration

​3.1 Language Setting

​3.2 Database Configuration

​Step 4: Start a Season

​Option 1: Using Commands

​Option 2: Using Admin GUI

​Step 5: Test Features

​Next Steps

Configure Pass Tiers and Rewards

Set Up Quest System

Customize GUI Interface

Integrate Third-Party Plugins

​Need Help?

FAQ

Discord Community

Prerequisites

Optional Dependencies

Step 1: Install the Plugin

Step 2: Activate License

Step 3: Basic Configuration

3.1 Language Setting

3.2 Database Configuration

Step 4: Start a Season

Option 1: Using Commands

Option 2: Using Admin GUI

Step 5: Test Features

Next Steps

Need Help?