📊 AdventureLevel

一、简介

AdventureLevel —— 等级经验系统

为服务器提供独立的等级经验体系，支持 CraftEngine 资源包自定义等级条 UI，GUI 等级面板，多种经验来源（击杀怪物、挖矿、钓鱼等），自动/手动升级，PAPI 变量集成。

支持 Paper 1.21.4+ 服务器（Java 21）。

核心特性

  • CraftEngine 等级条 — 资源包自定义UI，实时显示等级和经验进度
  • 多经验来源 — 击杀怪物、挖掘方块、钓鱼、合成等，每种可独立配置
  • 自定义升级曲线 — 公式化经验需求，支持等级上限
  • GUI 面板 — 可视化等级信息、经验详情、升级进度
  • 升级奖励 — 每级可配置命令奖励和消息
  • PAPI 变量 — 等级、经验、进度百分比等变量

二、插件前置说明

  • CraftEngine — 可选，等级条 UI 资源包
  • PlaceholderAPI — 可选，PAPI 变量支持
下一篇安装与配置 →

📥 安装与配置

环境要求

项目要求
服务端Paper 1.21.4+
Java21+
可选依赖CraftEngine、PlaceholderAPI

安装步骤

  1. 放入 AdventureLevel-1.0.0.jar
  2. 启动服务器自动生成配置
  3. 编辑 config.yml、gui.yml、messages.yml
  4. 安装 CraftEngine 资源包（可选，用于等级条UI）
  5. /alevel reload

目录结构

plugins/AdventureLevel/
  config.yml          # 主配置（经验来源、升级曲线、奖励）
  gui.yml             # GUI 面板布局
  messages.yml        # 消息文本
上一篇← 概览
下一篇经验系统 →

⭐ 经验系统

经验来源

来源说明默认经验
击杀怪物按怪物类型配置10-50
挖掘方块按方块类型配置1-5
钓鱼成功钓起物品5-15
合成物品工作台合成2-8

升级公式

level-formula:
  base: 100           # 1级所需经验
  multiplier: 1.15    # 每级倍率递增
  max-level: 100      # 最大等级

第 N 级所需经验 = base × multiplier^(N-1)

上一篇← 安装与配置
下一篇等级条UI →

🎨 等级条 UI

通过 CraftEngine 资源包实现自定义等级条，显示在玩家屏幕上方。

资源包结构

resourcepack/assets/
  minecraft/textures/
    level_bar_bg.png       # 等级条背景
    level_bar_fill.png     # 等级条填充（按进度裁剪）
    level_numbers/         # 数字贴图 0-9

等级条会根据当前经验百分比动态显示填充进度，搭配 CraftEngine 的 <image:xxx> 标签实现。

上一篇← 经验系统
下一篇GUI 面板 →

🖥️ GUI 面板

使用 /alevel gui 打开等级信息面板，展示当前等级、经验进度、升级奖励预览等信息。

GUI 布局在 gui.yml 中完全自定义。

上一篇← 等级条UI
下一篇命令列表 →

⌨️ 命令列表

命令说明权限
/alevel查看自己的等级alevel.use
/alevel gui打开GUI面板alevel.use
/alevel info [玩家]查看指定玩家等级alevel.use
/alevel set <玩家> <等级>设置等级alevel.admin
/alevel addexp <玩家> <数量>添加经验alevel.admin
/alevel reload重载配置alevel.admin
上一篇← GUI 面板
下一篇配置文件 →

⚙️ 配置文件

config.yml 主要配置

level-formula:
  base: 100
  multiplier: 1.15
  max-level: 100

exp-sources:
  kill:
    enabled: true
    ZOMBIE: 10
    SKELETON: 12
    CREEPER: 15
    ENDER_DRAGON: 500
  mine:
    enabled: true
    DIAMOND_ORE: 5
    IRON_ORE: 2
  fish:
    enabled: true
    base: 8

rewards:
  10:
    commands:
      - "give {player} diamond 5"
    message: "&a恭喜升到10级！"
  50:
    commands:
      - "give {player} netherite_ingot 1"
上一篇← 命令列表
下一篇权限节点 →

🔑 权限节点

权限说明默认
alevel.use基础命令所有玩家
alevel.admin管理命令OP
上一篇← 配置文件
下一篇更新日志 →

📝 更新日志

v1.0.0 最新

  • NEW 初始发布 — 等级经验体系、CraftEngine资源包UI、GUI面板、多经验来源、升级奖励、PAPI变量
上一篇← 权限节点
© 2024-2026 Feiiy · AdventureLevel 等级经验系统 · QQ: 823959438