PlayerLevels

插件

· 作者 Flow2581

一个 Minecraft 插件,基于统计数据追踪引入玩家等级系统

0 本站下载 0 关注 更新于 1 年前

最新 3.0.0 · 1.21.10 · Bukkit / Paper

一键开服(送7天)

一个功能丰富的 Minecraft 插件,基于 Paper 1.21.3,通过统计追踪为玩家引入等级系统。

特性

核心特性

  • 动态升级:玩家根据游戏内的统计数据获得经验值并提升等级
  • 平衡缩放:更高等级需要指数级增长的经验值
  • 可配置统计项:服务器管理员可选择影响升级的统计项
  • 等级奖励:当玩家达到特定等级时自动发放奖励
  • PlaceholderAPI 集成:在其他插件中使用玩家等级信息
  • 排行榜:查看按等级排名的顶级玩家,支持分页

增强特性 (v2.0)

  • 成就系统:为里程碑和排名提供基于成就的奖励
  • 进度条:带有百分比显示的可视化经验值进度指示器
  • 升级公告:玩家升级时广播消息
  • 经验值加成系统:给予玩家临时的经验值倍率加成
  • 排名显示:在 /level 命令中查看你的服务器排名
  • 数据库支持:支持 SQLite 或 MySQL 存储选项

要求

  • Paper 1.21.3 或更高版本
  • PlaceholderAPI 以及 Statistic Expansion
  • Java 17+

安装

  1. 从发布页面下载插件 JAR 文件
  2. 将 JAR 文件放入服务器的 plugins 文件夹
  3. 重启服务器
  4. 确保已安装 PlaceholderAPI
  5. 安装 Statistic 扩展:执行 /papi ecloud download Statistic 和 /papi reload
  6. 在 plugins/PlayerLevels/config.yml 中按需配置插件

配置

该插件高度可配置。以下是主要配置部分的详细说明:

基本设置

settings:
  enable-plugin: true
  
  # 升级广播
  level-up-broadcast: true
  level-up-message: "&6%player% &e已达到 &aLevel %level%&e!"
  
  levels:
    base-xp: 100      # 第 1 级所需的基准经验值
    xp-multiplier: 1.5 # 每级增加的经验值倍数(指数缩放)

经验值加成系统

xp-boost:
  multiplier: 2.0     # 激活加成时的经验值倍率

统计项配置

你可以配置哪些统计项计入玩家等级,以及它们提供的经验值数量:

statistics:
  1:
    statistic: "MINE_BLOCK"
    material: "STONE"
    xp-value: 5       # 每挖掘一块石头获得 5 点经验值
  2:
    statistic: "KILL_ENTITY"
    entity: "ZOMBIE"
    xp-value: 20      # 每击杀一只僵尸获得 20 点经验值

statistic 字段应为有效的 Minecraft 统计名称。对于与方块相关的统计,请包含 material 字段。对于与实体相关的统计,请包含 entity 字段。

可以使用负数的经验值来惩罚某些行为(例如死亡)。

等级奖励

配置达到特定等级的奖励:

rewards:
  5:
    commands:
      - "give %player% diamond 1"
    message: "&a你达到了 Level 5!享受一颗钻石吧!"
  10:
    commands:
      - "give %player% diamond 5"
      - "eco give %player% 1000"
    message: "&eLevel 10!你获得了 5 颗钻石和 $1,000!"

成就系统 (新增!)

创建玩家可以获得的成就奖励:

awards:
  level_10_pioneer:
    display-name: "&6Level 10 Pioneer"
    requirement: "level=10"
    message: "&a✨ 成就解锁:&6Level 10 Pioneer&a!"
    commands:
      - "give %player% golden_apple 3"
  top_player:
    display-name: "&e&l⭐ #1 Player"
    requirement: "rank=1"
    message: "&6&l✨ 你是第一名!你获得了 Top Player 成就!"
    commands:
      - "give %player% diamond_block 10"

条件可以是:

  • level=X - 玩家必须达到 X 级
  • rank=X - 玩家必须达到 X 级或更好的排名

命令

命令 描述 权限
/level 查看你当前的等级、排名和进度 playerlevels.use
/level <player> 查看其他玩家的等级 playerlevels.others
/level awards [player] 查看你的成就(或其他玩家的) playerlevels.use
/level reload 重新加载插件配置 playerlevels.admin
/level set <player> <level> 设置玩家的等级 playerlevels.admin
/level boost <player> <minutes> 给予玩家临时的经验值加成 playerlevels.admin
/leveltop [limit] [page] 显示最高等级的排行榜 playerlevels.leaderboard

示例:

  • /level - 查看你的统计信息
  • /level awards - 查看你的成就
  • /level Steve - 查看 Steve 的统计信息
  • /level boost Steve 60 - 给予 Steve 1 小时的 2 倍经验值加成
  • /leveltop - 显示前 10 名玩家(第 1 页)
  • /leveltop 20 - 显示前 20 名玩家(第 1 页)
  • /leveltop 10 2 - 显示第 2 页的前 10 名玩家

占位符

该插件提供以下 PlaceholderAPI 占位符:

玩家占位符

  • %playerlevels_level%: 玩家当前等级
  • %playerlevels_xp%: 玩家总经验值点数
  • %playerlevels_xp_needed%: 下一级所需经验值
  • %playerlevels_progress%: 带有百分比的可视化进度条
  • %playerlevels_rank%: 玩家在服务器中的排名
  • %playerlevels_awards%: 已获得的成就数量

排行榜占位符

这些占位符无需玩家上下文即可工作,非常适合用于全息显示:

  • %playerlevels_top_<position>_name%: 指定位置的玩家名称(例如 %playerlevels_top_1_name%)
  • %playerlevels_top_<position>_level%: 指定位置的玩家等级(例如 %playerlevels_top_1_level%)
  • %playerlevels_top_<position>_xp%: 指定位置的玩家经验值(例如 %playerlevels_top_1_xp%)
  • %playerlevels_top_<position>_rank%: 位置编号(例如 %playerlevels_top_1_rank%)
  • %playerlevels_total_players%: 数据库中玩家的总数

全息图示例

使用 DecentHolograms 或类似的插件:

lines:
  - '&6&l⚔ Top Players ⚔'
  - '&e#1 &f%playerlevels_top_1_name% &7- &aLevel %playerlevels_top_1_level%'
  - '&e#2 &f%playerlevels_top_2_name% &7- &aLevel %playerlevels_top_2_level%'
  - '&e#3 &f%playerlevels_top_3_name% &7- &aLevel %playerlevels_top_3_level%'
  - ''
  - '&7Total Players: &f%playerlevels_total_players%'

Scoreboard Example

# In your scoreboard plugin config
lines:
  - '&6&lYour Stats'
  - '&eLevel: &f%playerlevels_level%'
  - '&eRank: &f#%playerlevels_rank%'
  - '%playerlevels_progress%'
  - '&eAwards: &f%playerlevels_awards%'

Storage

By default, the plugin uses SQLite for data storage. You can switch to MySQL by changing the configuration:

storage:
  type: "mysql"
  mysql:
    host: "localhost"
    port: 3306
    database: "minecraft"
    username: "root"
    password: ""

Permissions

Permission Description Default
playerlevels.use Allows checking own level true
playerlevels.

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源