Configuration Overview
ArcPass uses a modular configuration design with different features configured in separate files.
File Structure
plugins/ArcPass/
├── config.yml # Main config
├── database.yml # Database config
├── license.yml # License config
├── lang/ # Language files
│ ├── en_US.yml
│ └── zh_CN.yml
├── passes/ # Pass configs
│ ├── default.yml
│ └── ...
├── quests/ # Quest configs
│ ├── daily/
│ ├── weekly/
│ └── seasonal/
├── rewards/ # Reward configs
│ └── default.yml
└── gui/ # GUI configs
├── main-menu.yml
├── quests.yml
└── rewards.ymlMain Configuration Files
config.yml
yaml
# ArcPass Main Configuration
# Debug mode
debug: false
# Language settings
language:
default: "en_US"
use-client-locale: true
# Data saving
data:
auto-save-interval: 5
save-on-quit: true
# Notifications
notifications:
level-up:
enabled: true
sound: "ENTITY_PLAYER_LEVELUP"
title: true
quest-complete:
enabled: true
sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
reward-available:
enabled: true
action-bar: truedatabase.yml
yaml
# Database Configuration
type: sqlite
sqlite:
file: "data.db"
mysql:
host: localhost
port: 3306
database: arcpass
username: root
password: ""
pool:
maximum-pool-size: 10
minimum-idle: 5
connection-timeout: 30000
idle-timeout: 600000
max-lifetime: 1800000Hot Reload
Most configurations support hot reload:
/arcpass admin reloadNote
These changes require a server restart:
- Database type switch
- License key change
Configuration Validation
ArcPass validates config files on load:
- Syntax errors shown in console
- Invalid values use defaults with warnings
- Missing required configs prevent startup
Detailed Guides
Pass Configuration
Tiers, levels, rewards
Quest Configuration
Quest types, objectives
Reward Configuration
Reward types, values
Season Configuration
Season timing, rules
GUI Configuration
Interface layout, items
Example Configurations
The docs/examples-en/ folder in the plugin directory contains complete configuration examples.