- 版权类型
- 原创
- 插件中文名称
- 自定义进度
- 插件英文名称
- CustomAdvancement
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- 其他核心
- 语言支持
- 中文(简体)
- 前置组件
- UltimateAdvancementAPI https://www.spigotmc.org/resources/ultimateadvancementapi-1-15-1-21-4.95585/
ItemsAdder https://www.spigotmc.org/resources/%E2%9C%A8itemsadder%E2%AD%90emotes-mobs-items-armors-hud-gui-emojis-blocks-wings-hats-liquids.73355/
- 适配版本(Java)
- 1.21
- 1.20
欢迎使用 CustomAdvancementPlugin,基于 UltimateAdvancementAPI 和 ItemsAdder 开发。允许您创建和管理自定义进度(Advancements),为您的服务器增添更多玩法和挑战。
插件的核心配置文件 config.yml 允许您自定义进度页面和子进度的各项参数。以下是一个示例配置结构:
感谢您选择 CustomAdvancementPlugin,祝您的服务器游戏更加丰富多彩!


插件特色
- 自定义进度页面与子进度
- 通过简单的配置文件,创建多个进度页面(Advancement Tabs)和各自的子进度(Advancements)。
- 支持自定义图标,使用 ItemsAdder 提供的自定义物品或 Bukkit 原生材质作为进度图标。
- 动态进度管理
- 支持玩家进度的保存与恢复,确保玩家在服务器重载或更新后不会丢失进度。
- 提供命令接口,允许玩家自主解锁或撤销进度,管理员也可通过命令重载进度配置。
- 高度可配置
- 通过配置文件灵活定义进度的名称、描述、图标、位置以及父子关系,满足各种需求。
- 支持多标签页管理,轻松组织和分类不同类型的进度。
🛠 主要功能
- 加载与注册自定义进度
- 从配置文件中读取进度页面和子进度的定义,动态注册到服务器。
- 支持自定义背景图像,提升界面美观度。
- 进度管理命令
- /createadvancement <tab> <advancement>
- 功能:允许玩家解锁指定的子进度。
- 用法:/createadvancement adventure_explorer explore_cave
- /revokeadvancement <tab> <advancement>
- 功能:允许玩家撤销指定的子进度。
- 用法:/revokeadvancement adventure_explorer explore_cave
- /reloadadvancements
- 功能:管理员命令,重载进度配置,应用最新更改。
- 权限:customadvancements.reload
- 用法:/reloadadvancements
- /createadvancement <tab> <advancement>
配置指南
插件的核心配置文件 config.yml 允许您自定义进度页面和子进度的各项参数。以下是一个示例配置结构:
YAML:
tabs:
adventure_explorer:
background: "textures/block/stone.png"
root:
name: "冒险探索者"
description: "开启你的冒险之旅!"
material: "DIAMOND_PICKAXE"
advancements:
explore_cave:
name: "洞穴探险"
description: "探索10个洞穴。"
material: "TORCH"
x: 0
y: 1
parent: null
find_treasure:
name: "宝藏猎人"
description: "找到5个隐藏的宝藏。"
material: "CHEST"
x: 1
y: 1
parent: "explore_cave"
- tabs:定义多个进度页面,每个页面包含背景、根进度和子进度。
- background:进度页面的背景图路径。
- root:根进度的名称、描述和图标材质。
- advancements:定义子进度的名称、描述、图标材质、位置(x, y)以及父进度。
安装步骤
- 下载插件
- 获取最新版本的 CustomAdvancemen.jar 文件。
- 安装依赖
- 确保服务器已安装 UltimateAdvancementAPI 和 ItemsAdder。
- 放置插件
- 将 CustomAdvancementjar 放入服务器的 plugins 文件夹中。
- 配置插件
- 启动服务器生成默认配置文件。
- 编辑 plugins/CustomAdvancementPlugin/config.yml,根据需求自定义进度页面和子进度。
- 重启服务器
- 重启服务器以加载插件和配置。
使用说明
- 解锁进度
- 玩家可通过命令 /createadvancement <tab> <advancement> 解锁指定进度。
- 进度解锁前需满足父进度的完成条件。
- 撤销进度
- 玩家可通过命令 /revokeadvancement <tab> <advancement> 撤销已解锁的进度。
- 重载进度配置
- 管理员可使用命令 /reloadadvancements 重载进度配置,应用最新更改。
感谢您选择 CustomAdvancementPlugin,祝您的服务器游戏更加丰富多彩!