原创 - 娱乐 - 【玩家成就】Paiachievement | MineBBS 我的世界中文论坛

版权类型: 原创

插件中文名称: 派之玩家成就

插件英文名称: Paiachievement

原帖地址: http://pai.rulmiao.cn/pages/resource-detail.html?id=6

支持的核心（服务端）

Spigot
Paper
Purpur
其他核心

语言支持: 多语言

前置组件: PaiDaXingPlugins
PlaceholderAPI
MythicMobs
Vault
MythicDungeons
Chemdah

适配版本（Java）

1.21
1.20
1.19
1.18
1.17
1.16
1.15
1.14
1.13
1.12

PaiAchievement - 多维度成就系统
版本：v1.0.0 | 支持版本：Minecraft 1.12.2 - 1.21.X | 服务端：Spigot/Paper/Bukkit
派大星插件系列 | 基于Auth-SDK 2.0(PaiDaXingPlugins-1.2.2+) | 全版本兼容成就管理系统[/align]

派系列插件交流群：790396047

插件简介

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

核心特色

完整成就系统 - 7大分类，60+预设成就，无限扩展
等级进阶系统 - 5个等级，积分升级，解锁高级成就
链式成就设计 - 前置要求，成就之间环环相扣
精美GUI界面 - 分类切换，进度显示，状态识别
双存储方案 - MySQL跨服同步/YAML本地存储
灵活追踪系统 - 内置计数器/PlaceholderAPI变量/混合模式
跨版本粒子 - 成就解锁特效，支持1.12至1.21+
PlaceholderAPI集成 - 10+个变量，深度集成其他插件

成就分类系统

分类	说明	成就数量	所需等级
基础成就	首次登录、常客、探险家	10+	1级
战斗成就	击杀怪物、弓箭手、神射手	8+	1级
建筑成就	建筑师、方块放置大师	6+	2级
挖矿成就	矿工、方块破坏达人	5+	2级
生存成就	美食家、工匠、物品收集	12+	3级
探索成就	旅行者、维度探险、寻宝	10+	4级
进阶成就	成就大师、挑战成就	8+	5级

指令系统

玩家命令

指令	说明	权限
/achievement	打开成就GUI	paiachievement.use
/achievement progress	查看个人进度	paiachievement.use

管理员命令

指令	说明	权限
/achievementadmin reload	重载配置	paiachievement.admin
/achievementadmin progress add <玩家> <键> <数值>	添加进度	paiachievement.admin
/achievementadmin progress set <玩家> <键> <数值>	设置进度	paiachievement.admin
/achievementadmin setlevel <玩家> <等级>	设置等级	paiachievement.admin
/achievementadmin setpoints <玩家> <积分>	设置积分	paiachievement.admin
/achievementadmin reset <玩家> [成就ID]	重置成就	paiachievement.admin

等级系统

等级	称号	所需积分	解锁分类
1级	新手冒险者	0	基础、战斗
2级	初级探险家	50	建筑、挖矿
3级	熟练冒险家	150	生存
4级	资深探险家	300	探索
5级	传奇大师	500	进阶

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

界面预览
云拾UI

原版UI

安装方法

下载

代码：

PaiAchievement-1.0.0.jar

和依赖

代码：

PaiDaXingPlugins-1.2.2+.jar

将两个jar文件放入服务器
代码：
```
plugins
```
文件夹
（可选）安装
代码：
```
PlaceholderAPI
```
插件以支持变量追踪
（可选）安装
代码：
```
Vault
```
和经济插件以支持经济类成就
重启服务器（会自动生成配置文件）
编辑
代码：
```
plugins/PaiAchievement/config.yml
```
配置数据库
编辑
代码：
```
plugins/PaiAchievement/achievements.yml
```
自定义成就
使用
代码：
```
/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