配置概述

ArcPass 采用模块化配置设计，不同功能的配置分散在多个文件中，便于管理和维护。

配置文件结构

plugins/ArcPass/
├── config.yml          # 主配置
├── database.yml        # 数据库配置
├── license.yml         # 许可证配置
├── lang/               # 语言文件
│   ├── en_US.yml
│   └── zh_CN.yml
├── passes/             # 通行证配置
│   ├── default.yml
│   └── ...
├── quests/             # 任务配置
│   ├── daily/          # 日常任务
│   ├── weekly/         # 周常任务
│   └── seasonal/       # 赛季任务
├── rewards/            # 奖励配置
│   └── default.yml
└── gui/                # GUI 配置
    ├── main-menu.yml
    ├── quests.yml
    └── rewards.yml

主配置文件

config.yml

yaml

# 配置版本（请勿修改）
config-version: 2

# 调试模式 - 启用详细日志输出
debug: false

# 语言设置
locale:
  # 新玩家的默认语言
  default: zh_CN
  # 是否允许玩家更改语言
  allow-change: true

# 通行证设置
pass:
  # 最高等级（建议 1-100）
  max-level: 100
  # 1 级所需的基础经验值
  base-experience: 100
  # 每级经验倍率（1.1 = 每级增加 10%）
  experience-multiplier: 1.1

# 任务设置
quests:
  # 日常任务重置时间（24 小时制，服务器时区）
  daily-reset-hour: 4
  # 周常任务重置日（1=周一，7=周日）
  weekly-reset-day: 1

# 通知设置
notifications:
  # 升级时通知玩家
  level-up: true
  # 完成任务时通知玩家
  quest-complete: true
  # 有可领取奖励时通知玩家
  rewards-available: true
  # 音效
  sounds:
    level-up: ENTITY_PLAYER_LEVELUP
    quest-complete: ENTITY_EXPERIENCE_ORB_PICKUP
    reward-claim: BLOCK_NOTE_BLOCK_PLING

# GUI 设置
gui:
  # 动画元素更新间隔（tick）
  update-interval: 20
  # 点击外部区域时关闭 GUI
  close-on-outside-click: true

# 性能设置
performance:
  # 数据保存间隔（秒）
  save-interval: 300
  # 缓存过期时间（分钟）
  cache-expiry: 30

database.yml

yaml

# 配置版本（请勿修改）
config-version: 2

# 数据库类型：sqlite 或 mysql
type: sqlite

# SQLite 设置（当 type 为 sqlite 时使用）
sqlite:
  # 数据库文件名（在插件文件夹内）
  file: data.db

# MySQL 设置（当 type 为 mysql 时使用）
mysql:
  host: localhost
  port: 3306
  database: arcpass
  username: root
  password: ""
  # 连接池大小
  pool-size: 10
  # 额外连接属性
  properties:
    useSSL: false
    autoReconnect: true
    allowPublicKeyRetrieval: true

# 跨服（网络）设置
network:
  # standalone | shared-db | redis
  mode: standalone
  server-id: "server-1"
  redis:
    host: localhost
    port: 6379
    password: ""
    database: 0
    pool-size: 8
    cache-ttl: 10
    migration-lock-timeout: 5000
  sync:
    quit-save-mode: blocking
    join-lock-wait: 3000