🔮 AdventureEnchants

一、简介

AdventureEnchants —— 一款功能完善的自定义附魔系统插件，支持自定义附魔效果、稀有度分级、附魔槽位限制、冲突管理以及 CraftEngine 物品集成。

插件基于 Paper 1.21.4+ 开发，采用 Paper Plugin 引导机制，24 个核心类构成完整的附魔框架。

核心特性

  • 自定义附魔 > 完全自定义附魔效果、等级、概率
  • 稀有度系统 > 多级稀有度分类，影响获取概率
  • 附魔槽位 > 限制物品可附魔数量，槽位扩展卷轴
  • 冲突管理 > 自定义附魔冲突规则，砂轮处理
  • 三大效果引擎 > 战斗效果 / 被动效果 / 工具效果
  • GUI 附魔台 > 可视化附魔操作界面
  • Lore 显示 > 自定义附魔 Lore 格式
  • CraftEngine 集成 > 支持 CE 自定义物品附魔
  • PAPI 变量 > PlaceholderAPI 占位符支持

二、插件前置

  • PlaceholderAPI — 可选，PAPI 变量支持
  • CraftEngine — 可选，自定义物品附魔集成
下一篇安装与配置 →

📥 安装与配置

环境要求

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

安装步骤

  1. 放入 AdventureEnchants-1.0.0.jar 到 plugins 目录
  2. 启动服务器自动生成配置文件
  3. 编辑配置文件自定义附魔
  4. 使用 /aenchant reload 重载

架构总览

模块说明
registry/附魔注册中心，CustomEnchant 定义
effect/三大效果引擎：战斗/被动/工具
slots/附魔槽位管理与扩展
mechanics/冲突处理、砂轮逻辑
gui/附魔台 GUI
display/Lore 管理、书本纹理
hook/CraftEngine、PAPI 集成
config/配置管理、稀有度、消息
上一篇← 概览
下一篇自定义附魔 →

🔮 自定义附魔

三大效果引擎

引擎类说明
战斗效果CombatEffectHandler攻击/受击时触发的附魔效果
被动效果PassiveEffectHandler穿戴/持有时持续生效的效果
工具效果ToolEffectHandler挖掘/使用工具时的附魔效果

稀有度系统

每个自定义附魔可配置稀有度等级，影响附魔台出现概率和 Lore 颜色。

冲突管理

  • ConflictHandler — 自定义附魔之间的冲突规则
  • GrindstoneHandler — 砂轮移除自定义附魔的逻辑
  • 支持与原版附魔的冲突配置

附魔注册

EnchantRegistry 管理所有自定义附魔的注册和查询，CustomEnchant 定义附魔的完整属性（名称、最大等级、稀有度、效果、冲突列表等）。

上一篇← 安装与配置
下一篇附魔槽位 →

🎰 附魔槽位

槽位限制

每件物品有最大附魔槽位数限制，超出限制无法继续附魔。

  • SlotManager — 管理物品槽位数量
  • SlotListener — 监听附魔操作，检查槽位限制
  • SlotExpanderListener — 槽位扩展卷轴使用监听

槽位扩展

通过特殊的槽位扩展卷轴物品，可以增加物品的最大附魔槽位数。

Lore 显示

LoreManager 负责在物品 Lore 中显示自定义附魔信息，支持自定义格式和颜色。BookTextureDeployer 处理附魔书的自定义纹理。

上一篇← 自定义附魔
下一篇命令列表 →

⌨️ 命令列表

主命令 /aenchant

命令说明权限
/aenchant reload重载配置adventureenchants.admin
/aenchant list列出所有自定义附魔adventureenchants.admin
/aenchant give <附魔> <等级>给予附魔书adventureenchants.admin
上一篇← 附魔槽位
下一篇配置文件 →

📋 配置文件

目录结构

plugins/AdventureEnchants/
├── config.yml          # 核心配置
├── enchants/           # 自定义附魔定义
├── messages.yml        # 消息文本
└── vanilla.yml         # 原版附魔覆盖配置

配置管理

配置类说明
Settings全局设置（槽位上限、GUI 等）
EnchantConfigManager附魔定义文件加载
VanillaEnchantConfig原版附魔行为覆盖
Rarity稀有度等级定义
Messages消息文本配置
上一篇← 命令列表
下一篇权限与集成 →

🔑 权限与集成

权限节点

权限说明默认
adventureenchants.admin管理员权限OP

插件集成

插件类型说明
CraftEngine软依赖支持 CE 自定义物品的附魔
PlaceholderAPI软依赖PAPI 占位符
上一篇← 配置文件
© 2024-2026 Feiiy · AdventureEnchants 自定义附魔系统 · QQ: 823959438