📖 插件简介

PaiAchievement 是一款功能完整的成就系统插件，为您的服务器打造专业的玩家激励体系。支持MySQL和本地存储、PlaceholderAPI集成、链式成就设计，让玩家在游戏中获得更多成就感。

✨ 核心特色

• 🏆 完整成就系统 - 7大分类，60+预设成就，无限扩展
• 📊 等级进阶系统 - 5个等级，积分升级，解锁高级成就
• 🔗 链式成就设计 - 前置要求，成就之间环环相扣
• 🎨 精美GUI界面 - 分类切换，进度显示，状态识别
• 💾 双存储方案 - MySQL跨服同步/YAML本地存储
• ⚡ 灵活追踪系统 - 内置计数器/PlaceholderAPI变量/混合模式

🏆 成就分类系统

⌨️ 指令系统

玩家命令

管理员命令

🔌 PlaceholderAPI 变量

%paiachievement_level% - 玩家等级
%paiachievement_level_title% - 等级称号
%paiachievement_points% - 当前积分
%paiachievement_points_to_next% - 距离下一等级积分
%paiachievement_completed% - 已完成成就数
%paiachievement_total% - 总成就数
%paiachievement_completed_percent% - 完成百分比
%paiachievement_in_progress% - 进行中成就数
%paiachievement_category_completed_<分类>% - 分类完成数
%paiachievement_has_achievement_<ID>% - 是否拥有成就

⚙️ 配置示例

主配置文件 (config.yml)

database:
  type: "YAML"  # 或 "MYSQL"
  mysql:
    host: "localhost"
    port: 3306
    database: "minecraft"
    username: "root"
    password: "password"
    pool-size: 10

particles:
  enabled: true
  level-up:
    type: "FIREWORKS_SPARK"
    count: 100
    style: "EXPLOSION"
  achievement-unlock:
    type: "VILLAGER_HAPPY"
    count: 50
    style: "CIRCLE"

messages:
  prefix: "&7[&6成就&7] "
  achievement-unlocked: "&a恭喜！你完成了成就: &e{name}"
  level-up: "&6等级提升！你现在是 &e{title} &6了！"

成就配置示例 (achievements.yml)

achievements:
  basic_first_login:
    category: "basic"
    name: "&a首次登录"
    description:
      - "&7欢迎来到服务器！"
      - "&e这是你冒险的开始"
    icon:
      material: "COMPASS"
      glow: true
    required-level: 1
    prerequisites: []
    points: 5
    tracking:
      type: "COUNTER"
      counter:
        target: 1
        current-key: "first_login"
    rewards:
      commands:
        - "give {player} diamond 1"
      messages:
        - "&a欢迎加入服务器！"
      particle:
        enabled: true
        type: "VILLAGER_HAPPY"
        count: 30
        style: "CIRCLE"

  combat_kill_100:
    category: "combat"
    name: "&c百人斩"
    description:
      - "&7击杀100个怪物"
      - "&e成为真正的战士"
    icon:
      material: "DIAMOND_SWORD"
      glow: true
    required-level: 1
    prerequisites: ["combat_first_kill"]
    points: 20
    tracking:
      type: "COUNTER"
      counter:
        target: 100
        current-key: "mob_kills"
    rewards:
      commands:
        - "give {player} diamond_sword 1"
      particle:
        enabled: true
        type: "FLAME"
        count: 50
        style: "SPIRAL"

🎯 三种追踪模式

1. 内置计数器 (COUNTER)

通过命令添加进度，适配任何插件：

/achievementadmin progress add {player} dungeon_clear 1

2. PlaceholderAPI变量 (PLACEHOLDER)

自动检测变量值变化：

tracking:
  type: "PLACEHOLDER"
  placeholder:
    variable: "%player_level%"
    check-interval: 60
    target: 50

3. 混合模式 (MIXED)

同时使用计数器和变量：

tracking:
  type: "MIXED"
  counter:
    target: 1000000
    current-key: "total_earned"
  placeholder:
    variable: "%vault_eco_balance%"
    check-interval: 120
    target: 1000000

📥 安装方法

1. 下载 PaiAchievement-1.0.0.jar 和依赖 PaiDaXingPlugins-1.2.2+.jar
2. 将两个jar文件放入服务器 plugins 文件夹
3. （可选）安装 PlaceholderAPI 插件以支持变量追踪
4. （可选）安装 Vault 和经济插件以支持经济类成就
5. 重启服务器（会自动生成配置文件）
6. 编辑 plugins/PaiAchievement/config.yml 配置数据库
7. 编辑 plugins/PaiAchievement/achievements.yml 自定义成就
8. 使用 /achievementadmin reload 重载配置

🔗 插件联动示例

副本插件联动

在副本完成时执行命令：

/achievementadmin progress add %player% dungeon_clear 1

任务插件联动

在任务完成时执行命令：

/achievementadmin progress add %player% quest_completed 1

经济系统联动

使用PlaceholderAPI自动追踪：

tracking:
  type: "PLACEHOLDER"
  placeholder:
    variable: "%vault_eco_balance%"
    target: 10000

📊 文件结构

plugins/PaiAchievement/
├── config.yml              # 主配置文件
├── achievements.yml        # 默认成就配置
├── levels.yml             # 等级配置
├── categories.yml         # 分类配置
├── achievements/          # 成就配置目录
│   └── custom.yml        # 自定义成就
└── data/                  # 数据文件（YAML模式）
    ├── players.yml
    ├── completed.yml
    └── progress.yml

📞 联系与支持

• 作者：PaiDaXing（派大星）
• 联系QQ：2776901795
• 插件系列：派大星插件系列
• 授权说明：本插件采用派大星授权系统，使用前需要购买授权