AdventureManage v4.4.0

综合服务器管理插件 — 一站式生物管理、掉落控制、绑定、属性、红包、邀请、经济、配方、计数器、全息、TAB、BossBar、实体清理、在线奖励、等级系统、快捷指令、月卡、重生点等功能。

核心特性

兼容性: Spigot / Paper 1.21.4+, Java 21+
软依赖: Vault, PlaceholderAPI, PlayerPoints, Multiverse-Core, ProtocolLib, LuckPerms, ItemsAdder, CraftEngine

安装

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

更新日志

v4.4.0 更新日志 LATEST

v4.2.0 更新日志

v4.1.0 更新日志

v4.0.0 更新日志

v3.9.0 更新日志

v3.8.0 更新日志

⚠ 升级注意: v3.8.0 对配置目录进行了重大重构。旧的 manage/ 目录不再使用，请参考 配置文件结构 了解新的目录布局。首次启动将自动生成新的 Settings/ 配置文件，但旧配置不会自动迁移，需要手动将自定义配置迁移到新文件中。

v2.6.0 更新日志

v2.4.0 更新日志

v2.3.1 更新日志

基础命令

命令说明权限
/am help [页码]显示帮助 (12页)adventuremanage.help
/am reload重载全部配置adventuremanage.reload
/am mob生物生成管理GUIadventuremanage.mob
/am bind物品绑定GUIadventuremanage.bind
/am clean手动清理实体adventuremanage.clean
/am tab刷新TAB列表adventuremanage.tab

属性系统

命令说明
/am attr [玩家]打开属性GUI
/am attr set <玩家> <属性> <值>设置属性值
/am attr reset <玩家>重置所有属性

战利品箱

命令说明
/am loot list列出战利品表
/am loot set <表ID>标记对准的箱子
/am loot preview <表ID>预览战利品

挂机奖励

命令说明
/am afk wand开启选区模式(金锄)
/am afk create <ID> <名> <秒> <经验>创建挂机区域
/am afk remove <ID>删除区域
/am afk list列出区域

红包系统

命令说明
/am rp password <额> <数> <口令>口令红包
/am rp send <额> <数>点击红包
/am rp give <玩家> <额>专属红包
/am rp list查看活跃红包

邀请系统

命令说明
/am invite code生成邀请码
/am invite use <码>使用邀请码
/am invite info查看邀请信息

卡片系统

命令说明权限
/am card give <玩家> <卡ID> [数量]给予卡片adventuremanage.admin
/am card list列出所有卡片adventuremanage.admin
/am card info [玩家]查看玩家当前加持状态adventuremanage.admin
/am card n隐藏飞行能量/加成经验条/自定义加持条 NEW所有玩家
/am card y重新显示所有加持显示条 NEW所有玩家

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

v3.9.0 调整: 飞行能量按 CMI 风格核心行为处理（飞行距离消耗 + 悬停每秒消耗 + 分级颜色提示），并增强跨服恢复可靠性。

全息文字 v4.4.0 增强

命令说明
/am holo create <ID> <行1|行2|行3>在当前位置创建全息
/am holo remove <ID>删除全息
/am holo list列出全息
/am holo info <ID>查看全息详情
/am holo move <ID>移动全息到当前位置
/am holo tp <ID>传送到全息位置
/am holo near [距离]查找附近全息
/am holo addline <ID> <文字>添加一行
/am holo setline <ID> <行号> <文字>设置指定行
/am holo removeline <ID> <行号>删除指定行
/am holo insertline <ID> <行号> <文字>在指定行前插入
/am holo copy <源ID> <新ID>复制全息
/am holo enable <ID>启用全息
/am holo disable <ID>禁用全息
/am holo setperm <ID> <权限|none>设置权限可见性
/am holo setrange <ID> <距离>设置可视距离
/am holo setspacing <ID> <行间距>设置行间距
/am holo edit <ID>打开设置GUI
/am holo import <CMI路径>导入CMI全息

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

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

PAPI 占位符: 全息文字支持 PlaceholderAPI 占位符（如 %player_name%），会根据最近玩家解析。v4.4.0 修复了普通玩家无法解析变量的问题。

Toast通知

命令说明
/am toast send <玩家> <ID>发送Toast通知
/am toast list列出Toast定义

配方系统 ENHANCED

命令说明
/am recipe list列出已注册配方
/am recipe discover <玩家>解锁全部配方

v2.3.1 配方增强功能

每个配方可单独配置:

# 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你还不能合成此物品!"

经济系统 v2.6.0 重构

重要变更: v2.6.0 起，AdventureManage 自身注册为 Vault 经济提供者（优先级 Highest），所有依赖 Vault 的插件（QuickShop、ChestShop 等）将自动使用 AM 的经济系统，无需额外安装 EssentialsX Economy 等经济插件。

玩家经济命令

命令说明权限
/pay查看自己的余额无
/pay <玩家> <数量>给其他玩家转账无
/payfree <数量>捐款给公益组织（服务器银行）无
/payinfo查看自己的经济账单明细无

管理员经济命令

命令说明权限
/pay <玩家>查看指定玩家的余额adventuremanage.eco.admin
/pay <玩家> balance查看指定玩家的余额adventuremanage.eco.admin
/pay <玩家> give <数量> <原因>给予玩家金币（不扣税，原因必填，记入明细）adventuremanage.eco.admin
/pay <玩家> set <数量> <原因>设置玩家余额（原因必填，记入明细）adventuremanage.eco.admin
/pay <玩家> take <数量> <原因>扣除玩家金币（计入国库，原因必填，记入明细）adventuremanage.eco.admin
/payinfo <玩家>查看指定玩家的经济账单明细adventuremanage.eco.admin
/payfrees <玩家> <数量>强制玩家捐款给公益组织adventuremanage.eco.admin

/am eco 管理命令

命令说明
/am eco treasury查看国库/公益组织余额
/am eco log [玩家] [数量]查看经济记录
/am eco give <玩家> <额> [原因]管理员给予(不扣税)
/am eco take <玩家> <额> [原因]管理员扣除(计入国库)

公益组织（服务器银行）

公益组织是一个虚拟机构，玩家可通过 /payfree 自愿捐款，管理员可通过 /payfrees 强制捐款。所有捐款计入国库余额，管理员可在举办活动时将其取出作为支出。捐款时会全服通知。

经济账单明细 (/payinfo)

账单中会详细记录每一笔交易的来源和原因：

阶梯税率

# 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

命令说明
/am counter list列出计数器
/am counter view [玩家] [ID]查看计数值

计数器配置示例

# 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每日奖励已发放!"]

统计系统

命令说明
/am stats [玩家]查看统计数据

在线奖励系统 NEW

命令说明权限
/am onlinereward打开在线奖励GUI所有玩家
/am or同上 (简写)所有玩家

功能说明

PAPI占位符: %am_online_today% 今日在线分钟 · %am_online_total% 累计在线分钟

等级系统 NEW

命令说明权限
/am rank打开等级GUI所有玩家
/am rank info [玩家]查看等级信息所有玩家
/am rank exp info [玩家]查看等级经验信息所有玩家
/am rank exp <give|take|set> <玩家> <数量>管理玩家等级经验adventuremanage.rank.admin
/am rank promote <玩家>强制升级玩家adventuremanage.rank.admin
/am rank demote <玩家>强制降级玩家adventuremanage.rank.admin
/am rank set <玩家> <等级>设置玩家等级adventuremanage.rank.admin

功能说明

PAPI占位符: %am_rank% 等级名 · %am_rank_display% 显示名(带颜色) · %am_rank_prefix% 前缀 · %am_rank_exp% 等级经验 · %am_rank_exp_required% 升级所需等级经验 · %am_rank_exp_to_next% 升级剩余等级经验 · %am_rank_exp_percent% 等级经验进度

Kit 系统 NEW

命令说明权限
/kit打开礼包GUIadventuremanage.kit.gui
/kit <礼包ID>领取指定礼包adventuremanage.kit.use + 礼包权限
/kit list查看礼包列表所有玩家
/kit preview <礼包ID>预览礼包内容adventuremanage.kit.preview
/kit give <玩家> <礼包ID> [数量]管理员发放礼包adventuremanage.kit.admin
/kit reset <玩家> [礼包ID]重置礼包冷却/次数记录adventuremanage.kit.admin

功能说明

礼物系统 NEW

命令说明权限
/gift <玩家>打开礼物GUI并选择目标玩家adventuremanage.gift.gui
/gift gui <玩家>同上adventuremanage.gift.gui
/gift send <玩家> <礼物ID> [数量]直接赠送礼物adventuremanage.gift.send
/gift give <玩家> <礼物ID> [数量]管理员/控制台发放礼物adventuremanage.gift.admin
/gift list查看礼物列表所有玩家
/gift reset <玩家> [礼物ID]重置礼物统计与冷却adventuremanage.gift.admin

功能说明

EventCommands 系统 NEW

命令说明权限
/eventcommands list查看已加载事件列表adventuremanage.eventcommands.admin
/eventcommands reload重载事件命令配置adventuremanage.eventcommands.admin
/eventcommands test <事件> [玩家] [来源玩家] [值]测试触发事件adventuremanage.eventcommands.admin

功能说明

发光系统 v4.4.0 增强

命令说明权限
/glow 或 /am glow打开发光颜色GUIadventuremanage.glow.use
/glow gui 或 /am glow gui打开发光颜色GUIadventuremanage.glow.use
/glow <颜色> 或 /am glow <颜色>设置指定颜色发光（如 yellow/blue/red）adventuremanage.glow.use + 对应颜色权限
/glow off 或 /am glow off取消发光效果adventuremanage.glow.use
/glow list 或 /am glow list查看自己可用的颜色列表adventuremanage.glow.use
/am glow set <玩家> <颜色|off>管理员为他人设置/取消发光adventuremanage.admin
/am glow check [玩家]诊断发光系统状态adventuremanage.admin
颜色权限: 通过 adventuremanage.glow.color.<color> 控制可用颜色（如 adventuremanage.glow.color.yellow）。GUI 仅显示玩家有权限的颜色。
v4.4.0: /am glow 与 /glow 完全等效，所有玩家（含非管理员）均可使用。

快捷指令 NEW

命令说明权限
/am craft打开工作台adventuremanage.craft
/am trash打开垃圾桶adventuremanage.trash
/am hat将手持物品戴在头上adventuremanage.hat
/am ride骑乘附近玩家adventuremanage.ride
/am sit坐下 (再次输入站起)adventuremanage.sit
/am lay躺下 (再次输入站起)adventuremanage.lay
/am ec打开末影箱adventuremanage.enderchest
/am smithing打开锻造台adventuremanage.smithing
/am grindstone打开砂轮adventuremanage.grindstone
/am stonecutter打开切石机adventuremanage.stonecutter
/am cartography打开制图台adventuremanage.cartography
/am loom打开织布机adventuremanage.loom
/am riptide激流旋转adventuremanage.riptide

潜影盒快速打开

手持潜影盒时按住 Shift + 右键，无需放置即可直接打开潜影盒内容。关闭时自动保存回物品。

权限: adventuremanage.shulker

月卡系统 NEW

命令说明权限
/am monthlypass打开月卡商店GUI所有玩家
/am mp同上 (简写)所有玩家
/am mp shop月卡商店所有玩家
/am mp buy <ID>购买月卡所有玩家
/am mp claim <ID>领取今日奖励所有玩家

功能说明

PAPI占位符: %am_pass_basic_active% 是否拥有基础月卡 · %am_pass_basic_days% 剩余天数

SuperSpawn 重生点系统 NEW

优先级公式: local(个人) > group(组) > default(默认)
玩家死亡后按优先级选择重生点，支持单世界限制和登入传送。
命令说明权限
/spawn传送自己到当前生效重生点（支持冷却）adventuremanage.spawn.use
/spawn <玩家>将目标玩家传送到其生效重生点adventuremanage.spawn.others
/am spawn setlocal [玩家]设置个人重生点(当前位置)adventuremanage.spawn.admin
/am spawn removelocal <玩家>移除个人重生点adventuremanage.spawn.admin
/am spawn info [玩家]查看玩家重生点信息(显示各优先级和实际生效点)adventuremanage.spawn.admin
/am spawn setdefault查看默认重生点配置信息adventuremanage.spawn.admin

重生点判定逻辑

  1. 玩家首先会重生于其 local 的重生点
  2. 如果玩家没有被设置 local 的重生点，group 的重生点将作为玩家的重生点
  3. 如果玩家并没有被设置 local/group 的重生点，那么 default 将作为其重生点

单世界重生点

如果开启了 world-specific-local: true，当玩家死亡的世界与其 local 重生点的世界不相同时，local 的重生点将不被选用，转而使用 group 或 default。

登入传送

可选功能：开启 teleport-on-join: true 后，玩家加入服务器时会自动传送到对应优先级的重生点。

物品编辑系统 v4.1.0

CMI 风格: 借鉴 CMI 的物品编辑系统，支持在手持物品上直接修改名称、Lore、NBT、数量等。所有指令需要权限 adventuremanage.itemedit（默认 OP）。

物品名称

命令说明
/am itemname <名称>设置手中物品的显示名称（支持 & 颜色代码）
/am itemname clear清除物品自定义名称

物品 Lore

命令说明
/am itemlore add <文本>在末尾添加一行 Lore
/am itemlore set <行号> <文本>修改指定行的 Lore（1 起始）
/am itemlore remove <行号>删除指定行
/am itemlore insert <行号> <文本>在指定位置前插入一行
/am itemlore clear清空所有 Lore
/am itemlore list列出当前所有 Lore（带行号）

自定义 NBT

命令说明
/am itemnbt set <key> <类型> <值>设置自定义 NBT 标签
/am itemnbt remove <key>移除指定 NBT 标签
/am itemnbt list列出所有自定义 NBT

支持的数据类型: string(str) · int(i) · double(d) · long(l)。NBT 使用 PersistentDataContainer 存储，Key 前缀为 am_custom_，不影响原版数据。

其他物品指令

命令说明
/am itemamt <数量>设置手中物品数量（1-64）
/am itemcmd <数值>设置 CustomModelData（0 = 清除）
/am itemunbreak [true/false]切换无法破坏属性（省略参数则 toggle）

使用示例

# 给手中物品设置名称
/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

⚠ 目录结构说明: 旧的 manage/ 目录已完全废弃。所有功能配置集中到 Settings/ 目录（现为 15 个分组文件），运行时数据统一在 Saves/ 目录。 
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/                # 全息数据
设计理念: 将大量散落配置按功能合并到 Settings/ 分组文件，降低管理复杂度。所有模块开关集中在 Modules.yml，无需逐个文件查找 enabled 字段。运行时数据统一存放在 Saves/，便于备份和迁移。

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

所有功能模块的启停开关集中管理，禁用的模块完全停止工作，节省服务器资源。修改后使用 /am reload 重载。

# 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击杀奖励
性能提示: 禁用不需要的模块可以显著降低服务器负载。禁用后对应的事件监听器会在检测到 enabled=false 时立即返回，不执行任何逻辑。推荐在 300+ 玩家的服务器上禁用不使用的模块。

Settings 文件与模块对照表

Settings 文件包含的模块
MobControl.ymlspawner, mob-spawn, mob-drops, entity-cleaner
ItemsAndDrops.ymldeath-drop, block-drop, loot-table, item-bind
Cards.ymlfly-card, exp-card, custom-card
Economy.ymleconomy, counter, custom-recipe
Social.ymlred-packet, gift, invite, chat-monitor, announcement, join-message
Display.ymltab, hologram, bossbar-display, toast, feedback, gui-config
PlayerSystems.ymlplayer-attributes, player-stats, ranks, levelgroups, online-reward, monthly-pass, afk-reward
Commands.ymlquick-commands, world-rules
SuperSpawn.ymlsuperspawn
Kits.ymlkits
Gift.ymlgift
EventCommands.ymlevent-commands
MythicRewards.ymlmythic-rewards
Database.ymldatabase (独立开关)

反馈系统 NEW

# 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飞行已激活"

经济系统 NEW

详见 经济命令 中的配置示例。

数据库 NEW

# Settings/Database.yml
database:
  enabled: false  # database 模块使用独立开关
  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
自动建表: 启用后插件自动创建所有必要的MySQL表，无需手动执行SQL。

计数器 NEW

详见 计数器命令 中的配置示例。

支持的事件类型

事件说明JS上下文变量
ENTITY_KILL击杀实体event (EntityDeathEvent)
BLOCK_BREAK破坏方块event (BlockBreakEvent)
BLOCK_PLACE放置方块event (BlockPlaceEvent)
PLAYER_FISH钓鱼event (PlayerFishEvent)
CRAFT_ITEM合成物品event (CraftItemEvent)

GUI配置 NEW

# 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

实体清理 IMPROVED

新增功能

自定义配方 ENHANCED

支持的配方类型

类型说明
SHAPED有序合成 (工作台)
SHAPELESS无序合成 (工作台)
FURNACE熔炉
SMOKING烟熏炉
BLASTING高炉
STONECUTTING切石机
SMITHING_TRANSFORM锻造台

在线奖励配置 NEW

# Settings/PlayerSystems.yml → online-reward 部分
# 开关在 Modules.yml 中: online-reward: true
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

等级系统配置 NEW

# Settings/PlayerSystems.yml → ranks 部分
# 开关在 Modules.yml 中: ranks: true
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]
说明: 在 promote-requirements.custom-conditions 中可添加自定义条件，格式 "%placeholder% >= 100"，支持 >, <, >=, <=, == 运算符。
注意: rank-exp 为内置等级经验值，需要通过 /am rank exp 系列命令维护。

Kit 配置 NEW

# Settings/Kits.yml
# 开关在 Modules.yml 中: kits: true
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新手木剑"
提示: 礼包领取记录保存到 Saves/kit-data.yml。可通过 /kit reset 重置冷却与次数。

礼物配置 NEW

# Settings/Gift.yml
# 开关在 Modules.yml 中: gift: true
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
      sender-commands: []
      receiver-commands:
        - "eco give %target% 50 收到鲜花礼物"
      feedback:
        sender: "modules.gift.send"
        receiver: "modules.gift.receive"
提示: 礼物统计保存到 Saves/gift-data.yml，包含每日赠送/接收计数和全局冷却。

EventCommands 配置 NEW

# Settings/EventCommands.yml
# 开关在 Modules.yml 中: event-commands: true
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]"

pvpstart:
  Enabled: false
  Commands:
    - "actionbar! &c[playerName] 已进入PVP战斗状态"
支持前缀: delay!、perm:...!、msg!、broadcast!、actionbar!、title!、subtitle!、kickall!

发光系统配置 NEW

# Settings/Display.yml → glow 部分
# 开关在 Modules.yml 中: glow: true
glow:
  gui-title: "&6&l发光颜色"
  gui-size: 54
  clear-slot: 49
  clear-material: BARRIER
  clear-name: "&c取消发光"

  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"
    red:
      display-name: "&c红色"
      permission: "adventuremanage.glow.color.red"
      chat-color: RED
      leather-color: "#B02E26"

快捷指令配置 NEW

# Settings/Commands.yml → quick-commands 部分
# 开关在 Modules.yml 中: quick-commands: true
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

月卡系统配置 NEW

# Settings/PlayerSystems.yml → monthly-pass 部分
# 开关在 Modules.yml 中: monthly-pass: true
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每日奖励"
    shop-size: 27
    daily-size: 54

SuperSpawn 配置 NEW

# Settings/SuperSpawn.yml
# 开关在 Modules.yml 中: superspawn: false
spawnplus:
  # /spawn 独立命令
  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

  # 个人重生点 (优先级最高)
  # 通过命令 /am spawn setlocal 设置
  # 数据自动保存到 Saves/spawnplus-data.yml
提示: 组重生点按配置文件中的顺序检查，第一个权限匹配的组生效。建议将高优先级的组放在前面（如 admin 在 vip 之前）。

PAPI 占位符 (PlaceholderAPI)

标识符: %am_xxx%

玩家基本信息

占位符说明
%am_user_name%玩家名称
%am_user_displayname%显示名
%am_user_uuid%UUID
%am_user_online%在线状态（在线/离线）
%am_user_ping%延迟(ms)
%am_user_gamemode%游戏模式
%am_user_level%经验等级
%am_user_exp%当前等级已获得经验值
%am_user_exp_to_level%升级所需经验
%am_user_health%当前生命值
%am_user_max_health%最大生命值
%am_user_food%饥饿值
%am_user_world%所在世界
%am_user_biome%所在群系
%am_user_x/y/z%坐标
%am_user_ip%玩家 IP 地址
%am_user_flying%是否飞行

玩家状态 v4.1.0

占位符说明
%am_user_sneaking%是否潜行
%am_user_sprinting%是否疾跑
%am_user_sleeping%是否睡觉
%am_user_swimming%是否游泳
%am_user_blocking%是否举盾
%am_user_gliding%是否滑翔
%am_user_op%是否OP
%am_user_absorption%吸收伤害值
%am_user_armor%护甲值
%am_user_saturation%饱和度
%am_user_air%剩余氧气
%am_user_max_air%最大氧气
%am_user_locale%客户端语言
%am_user_first_played%首次进服时间
%am_user_last_played%上次登录时间

位置详情 v4.1.0

占位符说明
%am_user_yaw%视角偏航角
%am_user_pitch%视角俯仰角
%am_user_direction%朝向（北/南/东/西）
%am_user_light%当前亮度等级
%am_user_block_below%脚下方块类型
%am_user_world_time%世界时间 (tick)
%am_user_world_weather%世界天气（晴天/下雨/雷暴）
%am_user_world_env%世界环境类型

手持物品 / 装备 v4.1.0

占位符说明
%am_user_item_hand%手持物品类型
%am_user_item_hand_name%手持物品名称
%am_user_item_hand_amount%手持物品数量
%am_user_item_hand_durability%手持物品剩余耐久
%am_user_item_hand_max_durability%手持物品最大耐久
%am_user_empty_slots%背包空位数
%am_user_armor_helmet%头盔类型
%am_user_armor_chest%胸甲类型
%am_user_armor_legs%护腿类型
%am_user_armor_boots%靴子类型

游戏时长

占位符说明
%am_user_playtime%格式化总时长
%am_user_playtime_days%天数
%am_user_playtime_hours%小时部分
%am_user_playtime_minutes%分钟部分
%am_user_playtime_total_hours%总小时数
%am_user_online_seconds%累计在线秒数

经济

占位符说明
%am_user_balance%余额
%am_user_balance_formatted%格式化余额
%am_eco_treasury%国库余额 NEW
%am_eco_tax_rate%当前适用税率 NEW

统计数据

占位符说明
%am_user_blocks_broken%破坏方块数
%am_user_blocks_placed%放置方块数
%am_user_mob_kills%击杀生物数
%am_user_player_kills%PVP击杀数
%am_user_deaths%死亡次数
%am_user_fish_caught%钓鱼数
%am_user_items_crafted%合成物品数
%am_user_damage_dealt%伤害输出
%am_user_damage_taken%伤害承受

距离统计

占位符说明
%am_user_distance_walk%步行距离(米)
%am_user_distance_sprint%疾跑距离
%am_user_distance_swim%游泳距离
%am_user_distance_fly%飞行距离
%am_user_distance_boat%划船距离
%am_user_distance_horse%骑马距离
%am_user_distance_elytra%鞘翅距离

飞行卡

占位符说明
%am_fly_energy%飞行能量
%am_fly_max_energy%最大飞行能量
%am_fly_percent%能量百分比
%am_fly_status%飞行状态
%am_fly_active%是否有飞行能量
%am_user_tfly%飞行卡剩余(兼容CMI)

经验卡

占位符说明
%am_exp_multiplier%经验倍率
%am_exp_remaining%加成剩余时间
%am_exp_active%是否有经验加成

计数器 NEW

占位符说明
%am_counter_<ID>%获取指定计数器的值 (如 %am_counter_kill_zombie%)

服务器信息

占位符说明
%am_online%在线人数
%am_max_players%最大人数
%am_tps%服务器TPS
%am_tps_1m%1分钟TPS v4.1.0
%am_tps_5m%5分钟TPS v4.1.0
%am_tps_15m%15分钟TPS v4.1.0
%am_server_time%服务器时间
%am_server_name%服务器名称
%am_server_version%服务器版本
%am_server_uptime%运行时间
%am_server_ram_used%已用内存 MB v4.1.0
%am_server_ram_free%空闲内存 MB v4.1.0
%am_server_ram_max%最大内存 MB v4.1.0
%am_server_ram_percent%内存使用百分比 v4.1.0
%am_online_list%在线玩家列表(逗号分隔) v4.1.0
%am_version%插件版本

等级系统 NEW

占位符说明
%am_rank%当前等级名 (如 novice)
%am_rank_display%等级显示名 (带颜色, 如 &7新手)
%am_rank_prefix%等级前缀 (如 &7[新手])
%am_rank_exp%当前等级经验值
%am_rank_exp_required%当前等级升到下一级所需经验
%am_rank_exp_to_next%距离下一级还需经验
%am_rank_exp_percent%等级经验进度百分比

在线奖励 NEW

占位符说明
%am_online_today%今日在线分钟数
%am_online_total%累计在线分钟数

月卡系统 NEW

占位符说明
%am_pass_<ID>_active%是否拥有指定月卡 (如 %am_pass_basic_active%)
%am_pass_<ID>_days%月卡剩余天数 (如 %am_pass_basic_days%)

Kit 系统 NEW

占位符说明
%am_kit_available_count%当前玩家可领取的 Kit 数量
%am_kit_<kitId>_cooldown%指定 Kit 剩余冷却秒数
%am_kit_<kitId>_cooldown_formatted%指定 Kit 格式化冷却时间
%am_kit_<kitId>_claimed%指定 Kit 已领取次数
%am_kit_<kitId>_remaining%指定 Kit 剩余可领次数
%am_kit_<kitId>_available%指定 Kit 当前是否可领取（true/false）

Gift 系统 NEW

占位符说明
%am_gift_cooldown%赠送全局冷却剩余秒数
%am_gift_sent_<giftId>%今日已赠送指定礼物次数
%am_gift_received_<giftId>%今日已接收指定礼物次数
%am_gift_remaining_<giftId>%今日指定礼物剩余可赠送次数

等级组系统 NEW

占位符说明
%am_lg_<groupId>_level%等级组当前等级
%am_lg_<groupId>_exp%等级组当前经验
%am_lg_<groupId>_levelname%等级名称
%am_lg_<groupId>_maxlevel%等级组最大等级
%am_lg_<groupId>_minlevel%等级组最小等级
%am_lg_<groupId>_display%等级组显示名（带颜色）
%am_lg_<groupId>_nextexp%下一级所需经验
%am_lg_<groupId>_totalexp%本级升到下一级总经验需求
%am_lg_<groupId>_percent%升级进度百分比
%am_lg_<groupId>_progressbar%升级进度条
%am_lg_<groupId>_ismember%是否已加入该等级组
%am_lg_<groupId>_ismaxlevel%是否达到该等级组满级
提示: <groupId> 请替换为实际等级组 ID，例如 %am_lg_mining_level%。

开发者 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);

外部插件集成

插件用途状态
Vault经济系统、红包、配方费用软依赖
PlaceholderAPI占位符 (%am_xxx%)软依赖
PlayerPoints红包点券模式软依赖
Multiverse-Core多世界支持软依赖
ProtocolLib高级数据包控制软依赖
LuckPerms权限组集成软依赖
ItemsAdder自定义物品 (ia:)软依赖 NEW
CraftEngine自定义物品 (ce:)软依赖 NEW
MythicMobsMythicMobs击杀奖励软依赖

权限节点

权限说明默认
adventuremanage.admin管理员权限（包含所有子权限）op
adventuremanage.help查看帮助true
adventuremanage.reload重载配置op
adventuremanage.mob生物管理GUIop
adventuremanage.bind物品绑定true
adventuremanage.attr属性管理op
adventuremanage.loot战利品箱管理op
adventuremanage.afk挂机区域管理op
adventuremanage.invite邀请系统true
adventuremanage.clean手动清理实体op
adventuremanage.card卡片管理op
adventuremanage.holo全息文字管理op
adventuremanage.toastToast发送op
adventuremanage.eco经济管理op
adventuremanage.counter计数器管理op
adventuremanage.stats统计查看true
adventuremanage.tabTAB管理op
adventuremanage.eco.tax.exempt免税权限op
adventuremanage.craft打开工作台true
adventuremanage.trash打开垃圾桶true
adventuremanage.hat将物品戴在头上true
adventuremanage.ride骑乘其他玩家true
adventuremanage.sit坐下true
adventuremanage.lay躺下true
adventuremanage.enderchest打开末影箱true
adventuremanage.smithing打开锻造台true
adventuremanage.grindstone打开砂轮true
adventuremanage.stonecutter打开切石机true
adventuremanage.cartography打开制图台true
adventuremanage.loom打开织布机true
adventuremanage.riptide激流旋转true
adventuremanage.shulkerShift+右键打开潜影盒true
adventuremanage.rank.admin等级管理 (set/promote/demote/exp)op
adventuremanage.rank.view查看等级GUItrue
adventuremanage.glow.use使用发光系统命令/GUI NEWtrue
adventuremanage.glow.color.<color>使用指定发光颜色（如 yellow/red/blue） NEWfalse
adventuremanage.spawn.use使用 /spawn 传送 NEWtrue
adventuremanage.spawn.others使用 /spawn <玩家> 传送他人 NEWop
adventuremanage.spawn.bypasscooldown绕过 /spawn 冷却 NEWop
adventuremanage.spawn.adminSuperSpawn 重生点管理 NEWop
adventuremanage.spawn.group.<name>匹配组重生点权限 NEW无
adventuremanage.kit.use使用 /kit 领取礼包 NEWtrue
adventuremanage.kit.gui打开 Kit GUI NEWtrue
adventuremanage.kit.preview预览 Kit 内容 NEWtrue
adventuremanage.kit.adminKit 管理员操作 (give/reset) NEWop
adventuremanage.kit.bypass.cooldown绕过 Kit 冷却限制 NEWop
adventuremanage.kit.bypass.limit绕过 Kit 次数限制 NEWop
adventuremanage.gift.send使用礼物赠送功能 NEWtrue
adventuremanage.gift.gui使用礼物 GUI NEWtrue
adventuremanage.gift.admin礼物管理权限 NEWop
adventuremanage.gift.bypass.limit绕过礼物次数限制 NEWop
adventuremanage.gift.bypass.cooldown绕过礼物冷却限制 NEWop
adventuremanage.gift.bypass.cost绕过礼物经济消耗 NEWop
adventuremanage.gift.bypass.permission绕过礼物类型权限限制 NEWop
adventuremanage.eventcommands.adminEventCommands 管理权限 NEWop
adventuremanage.itemedit物品编辑 (itemname/itemlore/itemnbt/itemamt/itemcmd/itemunbreak) v4.1.0op

AdventureManage v4.1.0 © 2024-2026 Feiyes | QQ: 823959438 | playcraft.cn