📥 安装与依赖

环境要求

安装步骤

1. 安装 MythicMobs 插件（必需）
2. 将 AdventureSystem-X.X.jar 放入 plugins/ 文件夹
3. 重启服务器
4. 插件自动生成配置文件到 plugins/AdventureSystem/
5. 在 MythicMobs 中配置 BOSS 怪物（参考 BOSS 系统页面）

配置文件结构

plugins/AdventureSystem/
├── config.yml           # 主配置 (BOSS、奖励、寻宝、属性、生物控制)
├── team.yml             # 组队系统配置
├── events.yml           # 世界事件GUI和显示配置
├── messages.yml         # 消息文本配置
├── boss-loot.yml        # BOSS战利品表 (独立文件)
├── treasure-loot.yml    # 探索宝箱战利品表 (独立文件)
├── treasure-points.yml  # 宝箱点位数据 (自动生成)
└── menu/
    └── gui.yml          # GUI界面配置

MythicMobs BOSS 配置示例

# MythicMobs/Mobs/SkeletonKing.yml
SkeletonKing:
  Type: WITHER_SKELETON
  Display: '&c骷髅王●德理'
  Health: 500
  Damage: 15
  Options:
    MovementSpeed: 0.3
    KnockbackResistance: 0.5
  Equipment:
    - NETHERITE_SWORD HAND
    - NETHERITE_HELMET HEAD
  Skills:
    - message{msg="&c&l愚蠢的冒险者..."} @trigger ~onSpawn

👥 组队系统

概览

组队系统允许玩家组成最多 5 人小队，共同挑战 BOSS。BOSS 会锁定给距离最近的队伍，只有该队伍的成员可以对其造成伤害。

创建与管理

队伍规则

• 每个玩家只能同时加入 1 个队伍
• 第一个创建队伍的人自动成为队长
• 队长离线后，最早加入的成员自动继任队长
• 邀请默认 60 秒过期
• 支持跨世界组队 (可配置关闭)
• 没有队伍的玩家视为 solo 队伍，BOSS 仍会锁定

配置参考

# team.yml
max-size: 5                  # 最大队伍人数
invite-expire-seconds: 60    # 邀请过期时间(秒)
leave-on-quit: false         # 离线自动退队
cross-world: true            # 跨世界组队
create-cooldown: 0           # 创建冷却(秒)
invite-cooldown: 5           # 邀请冷却(秒)

💀 BOSS 系统

刷新机制

BOSS 通过 MythicMobs 生成，以随机在线玩家为锚点，在其周围 spawn-radius 格范围内刷新。

锁定机制

BOSS 刷新后会自动锁定给距离最近的玩家/队伍。锁定后：

• 只有该队伍成员可以对 BOSS 造成伤害
• 其他玩家攻击会收到 BOSS已被锁定 提示
• 锁定可转移 — 原队伍全员离开范围后，新队伍进入可接管

防叠刷

逃跑与清理

# 逃跑机制配置
boss:
  escape-distance: 40             # 超出此距离启动逃跑
  escape-countdown-seconds: 10    # 逃跑倒计时
  idle-escape-timeout-seconds: 300 # 5分钟无攻击强制清理
  escape-message: "&7[BOSS] %boss% 感到无聊，逃跑了..."

默认 BOSS 列表

🎯 仇恨系统

工作原理

每个 BOSS 维护一个独立的仇恨表。BOSS 会追踪仇恨值最高的玩家作为攻击目标。

• 攻击 BOSS — 产生仇恨 (基础 100 + 抗魔仇恨属性加成)
• 治疗队友 — 产生少量仇恨
• BOSS 追踪 — 每 threat-target-interval tick 更新目标
• 粒子标记 — 当前仇恨目标头顶显示红色粒子

配置

boss:
  default-threat: 100              # 初始仇恨值
  threat-target-interval: 20       # 目标更新间隔(tick)
  threat-particle-interval: 100    # 仇恨标记粒子间隔(tick)

抗魔仇恨属性

装备 Lore 中的 抗魔仇恨 +X 会增加每次攻击产生的仇恨值。坦克型玩家应堆叠正仇恨属性，输出型玩家可使用负仇恨避免被 BOSS 追击。

🛡️ 抗魔属性系统

概览

抗魔属性通过装备 Lore 文本提供。插件扫描玩家主手、副手和 4 个护甲槽的 Lore，识别 6 种属性并求和。

属性列表

扫描范围

属性从以下 6 个装备槽扫描：

• 主手 (Main Hand)
• 副手 (Off Hand)
• 头盔 (Helmet)
• 胸甲 (Chestplate)
• 护腿 (Leggings)
• 靴子 (Boots)

同一属性在多件装备上的值会求和叠加。

查看属性

# 查看当前装备的抗魔属性总和
/as attrs

# 输出示例:
# ========== 抗魔属性 ==========
# 抗魔仇恨: 15
# 抗魔护盾: 120/120 (总属性: 120)
# 抗魔伤害: 50.0 (额外HP: 5.0)
# 抗魔恢复冷却: 3.0秒 (冷却: 12.0秒 | 间隔: 5.0tick)
# 抗魔诅咒: 10.0%
# 抗魔掉宝: 25.0% (生效中)
# ==============================

💠 护盾系统

工作原理

护盾是独立于原版生命值的 MM 生物专用伤害吸收层。只有 MythicMobs 生物的攻击才会消耗护盾。

• 护盾最大值 = 装备的 抗魔护盾 属性总和 (+ 世界事件加成)
• 受到 MM 攻击 → 优先消耗护盾 → 护盾归零后才扣血
• 受击后进入冷却期 (默认 15 秒) → 冷却结束后开始恢复
• 恢复速度: 每 shield-regen-base-ticks tick 恢复 1 点

ActionBar 显示

# 护盾 ActionBar 格式
# 可用变量: %current% %max% %percent% %color%
shield-actionbar-format: "&7[ %color%%current%&7/%max% &7]"

# 颜色阈值
shield-actionbar-threshold-low: 0.30    # ≤30% 红色
shield-actionbar-threshold-mid: 0.70    # ≤70% 黄色
# >70% 绿色

# 颜色
shield-actionbar-color-low: "&c"
shield-actionbar-color-mid: "&e"
shield-actionbar-color-high: "&a"

恢复配置

🎁 战利品箱系统

流程

1. BOSS 被击败 → 死亡位置生成 MythicMobs 战利品箱实体
2. 锁定队伍成员右键点击宝箱
3. 打开 9 选 1 GUI — 9 个神秘箱子，各自有独立稀有度
4. 选择 1 个箱子 → 打开战利品 GUI → 获取物品
5. 宝箱在所有人开完或 180 秒后消失

稀有度系统

9 个箱子的稀有度由 BOSS 星级决定：

战利品表格式

# 支持两种物品来源
# 1. 原版物品
- material: DIAMOND_SWORD
  name: "&b&l霜之哀伤"
  lore: ["&7传说中的利剑"]
  amount: "1"
  chance: 0.1
  custom-model-data: 10001    # 可选

# 2. CraftEngine 自定义物品
- craftengine: "default:topaz_sword"
  amount: "1"
  chance: 1

🗺️ 探索寻宝系统

概览

在地图固定位置按概率生成 MythicMobs 宝箱实体，玩家右键打开获取战利品。

• 每个玩家每天独立 RNG 决定可见宝箱 (20%~100%)
• 每日每人限开 100 个宝箱 (北京时间 00:00 重置)
• 每个宝箱每人最多开 1 次
• 达到上限后剩余宝箱 渐隐消失

点位管理

# 管理命令
/as treasure add         # 在脚下创建宝箱点位
/as treasure remove <ID> # 删除指定点位
/as treasure list        # 列出所有点位
/as treasure refresh     # 重新随机并重生宝箱

配置

treasure:
  enabled: true
  mythicmob-type: "TreasureChest"   # MM怪物类型
  daily-limit: 100                   # 每日限额
  max-opens-per-chest: 1             # 每箱每人最多开次数
  spawn-distance: 80                 # 生成距离
  cleanup-distance: 60               # 清理距离
  player-spawn-chance-min: 0.2       # 最低可见概率 20%
  player-spawn-chance-max: 1.0       # 最高可见概率 100%
  chest-fadeout-seconds: 30          # 达上限后渐隐(秒)
  gui-title: "&e&l✦ 探索宝箱 ✦"
  gui-size: 27
  loot-min-items: 2
  loot-max-items: 5
  chest-opened-grace-seconds: 300    # 开后保留(秒)
  chest-opened-max-distance: 40      # 开后离开距离

🌍 世界事件系统

概览

每 6 小时（可配置）随机刷新 1~5 个全局事件，影响所有在线玩家。事件分为正面增益和负面诅咒，多个事件的效果叠加。

事件分类

事件 GUI

使用 /as event gui 打开事件查看界面，显示所有可能的事件及其当前状态。

PlaceholderAPI 变量

管理命令

/as event refresh        # 立即刷新事件
/as event clear          # 清除所有事件
/as event add <类型>     # 手动添加事件
/as event gui            # 打开事件GUI

🐾 世界生物生成控制

概览

可针对特定世界禁止/允许特定类型的生物自然生成。不影响 MythicMobs 生成、指令生成、刷怪蛋生成。

两种模式

黑名单模式 (blocked)

mob-control:
  worlds:
    world:
      blocked:
        - WANDERING_TRADER
        - TRADER_LLAMA

白名单模式 (allowed-only)

mob-control:
  worlds:
    resource_world:
      allowed-only:
        - COW
        - SHEEP
        - PIG
        - CHICKEN

⚙️ config.yml 主配置

config.yml 是插件的核心配置文件，包含 BOSS 设置、奖励系统、寻宝系统、属性系统和生物控制。

主要节

📋 team.yml 组队配置

# 组队系统配置
max-size: 5                  # 最大队伍人数
invite-expire-seconds: 60    # 邀请过期时间(秒)
leave-on-quit: false         # 离线自动退队
cross-world: true            # 跨世界组队
create-cooldown: 0           # 创建冷却(秒, 0=无)
invite-cooldown: 5           # 邀请冷却(秒, 0=无)

📜 events.yml 事件配置

控制事件 GUI 显示、分类名称、每个事件的名称/材质/描述。详见 世界事件 页面。

GUI 配置

gui:
  title: "&6&l✦ 世界事件系统 ✦"
  items-per-page: 45
  empty-slot-material: GRAY_STAINED_GLASS_PANE
  border-material: BLACK_STAINED_GLASS_PANE

事件显示配置示例

event-display:
  crit_storm:
    display-name: "暴击风暴"
    material: GOLDEN_SWORD
    category: combat
    positive: true
    description:
      - "&a攻击BOSS时有概率造成双倍伤害"
      - "&6I级 15%概率 | II级 25%概率"

💬 messages.yml 消息配置

messages:
  prefix: "&7[&6冒险&7] "
  team-created: "&a你创建了一个队伍！"
  team-disbanded: "&c队伍已解散。"
  team-full: "&c队伍已满（最多%max%人）。"
  team-invite-sent: "&a已向 &e%player% &a发送了组队邀请。"
  team-invite-received: "&a玩家 &e%player% &a邀请你加入队伍..."
  team-joined: "&a%player% 加入了队伍！"
  team-left: "&e%player% 离开了队伍。"
  boss-reward-received: "&a恭喜！击败BOSS &6%boss% &a获得奖励: %reward%"
  boss-team-locked: "&c该BOSS已被锁定给其他队伍！"

boss:
  spawn-message: "&c[BOSS] 出现BOSS %boss% 首选目标 %player%"
  escape-message: "&7[BOSS] %boss% 感到无聊，逃跑了..."
  transfer-message: "&e[BOSS] %boss% 的锁定已转移给 %player%"

events:
  announce-header: "&6══════ 世界事件刷新 ══════"
  announce-line: "&6 ▶ %color%%event_name% %event_value%"
  announce-footer: "&6═══════════════════════"

可用变量

⌨️ 命令列表

组队命令 /zd

另外：Shift + 右键点击玩家可快速发送邀请。

管理命令 /as

🔐 权限节点

🔗 PlaceholderAPI 变量

安装 PlaceholderAPI 后自动注册，前缀为 ptb。

CMI TAB 配置示例

# CMI TAB footer 配置
footer:
  - "&6当前事件:"
  - "%ptb_events%"

❓ 常见问题

Q: BOSS 不刷新

A: 排查步骤：

1. 确认 MythicMobs 已安装且 BOSS 配置正确
2. 确认 boss.boss-list 中的名称与 MM 配置一致
3. 确认在线玩家数 ≥ min-players
4. 使用 /as spawn SkeletonKing 手动测试
5. 检查是否在冷却区域内 (cooldown-duration-seconds: 600)

Q: 击败 BOSS 没有奖励箱

A: 检查 rewards.reward-chest-type 对应的 MythicMobs 怪物是否存在。如果 MM 箱子实体生成失败，会回退到直接发放 boss-rewards 奖励。

Q: 护盾不显示

A: 护盾需要装备含 抗魔护盾 +X Lore 的物品。如果属性为 0，ActionBar 不会显示。使用 /as attrs 检查。

Q: 抗魔掉宝显示"未生效"

A: 掉宝属性需要持续装备 60 秒才会生效，防止临时切换装备作弊。

Q: 事件变量在 TAB 不显示

A: 需要同时安装 PlaceholderAPI。变量前缀是 ptb 不是 as。

Q: 从 PlayTeamBoss 升级

A: 插件会自动将 plugins/PlayTeamBoss 文件夹重命名为 plugins/AdventureSystem，配置文件完全兼容。

📝 更新日志

v3.3 — 出生保护 + 性能优化 + Wiki重设计

• 出生保护 玩家刚到世界时30格内不触发BOSS刷新，需跑出区域
• 性能优化 护盾ActionBar从1tick降至5tick、护盾恢复从1tick降至2tick、AFK移动检测优化为整格比较
• Wiki重设计 更换字体为 LXGW WenKai + Inter，加大字号，优化排版

v3.2 — 9项BUG修复与优化

• NPC组队屏蔽 右键NPC不再触发组队邀请
• AFK防泛滥BOSS 20分钟无活动+10格内未离开→AFK，5/10分钟冷却
• 中文BOSS名 /as status 使用中文显示名，"solo"→"已锁定"
• 事件GUI排序 当前激活事件排到最前面
• 寻宝测试指令 /as treasure test 和 retest
• 安全重载 /as reload 不重置运行时数据
• 日志开关 BOSS刷出/清理/转移日志可配置

v3.1 — 世界生物控制GUI

• 生物控制GUI /as mob 打开54格界面，90+生物蛋、分类开关、概率/密度控制

v3.0 — AdventureSystem 重构

• 重命名 PlayTeamBoss → AdventureSystem
• 新增 战利品箱系统 (BOSS 死亡生成宝箱实体, 9选1 GUI)
• 新增 BOSS 星级稀有度 (1~5星影响宝箱品质)
• 新增 CraftEngine 物品支持 (战利品表和探索宝箱)
• 新增 自动迁移旧数据文件夹
• 新增 生物生成控制系统 (黑名单/白名单)
• 新增 战斗事件类型: 暴击风暴、生命汲取、铁壁防御、BOSS狂暴等
• 新增 宝箱事件类型: 宝箱多选/升品/降品、寻宝热潮/荒芜、护盾碎裂/强化
• 优化 配置文件结构 (独立 boss-loot.yml, treasure-loot.yml)

v2.x — 事件与寻宝

• 新增 世界事件系统 (40+ 事件类型, 6小时轮换)
• 新增 事件 GUI 查看器
• 新增 PlaceholderAPI 事件变量
• 新增 探索寻宝系统 (固定点位, 每人独立RNG)
• 新增 抗魔掉宝防作弊 (持有时间检测)

v1.x — 初始版本

• 组队系统 (5人小队, GUI界面)
• BOSS 锁定与仇恨系统
• 抗魔属性系统 (6种Lore属性)
• 护盾系统 (ActionBar显示, 冷却恢复)
• 基础 BOSS 奖励