[1.8-1.16.5]PassCardPro — 通行证/战令 支持宝可梦,RPG,生存服！

#MySql数据库设置
MySql:
  #是否使用数据库，设置为false则使用本地yml存储数据
  UseSql: false
  DatabaseName: pcdata
  UserName: root
  Password: 123456
  Port: 3306
  Ip: localhost
#应用的语言文件
Language: zh_CN
#是否开始双跳任务以及监听支持（双跳可能不兼容部分插件）
DoubleJump: true
#每周最大点数
WeekMaxPoint:
  Default: 1000
  Vip: 1500
#刷新间隔-单位：秒
Refresh: 3
#PapiHook的方式，老版本请写1 ，如果hook失败请写2
Papi: 2
#任务是否设置完成
#请在确保任务数量>=9且有三个随机任务后手动改为true，否则会出现报错等问题
Mission:
  Complete: false
  #玩家三个随机任务数据更新方式： #daily-每日   #weekly-每周
  Refresh: "daily"
  #提示方式:
  Notice:
    #TiTle提示
    Title: true
    #消息提示
    Msg: false
#拥有该权限将不会被阻止飞行
Permission:
  Fly: "essentials.fly"
#界面设置
Gui:
  Award:
    Title: "§c§l通行证奖励"
    #排行机制： 等级+点数 等级优先>点数优先
    TopDesc: "§eTop.<top> §a<player> §9(§d<level>级§e<point>点§9)"
    SeasonDesc:
      - "§e§l <seasonName>"
      - "§b§l>> §e赛季持续时间:"
      - "    §8▶ <continue>"
      - " "
      - "§b§l>> §d赛季开始日期:"
      - "    §8▶ <startDay>"
      - " "
      - "§b§l>> §c剩余时间:"
      - "    §8▶ <leftDay>"
  Menu:
    Title: "§bPassCardPro通行证"
    Vip: "§9[§6§l进阶§9]"
    Default: "§9[§a普通§9]"
    Desc:
      - "§b§l>> <player> <vip>"
      - "§b§l>> §a通行证等级:"
      - "    §8▶ <level>"
      - " "
      - "§b§l>> §d当前点数:"
      - "    §8▶ <point>"
      - " "
      - "§b§l>> §c本周点数:"
      - "    §8▶ <weekPoint>/<maxWeekPoint>"
      - " "
      - "§b§l>> §6奖励领取状态(个数):"
      - "    §8▶ &a普通奖励: §e<defaultGets>"
      - "    §8▶ §d进阶奖励: §e<vipGets>"
      - " "
      - "§b§l>> §d升级还需:"
      - "    §8▶ §e<nextLevelNeedPoint> §a点"
  Mission:
    Title: "§e§l任务详情"
    Finish: "§9[§b§l已完成!§9]"
    Continue: "§9[§a§l进行中...§9]"
    Desc:
      - "§b§l>> §a任务:"
      - "    §8▶ <missionName>"
      - "    §8▶ <missionDesc>"
      - " "
      - "§b§l>> §e任务进度:"
      - "    §8▶ <rate>/<require>"
      - " "
      - "§b§l>> §e任务完成次数/最大完成次数:"
      - "    §8▶ <finishTime>/<maxTime>"
      - " "
      - "§b§l>> §e奖励点数:"
      - "    §8▶ <givenPoint>"
      - " "
      - "§b§l>> §d编号:"
      - "    §8♦ <missionId>"

#等级
1:
  #普通玩家奖励
  Default:
    #显示在界面上的物品代号，如果不想开启这个奖励，将Display行整行删除即可
    Display: skin
    #领取后执行的指令
    Command:
      - 'eco give <player> 1000'
    #给予的物品，也在award/item.yml中保存
    Item: []
  #进阶奖励
  Vip:
    Display: skin
    Command:
      - 'eco give <player> 5000'
    Item:
      - skin
      - skin
  #到达该等级需要的点数,到达后即扣除
  Point: 10
2:
  Default:
    Display: rabbit_meat
    Command:
      - 'eco give <player> 1000'
    Item:
      - rabbit_meat
  Vip:
    Display: rabbit_meat
    Command:
      - 'eco give <player> 5000'
    Item:
      - rabbit_meat
  Point: 50
3:
  Default:
    Display: rabbit_skin
    Command:
      - 'eco give <player> 1000'
    Item: []
  Vip:
    Display: rabbit_skin
    Command:
      - 'eco give <player> 5000'
    Item:
      - rabbit_skin
  Point: 100

 /**
     * 启动数据连接
     *
     * @return 是否成功
     */
    boolean enableDataBase();

    /**
     * 获取玩家的任务列表
     *
     * @param player 玩家
     * @return 任务列表
     */
    List<Mission> getPlayerMissionList(Player player);

    /**
     * 更新玩家的任务进度
     * 前进行判断：
     * 1 是否已经达到最大完成次数
     * 2 是否已经到达本周最大点数
     * 后进行更新：
     * 1 判断是否到达要求
     *   -是：更新点数、完成次数
     *
     * @param player 玩家
     * @param missionId 任务ID
     * @param rate 新进度
     */
    void updatePlayerMissionRate(Player player,String missionId,String rate);

    /**
     * 更新玩家随机任务进度
     *
     * @param player 玩家
     * @param missionId 任务ID
     * @param rate 进度
     */
    void updatePlayerRandomMissionRate(Player player,String missionId,String rate);

    /**
     * 通过任务ID获取任务内容
     *
     * @param missionId 任务ID
     * @return 任务
     */
    Mission getMissionById(String missionId);

    /**
     * 根据玩家和任务ID获取具体的任务进度
     *
     * @param player 玩家
     * @return 玩家任务进度
     */
    Map<String,String> getPlayerMissionByPlayer(Player player);

    /**
     * 获取本周任务列表
     *
     * @param weekId 本周ID
     * @return 任务列表
     */
    List<Mission> getWeekMissionList(String weekId);


    /**
     * 获取玩家当前数据
     * @param player 玩家
     * @return PassCardPlayer实体类
     */
    PassCardPlayer getPlayerData(Player player);

    /**
     * 通过uuid获取玩家数据
     *
     * @param UUID 玩家UUID
     * @return PassCardPlayer实体类
     */
    PassCardPlayer getPlayerData(String UUID);

    /**
     * 检查并更新玩家任务数据等
     *
     * @param player 玩家
     */
    void checkAndUpdatePlayerData(Player player);

    /**
     * 根据uuid获取TopPlayer
     *
     * @param uuid 玩家uuid
     * @return topPlayer
     */
    TopPlayer getTopPlayer(String uuid);

    /**
     * 改变玩家点点数
     *
     * @param passCardPlayer 玩家
     * @param points 增加的点数 可为负数
     * @param checkLevel 是否检查等级
     * @param notice 是否提示
     */
    void updatePlayerPoint(PassCardPlayer passCardPlayer,double points,boolean checkLevel,boolean notice);

    /**
     * 检查玩家等级并更新
     *
     * @param passCardPlayer 玩家
     * @param isAdd 是否为增加等级
     */
    void updatePlayerLevel(PassCardPlayer passCardPlayer,boolean isAdd);

    /**
     * 检查玩家当前获取的周点数是否到达了上限
     *
     * @param passCardPlayer 玩家
     * @return 是否到达上限
     */
    boolean playerWeekPointIsMax(PassCardPlayer passCardPlayer);

    /**
     * 更新玩家每周点数
     *
     * @param passCardPlayer 玩家
     * @param points 点数 可为负数
     */
    void updatePlayerWeekPoint(PassCardPlayer passCardPlayer,double points);

    /**
     * 新建玩家数据
     *
     * @param player 玩家
     */
    void createPlayerData(Player player);

    /**
     * 新建玩家任务数据
     *
     * @param player 玩家
     */
    void createPlayerMissionData(Player player);

    /**
     * 获取一条随机任务
     *
     * @param needRandom 是否需要random项为true
     * @return 随机任务
     */
    Mission getRandomMission(boolean needRandom);

    /**
     * 新建一条任务数据
     *
     * @param mission 任务
     * @return  是否成功
     */
    boolean createNewMissionData(Mission mission);

    /**
     * 获取玩家的任务进度
     *
     * @param player 玩家
     * @return 任务进度列表
     */
    MissionPlayer getPlayerMissionData(Player player);

    /**
     * 获取玩家到达下一个等级需要多少点数
     *
     * @param player 玩家
     * @return 点数
     */
    double getPlayerNextLevelNeedPoint(Player player);

    /**
     * 获取前10玩家排名
     *
     * @return 排行Map
     */
    ConcurrentHashMap<Integer,TopPlayer> getTop10Player();

    /**
     * 重置每周任务
     */
    void resetWeekMission();

    /**
     * 删除玩家数据
     *
     * @param player 玩家
     */
    void deletePlayerMissionData(Player player);

    /**
     * 获取玩家随机任务数据
     *
     * @param player 玩家
     * @return 随机任务数据集
     */
    List<Mission> getPlayerRandomMissionData(Player player);

    /**
     * 更新玩家数据库数据
     *
     * @param passCardPlayer 玩家
     * @param gets 本次获取的普通奖励个数
     * @param vipGets 本次获取的VIP奖励个数
     */
    void updatePassCardPlayerGets(PassCardPlayer passCardPlayer, int gets, int vipGets);

    /**
     * 更新任务描述
     *
     * @param missionId 任务ID
     * @param desc 描述
     * @param player 玩家
     */
    void updateMissionDesc(String missionId,String desc,Player player);

    /**
     * 设置玩家的VIP状态
     *
     * @param player 玩家
     * @param setVip 是否vip
     * @param sender 指令发送者
     */
    void updatePlayerVip(Player player,boolean setVip, CommandSender sender);

    /**
     * 获取当前赛季数据
     *
     * @return 当前赛季
     */
    Season getNowSeasonData();

    /**
     * 重置玩家赛季数据
     */
    void resetPlayerSeasonData();

    /**
     * 新建一个赛季
     *
     * @param season 赛季
     */
    void updateNewSeason(Season season);

    /**
     * 更新一个赛季名称
     *
     * @param seasonName 赛季名称
     * @param sender 执行者
     */
    void updateSeasonName(String seasonName , CommandSender sender);

    /**
     * 更新一个赛季时长
     *
     * @param continueDays 持续时间
     * @param commandSender 执行者
     */
    void updateSeasonContinueDays(int continueDays , CommandSender commandSender);

    /**
     * 新建一个赛季数据
     */
    void createSeasonData();

    /**
     * 获取所有的任务数据
     *
     * @return 任务数据集
     */
    List<Mission> getAllMissionData();

    /**
     * 根据任务ID删除任务
     *
     * @param missionId 任务ID
     * @param commandSender 执行者
     */
    void deleteMissionById(String missionId,CommandSender commandSender);

    /**
     * 关闭数据连接
     */
    void closeDataBase();