📥 安装

1. 将 AdventureManage-4.7.0.jar 放入 plugins/
2. 重启服务器，插件将自动生成 Settings/ 和 Saves/ 目录
3. 在 Settings/Modules.yml 中启用/禁用需要的模块
4. 编辑 Settings/ 目录下对应的配置文件
5. 使用 /am reload 重载

📋 更新日志

v4.7.0 LATEST

• NEW /am god 无敌模式 — 切换玩家无敌状态，免疫所有伤害和饥饿消耗。权限: adventuremanage.god
• NEW /am spawnmob 自然生物控制 — 新增命令控制生物自然生成开关，支持 list/toggle/info 子命令
• NEW /am emote 表情系统 — 支持打招呼等动作，广播到附近30格内玩家
• NEW 天赋经验卡4倍卡 — 新增 4倍天赋经验卡及3天时长变体
• FIX /am mob GUI 生物蛋图标 — 所有生物选项现在对应其生物蛋图标，支持按名称过滤
• FIX /am lay 姿态修复 — 玩家现在会真正躺下（游泳姿态）
• FIX /am sit 楼梯/半砖支持 — 空手右键楼梯/半砖可坐下
• FIX /am ride 鞍+交互 — 现需手持鞍使用，支持 on/off 切换

v4.4.0

• FIX 全息 PAPI 变量修复 — 修复普通玩家无法解析变量的问题
• NEW 全息 Per-Player 权限可见性 — Bukkit 原生 hideEntity/showEntity API，无需 ProtocolLib
• NEW /am glow 子命令 — 发光系统支持 /am glow 使用

v4.2.0

• FIX 飞行能量持久化 — 新增 PlayerQuitEvent 保存 + tick() 边缘情况保存
• FIX 经验加成卡持久化 — 确保跨服/重启不丢失
• FIX ArmorStand 方向计算 — 修复编译错误
• NEW 跨插件兼容性 — 反射API支持

v4.1.0

• NEW 物品编辑系统 — CMI 风格 6 个子命令
• NEW 40+ 新 PAPI 变量 — 玩家状态/位置/手持/装备/服务器信息
• FIX 快捷指令 sit/lay — 修复陷入地底问题

v4.0.0

• NEW /spawn 独立命令 — 支持权限、冷却、他人传送与反馈提示
• NEW Kit 系统（CMI风格） — GUI，冷却，次数限制
• NEW Gift 礼物系统 — GUI 赠送、次数限制、经济扣费
• NEW EventCommands 系统 — 事件命令执行框架
• NEW PAPI 扩展 — Kit/Gift 占位符

v3.9.0

• NEW 发光系统 /glow — 颜色命令 + GUI + 权限分色
• FIX 飞行能量跨服恢复 — CMI Flight Charge 核心行为

v3.8.0

• BREAKING 配置目录重构 — 旧 manage/ 目录废弃，合并到 Settings/
• NEW Modules.yml — 集中模块开关
• NEW SuperSpawn — 权限组重生点系统
• NEW /am card n/y — 显示开关

v2.6.0

• NEW Vault 经济提供者 — AM 自身注册为 Economy Provider
• NEW 玩家经济命令 — /pay、/payfree、/payinfo
• NEW 管理员经济命令 — give/set/take 带原因记录
• NEW 公益组织/服务器银行 — 捐款系统

v2.4.0

• NEW 在线奖励系统 — 按权限组区分，GUI领取
• NEW 等级系统 — CMI风格等级阶梯
• NEW 快捷指令 — 14种工作台/交互
• NEW 月卡系统 — 购买、每日领取、特殊日

v2.3.1

• NEW 经济控制系统 — Vault阶梯税率、国库、交易追溯
• NEW MySQL跨服同步 — HikariCP连接池
• NEW JS计数器/脚本系统
• NEW 配方增强 — 次数限制、冷却、前置条件
• NEW ItemsAdder + CraftEngine 集成

⌨️ 基础命令

通用命令

属性系统

战利品箱

挂机奖励

无敌模式 v4.7.0

使用 /am god 切换无敌状态，免疫所有伤害和饥饿消耗。权限: adventuremanage.god

生物生成控制 v4.7.0

使用 /am spawnmob 指令控制自然生物生成开关，支持 list/toggle/info 子命令，可控制幻翼/流浪商人等。

表情动作 v4.7.0

使用 /am emote 打招呼等动作，广播到附近30格内玩家。

统计系统

💬 社交系统

红包系统

邀请系统

卡片系统

卡片类型: 飞行卡(fly)、经验卡(exp)、自定义卡(custom)

✨ 显示系统

全息文字 v4.4.0 增强

v4.4.0: Per-Player 权限可见性

通过 /am holo setperm <ID> <权限节点> 设置后，只有拥有该权限的玩家才能看到此全息。底层使用 Bukkit 原生 hideEntity/showEntity API，无需 ProtocolLib。

Toast通知

💰 经济系统

玩家经济命令

管理员经济命令

/am eco 管理命令

公益组织（服务器银行）

公益组织是一个虚拟机构，玩家可通过 /payfree 自愿捐款，管理员可通过 /payfrees 强制捐款。所有捐款计入国库余额，捐款时会全服通知。

经济账单明细 (/payinfo)

• 收入 — 服务器给予、CDK兑换、转账收入、其他插件
• 支出 — QuickShop/ChestShop、其他插件扣款（通过Vault自动记录）
• 转账 — 玩家之间的转账记录
• 捐款 — 自愿捐款或被强制捐款
• 税收 — 收入时自动扣除的税收
• 管理 — 管理员的give/set/take操作

阶梯税率

# Settings/Economy.yml
economy:
  tax:
    enabled: true
    brackets:
      - { min: 0, max: 1000, rate: 0.0 }
      - { min: 1000, max: 10000, rate: 0.05 }
      - { min: 10000, max: 100000, rate: 0.10 }
      - { min: 100000, max: -1, rate: 0.15 }
    exempt-permission: "adventuremanage.eco.tax.exempt"
    notify: true
  treasury:
    initial-balance: 0.0

计数器/脚本 NEW

# Settings/Economy.yml → counter 部分
counters:
  kill_zombie:
    display-name: "僵尸猎手"
    event: ENTITY_KILL
    condition: "event.getEntityType().name() == 'ZOMBIE'"
    milestones:
      10: { commands: ["give %player% diamond 1"], message: "&a击杀10只僵尸!" }
      100: { commands: ["eco give %player% 1000"], message: "&6击杀100只僵尸!!" }

scheduled-tasks:
  daily_bonus:
    cron: "0 0 * * *"
    condition: "true"
    commands: ["broadcast &a每日奖励已发放!"]

配方系统 ENHANCED

每个配方可单独配置: permission、required-level、economy-cost、max-crafts、cooldown-seconds、deny-message

# Settings/Economy.yml → custom-recipe 部分
recipes:
  diamond_sword_custom:
    type: SHAPED
    shape: [" D "," D "," S "]
    ingredients: { D: DIAMOND, S: STICK }
    result:
      material: DIAMOND_SWORD
      amount: 1
      display-name: "&b&l定制钻石剑"
    permission: "am.recipe.diamond_sword"
    required-level: 10
    economy-cost: 500.0
    max-crafts: 5
    cooldown-seconds: 3600
    deny-message: "&c你还不能合成此物品!"

👤 玩家系统

在线奖励 NEW

• 按在线时长自动累计，达到指定时长后可在GUI中领取奖励
• 按权限组区分不同奖励 (VIP获得更好奖励)
• 每日自动重置已领取状态

等级系统 NEW

• CMI 风格等级阶梯 (新手 → 冒险者 → 勇士 → 精英 → 传奇)
• 升级条件: 金钱、经验等级、等级经验、在线时长、自定义PAPI条件
• 等级经验为内置独立值（不等于原版经验等级）

Kit 系统 NEW

礼物系统 NEW

• 支持 console / op / player 三种执行来源
• 支持全局冷却、每日赠送上限、每日接收上限与权限控制
• 支持经济扣费（cost-money），管理员可绕过

月卡系统 NEW

• 支持多种月卡类型 (基础/高级)，价格和奖励独立配置
• 特殊天数 (第7天/第14天/第30天) 有额外奖励
• 使用 Vault 经济扣款，到期自动过期

SuperSpawn 重生点 NEW

重生点判定逻辑

1. 首先使用 local 个人重生点
2. 如果没有 local，使用 group 组重生点
3. 如果都没有，使用 default 默认重生点

支持 world-specific-local 单世界限制和 teleport-on-join 登入传送。

⚡ 事件与工具

EventCommands 系统 NEW

• 复刻 CMI EventCommands，支持 Join/Quit/Death/Kill/Respawn/WorldChange/Advancement/PVP 等事件
• 支持 Commands 与 SourceCommands 双向执行
• 前缀: delay!、perm:...!、msg!、broadcast!、actionbar!、title!、subtitle!、kickall!
• 变量: [playerName]、[sourceName]、[value]

发光系统 v4.4.0 增强

快捷指令 NEW

潜影盒快速打开

手持潜影盒时按住 Shift + 右键，无需放置即可直接打开潜影盒内容。权限: adventuremanage.shulker

🔧 物品编辑系统 v4.1.0

物品名称

物品 Lore

自定义 NBT

支持类型: string(str) · int(i) · double(d) · long(l)。NBT 使用 PersistentDataContainer 存储，Key 前缀为 am_custom_。

其他物品指令

使用示例

# 给手中物品设置名称
/am itemname &6&l传说之剑

# 添加两行 Lore
/am itemlore add &7一把来自远古的武器
/am itemlore add &e攻击力 +50

# 修改第 2 行
/am itemlore set 2 &c攻击力 +100

# 设置自定义 NBT
/am itemnbt set rarity string legendary
/am itemnbt set damage_bonus int 50

# 设置 CustomModelData
/am itemcmd 1001

# 设为无法破坏
/am itemunbreak true

📁 目录与模块

配置文件结构 v4.0.0

plugins/AdventureManage/
├── config.yml                    # 主配置
├── messages.yml                  # 消息文本
├── gui.yml                       # GUI布局
│
├── Settings/                     # ★ 功能配置 (15个分组文件)
│   ├── Modules.yml               # 模块开关总控 (借鉴CMI)
│   ├── MobControl.yml            # 刷怪笼/生物生成/掉落/实体清理
│   ├── ItemsAndDrops.yml         # 死亡掉落/方块掉落/战利品箱/物品绑定
│   ├── Cards.yml                 # 飞行卡/经验卡/自定义卡
│   ├── Economy.yml               # 经济/计数器/自定义配方
│   ├── Social.yml                # 红包/邀请/聊天监控/公告/加入消息
│   ├── Display.yml               # TAB/全息/BossBar/Toast/反馈/GUI配置
│   ├── PlayerSystems.yml         # 玩家属性/统计/等级/等级组/在线奖励/月卡/挂机奖励
│   ├── Commands.yml              # 快捷指令/世界规则
│   ├── SuperSpawn.yml            # 重生点系统
│   ├── Kits.yml                  # Kit礼包系统
│   ├── Gift.yml                  # 礼物系统
│   ├── EventCommands.yml         # EventCommands系统
│   ├── MythicRewards.yml         # MythicMobs击杀奖励
│   └── Database.yml              # MySQL数据库
│
└── Saves/                        # ★ 运行时数据 (自动生成)
    ├── player-stats-data.yml     # 玩家统计
    ├── rank-data.yml             # 等级数据
    ├── levelgroup-data.yml       # 等级组数据
    ├── online-reward-data.yml    # 在线奖励进度
    ├── monthly-pass-data.yml     # 月卡数据
    ├── counter-data.yml          # 计数器数据
    ├── invite-data.yml           # 邀请数据
    ├── mob-spawn-data.yml        # 生物生成数据
    ├── spawnplus-data.yml        # 个人重生点
    ├── fly-energy-data.yml       # 飞行能量
    ├── bind-data.yml             # 物品绑定
    ├── attribute-data.yml        # 属性数据
    ├── treasury-data.yml         # 国库数据
    ├── afk-zones.yml             # 挂机区域
    ├── loot-tables.yml           # 战利品表
    ├── balances.yml              # 余额数据
    ├── eco-records/              # 经济记录
    └── holograms/                # 全息数据

模块开关 (Modules.yml) v3.8.0

所有功能模块的启停开关集中管理，禁用的模块完全停止工作，节省服务器资源。

# Settings/Modules.yml
# ===== 生物管理 =====
spawner: true              # 刷怪笼控制
mob-spawn: true            # 生物自然生成管理
mob-drops: true            # 生物掉落物管理
entity-cleaner: true       # 自动实体清理

# ===== 物品与掉落 =====
death-drop: true           # 死亡掉落控制
block-drop: false          # 方块掉落系统
loot-table: true           # 战利品箱子
item-bind: true            # 物品绑定

# ===== 加持卡系统 =====
fly-card: true             # 飞行卡
exp-card: true             # 经验卡
custom-card: true          # 自定义卡

# ===== 经济系统 =====
economy: true              # 经济核心
counter: true              # 计数器/脚本
custom-recipe: true        # 自定义合成配方

# ===== 社交系统 =====
red-packet: true           # 红包
gift: true                 # 礼物
invite: true               # 邀请
chat-monitor: false        # 聊天监控
announcement: false        # 公告轮播
join-message: true         # 加入/离开消息

# ===== 显示系统 =====
tab: true                  # TAB列表
hologram: true             # 全息文字
bossbar-display: true      # BossBar显示
toast: true                # Toast弹窗
feedback: true             # 互交反馈
gui-config: true           # GUI统一配置

# ===== 玩家系统 =====
player-attributes: true    # 玩家属性
player-stats: true         # 玩家统计
ranks: true                # Rank等级
levelgroups: true          # 等级组
online-reward: true        # 在线奖励
monthly-pass: true         # 月卡
kits: true                 # Kit礼包
afk-reward: true           # 挂机奖励

# ===== 其他 =====
quick-commands: true       # 快捷指令
world-rules: true          # 世界规则
superspawn: false          # SuperSpawn重生点
event-commands: true       # EventCommands
mythic-rewards: true       # MythicMobs击杀奖励

Settings 文件与模块对照表

⚙️ 配置详情

反馈系统

# Settings/Display.yml → feedback 部分
feedback:
  defaults:
    success:
      sound: ENTITY_PLAYER_LEVELUP
      volume: 1.0
      pitch: 1.5
      title: "&a&l成功"
      subtitle: ""
      fade-in: 5
      stay: 30
      fade-out: 10
    error:
      sound: ENTITY_VILLAGER_NO
      volume: 1.0
      pitch: 0.8
  modules:
    fly-card:
      activate:
        sound: ENTITY_ENDER_DRAGON_FLAP
        title: "&b&l飞行已激活"

数据库

# Settings/Database.yml
database:
  enabled: false
  mysql:
    host: localhost
    port: 3306
    database: adventure_manage
    username: root
    password: ""
    table-prefix: am_
  pool:
    maximum-pool-size: 10
    minimum-idle: 2
    connection-timeout: 30000
    idle-timeout: 600000
    max-lifetime: 1800000
  sync:
    fly-energy: true
    player-stats: true
    economy-records: true
    red-packets: true
    recipe-cooldowns: true
    counters: true

计数器事件类型

GUI配置

# Settings/Display.yml → gui-config 部分
guis:
  mob-spawn:
    title: "&6&l生物生成管理"
    size: 54
    buttons:
      toggle-all: { slot: 49, material: REDSTONE_TORCH, name: "&c全部切换" }
  item-bind:
    title: "&b&l物品绑定"
    size: 27
  player-attribute:
    title: "&a&l玩家属性 - %player%"
    size: 54

实体清理

• 多阶段倒计时 — 60s, 30s, 10s, 5s, 3s, 2s, 1s 分别提醒
• TPS保护 — TPS低于阈值自动触发紧急清理
• 物品白/黑名单 — 保护稀有物品不被清理
• 物品最小存活时间 — 刚掉的物品不清
• 实体保护 — 命名/拴绳/骑乘/驯服实体不清理
• 区块限制 — 每区块最大实体/掉落物数
• 分类统计 — 清理完成后显示各类清理数量

自定义配方类型

在线奖励配置

# Settings/PlayerSystems.yml → online-reward 部分
online-reward:
  daily-reset: true
  track-interval: 60
  groups:
    vip:
      permission: "group.vip"
      priority: 10
      rewards:
        30min: { required-minutes: 30, commands: ["give %player% diamond 3"] }
        60min: { required-minutes: 60, commands: ["eco give %player% 1000"] }
    default:
      permission: ""
      priority: 0
      rewards:
        30min: { required-minutes: 30, commands: ["give %player% iron_ingot 5"] }
        60min: { required-minutes: 60, commands: ["eco give %player% 500"] }
  gui:
    title: "&6&l在线奖励"
    size: 27

等级系统配置

# Settings/PlayerSystems.yml → ranks 部分
ranks:
  auto-promote: false
  default-rank: "novice"
  ladder:
    novice:
      display-name: "&7新手"
      prefix: "&7[新手]"
      priority: 0
      promote-requirements: {}
    adventurer:
      display-name: "&a冒险者"
      prefix: "&a[冒险者]"
      priority: 1
      promote-requirements:
        money: 5000
        exp-level: 10
        rank-exp: 100
        playtime-hours: 5
        custom-conditions:
          - "%am_online_today% >= 30"
      promote-commands:
        - "lp user %player% parent add adventurer"
      promote-message: "&a恭喜晋升为冒险者!"
    warrior:
      display-name: "&e勇士"
      prefix: "&e[勇士]"
      priority: 2
      promote-requirements:
        money: 20000
        exp-level: 25
        rank-exp: 500
        playtime-hours: 24
      promote-commands:
        - "lp user %player% parent add warrior"
      promote-message: "&e你已成为勇士!"
  gui:
    title: "&6&l等级系统"
    size: 27
    current-rank-slot: 11
    next-rank-slot: 15
    progress-slots: [20, 21, 22, 23, 24]

Kit 配置

# Settings/Kits.yml
kits:
  gui:
    title: "&8&l礼包系统"
    size: 54
    preview-title: "&8礼包预览: %kit%"
  list:
    starter:
      enabled: true
      display-name: "&a&l新手礼包"
      permission: "adventuremanage.kit.starter"
      icon: CHEST
      slot: 10
      cooldown-seconds: 3600
      max-claims: -1
      allow-preview: true
      commands:
        - "eco give %player% 200 新手礼包奖励"
      items:
        wood_sword:
          material: WOODEN_SWORD
          amount: 1
          name: "&f新手木剑"

礼物配置

# Settings/Gift.yml
gift:
  settings:
    allow-self-send: false
    cooldown-seconds: 3
  gui:
    title: "&8&l礼物系统"
    size: 54
  gifts:
    flower:
      enabled: true
      display-name: "&d鲜花礼物"
      permission: "adventuremanage.gift.type.flower"
      icon: POPPY
      slot: 10
      cost-money: 100
      max-send-per-day: 20
      max-receive-per-day: -1
      receiver-commands:
        - "eco give %target% 50 收到鲜花礼物"

EventCommands 配置

# Settings/EventCommands.yml
eventcommands:
  pvp-combat-seconds: 15

firstJoinServer:
  Enabled: true
  Commands:
    - "msg! [playerName] &a欢迎首次加入服务器！"
    - "broadcast! &e新玩家 &f[playerName] &e加入了服务器！"

playerKillPlayer:
  Enabled: false
  Commands:
    - "msg! [playerName] &c你被 [sourceName] 击杀了"
  SourceCommands:
    - "msg! [sourceName] &a你击杀了 [playerName]"

发光系统配置

# Settings/Display.yml → glow 部分
glow:
  gui-title: "&6&l发光颜色"
  gui-size: 54
  clear-slot: 49
  colors:
    yellow:
      display-name: "&e黄色"
      permission: "adventuremanage.glow.color.yellow"
      chat-color: YELLOW
      leather-color: "#E5E533"
    blue:
      display-name: "&9蓝色"
      permission: "adventuremanage.glow.color.blue"
      chat-color: BLUE
      leather-color: "#3C44AA"

快捷指令配置

# Settings/Commands.yml → quick-commands 部分
quick-commands:
  craft:     { enabled: true, permission: "adventuremanage.craft" }
  trash:     { enabled: true, permission: "adventuremanage.trash" }
  hat:       { enabled: true, permission: "adventuremanage.hat" }
  ride:      { enabled: true, permission: "adventuremanage.ride" }
  sit:       { enabled: true, permission: "adventuremanage.sit" }
  lay:       { enabled: true, permission: "adventuremanage.lay" }
  enderchest:{ enabled: true, permission: "adventuremanage.enderchest" }
  smithing:  { enabled: true, permission: "adventuremanage.smithing" }
  grindstone:{ enabled: true, permission: "adventuremanage.grindstone" }
  stonecutter:{ enabled: true, permission: "adventuremanage.stonecutter" }
  cartography:{ enabled: true, permission: "adventuremanage.cartography" }
  loom:      { enabled: true, permission: "adventuremanage.loom" }
  riptide:   { enabled: true, permission: "adventuremanage.riptide" }
  shulker:   { enabled: true, permission: "adventuremanage.shulker" }
  ride-max-distance: 4.0
  sit-dismount-delay: 1

月卡系统配置

# Settings/PlayerSystems.yml → monthly-pass 部分
monthly-pass:
  passes:
    basic:
      display-name: "&a基础月卡"
      price: 1000.0
      duration-days: 30
      daily-rewards:
        commands: ["give %player% iron_ingot 10", "eco give %player% 100"]
      special-days:
        7:  { commands: ["give %player% diamond 3"], message: "&6第7天特别奖励!" }
        14: { commands: ["give %player% diamond 5"], message: "&6第14天特别奖励!" }
        30: { commands: ["give %player% diamond 10"], message: "&6第30天终极奖励!" }
    premium:
      display-name: "&6&l高级月卡"
      price: 3000.0
      duration-days: 30
      daily-rewards:
        commands: ["give %player% diamond 2", "eco give %player% 500"]
      special-days:
        7:  { commands: ["give %player% netherite_ingot 1"] }
        30: { commands: ["give %player% netherite_ingot 5"] }
  gui:
    shop-title: "&6&l月卡商店"
    daily-title: "&6&l每日奖励"

SuperSpawn 配置

# Settings/SuperSpawn.yml
spawnplus:
  spawn-command:
    enabled: true
    permission: "adventuremanage.spawn.use"
    permission-others: "adventuremanage.spawn.others"
    permission-bypass-cooldown: "adventuremanage.spawn.bypasscooldown"
    cooldown-seconds: 30
  teleport-on-join: false
  world-specific-local: true
  default:
    world: world
    x: 0.5
    y: 64.0
    z: 0.5
    yaw: 0.0
    pitch: 0.0
  groups:
    vip:
      permission: adventuremanage.spawn.group.vip
      world: world
      x: 100.5
      y: 70.0
      z: 100.5
    admin:
      permission: adventuremanage.spawn.group.admin
      world: world
      x: 0.5
      y: 100.0
      z: 0.5

🔗 PAPI 占位符

标识符: %am_xxx%

玩家基本信息

玩家状态 v4.1.0

位置详情 v4.1.0

手持物品 / 装备 v4.1.0

游戏时长

经济

统计数据

距离统计

飞行卡 / 经验卡

计数器 / 等级 / 在线奖励 / 月卡

Kit / Gift / 等级组

服务器信息

📦 开发者 API

获取插件实例

AdventureManage plugin = AdventureManage.getInstance();

经济系统 API v2.6.0

EconomyManager eco = plugin.getEconomyManager();

// 查询余额
double balance = eco.getBalance(player);

// 给予金钱（自动扣税）
double actual = eco.giveMoney(player, 1000.0, "击杀Boss");

// 扣除金钱
boolean ok = eco.takeMoney(player, 500.0, "购买商品");

// 玩家转账
boolean transferred = eco.transfer(fromPlayer, toPlayer, 100.0);

// 玩家捐款给公益组织
boolean donated = eco.donate(player, 500.0);

// 强制捐款（管理员）
boolean forced = eco.forceDonate(target, 200.0, "AdminName");

// 管理员操作（不扣税，带原因）
eco.adminGive(player, 1000.0, "Console", "活动奖励");
eco.adminTake(player, 500.0, "Console", "违规处罚");
eco.adminSet(player, 5000.0, "Console", "余额修正");

// 查询国库/公益组织余额
double treasury = eco.getTreasuryBalance();

// 查询税率
double rate = eco.getTaxRate(1000.0);

// 查询交易记录
List<EcoRecord> records = eco.getRecords(uuid, 20);

// 获取Vault经济提供者
VaultEconomyProvider provider = eco.getVaultProvider();

计数器 API

CounterManager counter = plugin.getCounterManager();

// 获取计数值
int kills = counter.getCounterValue(uuid, "kill_zombie");

// 获取所有计数器ID
Set<String> ids = counter.getCounterIds();

配方系统 API

CustomRecipeManager recipe = plugin.getCustomRecipeManager();

// 检查合成条件
String deny = recipe.checkRequirements(player, "diamond_sword_custom");
// deny == null 表示允许

// 手动发现配方
recipe.discoverRecipes(player);

反馈系统 API

FeedbackManager fb = plugin.getFeedbackManager();

// 播放模块反馈
fb.play(player, "modules.fly-card.activate");

// 播放预设反馈
fb.playDefault(player, "success");
fb.playDefault(player, "error");

自定义物品集成 API

CustomItemProvider items = plugin.getCustomItemProvider();

// 获取自定义物品
ItemStack item = items.getCustomItem("ia:my_custom_sword");
ItemStack item2 = items.getCustomItem("ce:my_item");

// 检查集成状态
boolean hasIA = items.hasItemsAdder();
boolean hasCE = items.hasCraftEngine();

数据库 API

DatabaseManager db = plugin.getDatabaseManager();

// 异步保存飞行能量
db.saveFlyEnergy(uuid, energy, maxEnergy);

// 异步更新配方冷却
db.updateRecipeCooldown(uuid, "recipe_id", craftCount);

外部插件集成

🔑 权限节点