⚔️ KKModQ 插件使用教程

📖 插件简介

KKModQ 是一个强大的波次挑战副本插件，支持无限波次、多房间、多刷新点，与 MythicMobs 深度集成，为您的服务器打造独特的 PVE 挑战体验。

✨ 核心特性

🚀 安装教程

📝 指令大全

🎮 玩家指令（无需权限）

👑 管理员指令（需要 kkmodx.admin 权限）

房间管理

冷却管理 推荐

系统管理

组队与体力

实例与区域模板

🏅 权限系统

⚙️ 配置文件介绍

📄 主配置文件 (config.yml)

位置：plugins/kkmodQ/config.yml

基本设置

# 插件基本设置
settings:
  # 组队系统
  party:
    enabled: true        # 是否启用组队系统
    max-size: 6          # 队伍最大人数
  
  # 进入副本后的准备时间（秒）
  start-delay: 5
  
  # 波次间隔时间（秒）
  wave-delay: 5
  
  # 是否显示倒计时（推荐开启）
  show-countdown: true
  
  # 是否显示详细信息
  verbose: true
  
  # 是否保存玩家数据
  save-player-data: true
  
  # 玩家全部离开后是否清除怪物（推荐开启）
  clear-mobs-on-empty: true

指令保护

# 副本中指令保护
command-protect: true    # 是否启用指令保护

# 允许使用的指令白名单（插件自身指令始终允许）
allowed-commands:
  - "si"           # 允许 /si 及其所有子命令
  - "menu"         # 允许 /menu 指令
  - "warp"         # 允许 /warp 指令

其他设置

# 掉线保护
disconnect-protection: true

# 副本区域检测范围（格）
dungeon-area-radius: 100

# 是否显示奖励消息
show-reward-message: true

# 离开副本后的传送位置
# world_spawn = 世界出生点 | bed = 床出生点 | custom = 自定义坐标
leave-type: world_spawn

# 自定义离开位置（仅当 leave-type: custom 时生效）
leave-location: 'world:0:64:0:0:0'

消息配置

# 消息配置（支持颜色代码）
messages:
  prefix: "&7[&bKKMod&7]"
  room-created: "&a成功创建房间: &e{room}"
  room-joined: "&a已加入房间: &e{room}"
  room-left: "&a已离开房间"
  room-full: "&c房间已满"
  wave-start: "&e第 {wave} 波开始！共 {count} 只怪物"
  wave-complete: "&a第 {wave} 波完成！"

🏠 房间配置文件 (rooms/<房间ID>.yml)

位置：plugins/kkmodQ/rooms/<房间ID>.yml

冷却时间

# 冷却时间（秒）
cooldown: 3600
# 0=无冷却 | 1800=30分钟 | 3600=1小时 | 7200=2小时 | 86400=1天
# VIP可享受冷却减免：VIP1(10%) VIP2(20%) ... VIP6(80%)

房间基本配置

room:
  # 出生点（命令: /kkmodx create <ID> <人数>）
  spawn-location: world:100.5:64.0:200.5:0.0:0.0
  
  # 复活点（命令: /kkmodx setrespawn <ID>）
  respawn-location: world:100.5:64.0:200.5:0.0:0.0
  
  # 最大玩家数
  max-players: 4
  
  # 显示名称（支持颜色代码）
  display-name: "恶魔之塔"
  
  # 房间描述（GUI中显示）
  description:
    - "&7难度: &c困难"
    - "&7推荐人数: &e2-4人"
    - ""
    - "&6挑战无尽的怪物波次"
    - "&c第11波有强力BOSS！"

继续闯关功能

  # 继续闯关功能
  continue-enabled: true           # 是否启用
  continue-base-cost: 1000.0       # 费用计算: 波次 × 基数
  # 例: 第10波 = 10000金币

GUI 显示配置

  # GUI显示位置
  gui-slot: -1                     # -1=自动 | 手动: 10-16,19-25,28-34,37-43
  gui-icon: DIAMOND_BLOCK          # 图标材质（null=使用默认）

时间限制功能 新功能

  # 时间限制功能
  time-limit-enabled: true         # 是否启用时间限制
  wave-time-limit: 120             # 每波时间限制（秒）-1=无限制
  # 注意：未在规定时间内击败所有怪物将导致挑战失败

怪物刷新点

  # 怪物刷新点（命令: /kkmodx add <ID>）建议2-4个
  mob-spawn-points:
    - world:110.5:64.0:210.5:0.0:0.0
    - world:90.5:64.0:210.5:0.0:0.0
    - world:110.5:64.0:190.5:0.0:0.0
    - world:90.5:64.0:190.5:0.0:0.0

波次配置

# 波次配置（怪物ID必须在MythicMobs中存在）
waves:
  # all：每一波都会触发的基础怪物
  all:
    mob-type:
      普通猪: 3
    amount: 3
    attribute-scaling:
      enabled: true
      health-per-wave: 0.05
      damage-per-wave: 0.05
  
  # ten：10倍数波（10,20...，但不含100,200...）
  'ten':
    mob-type:
      八眼魔蛛10: 3
    amount: 3
  
  # hundred：100倍数波（100,200...，但不含1000,2000...）
  'hundred':
    mob-type:
      火焰恶魔Boss: 1
      精英护卫: 4
    amount: 5
  
  # tenthousand：实际表示1000倍数波
  'tenthousand':
    mob-type:
      深渊领主: 1
      暗影守卫: 6
    amount: 7
  
  # 范围波次：第1到1000波都会额外触发
  '1-1000':
    mob-type:
      普通猪BOSS20: 1
      八眼魔蛛10BOSS20: 1
    amount: 2
  
  # 特定波次列表：支持中英文逗号
  '1000,2000,3000,6000':
    mob-type:
      普通猪BOSS30: 1
      八眼魔蛛10BOSS30: 1
    amount: 2
  
  # 单波BOSS
  '50':
    mob-type:
      第50波特殊BOSS: 1
    amount: 1

奖励系统配置

# 奖励配置（支持概率、波次变量、数学表达式）
# 变量: {player}=玩家名 {uuid}=玩家UUID {波次}/{wave}=当前波次
# 表达式: {{波次 * 2}}、{{波次 * (波次 + 10)}}
rewards:
  # 每波基础奖励
  all:
    - eco give {player} 500
    - LegendWarehouse add {player} mm-玄铁 {波次}
  
  # 10倍数波奖励
  'ten':
    - exp give {player} {{波次 * 2}}
    - give {player} iron_ingot 3 30%
  
  # 100倍数波奖励
  'hundred':
    - eco give {player} {{波次 * 100}}
    - broadcast &6玩家 {player} 完成了第 {波次} 波挑战！
  
  # 特定波次列表奖励
  '1000,2000,3000,6000':
    - give {player} nether_star 1
    - exp give {player} {{波次 * (波次 + 10) - 波次}}

📌 PlaceholderAPI 变量

如果服务器安装了 PlaceholderAPI，就可以在记分板、TAB、聊天、菜单、悬浮文本等位置调用 KKModQ 的排行榜和个人数据变量。

总排行榜变量

房间排行榜变量

玩家个人变量

玩家房间最高波次变量

# 旧格式
%kkmodq_player_room_boss_wave%

# 新格式（更简洁，推荐）
%kkmodq_boss_player_wave%

使用示例

# HolographicDisplays 总榜前3
/hd addline 总排行榜 &6第1名: &f%kkmodq_top_total_1_player% &e- &c%kkmodq_top_total_1_wave%波
/hd addline 总排行榜 &6第2名: &f%kkmodq_top_total_2_player% &e- &c%kkmodq_top_total_2_wave%波
/hd addline 总排行榜 &6第3名: &f%kkmodq_top_total_3_player% &e- &c%kkmodq_top_total_3_wave%波

# 侧边栏个人数据
总波次: %kkmodq_player_total_waves%
最高波次: %kkmodq_player_highest_wave%
总击杀: %kkmodq_player_total_kills%

🎨 GUI 配置文件 (gui.yml)

位置：plugins/kkmodQ/gui.yml

# GUI 基本设置
gui:
  # GUI 标题
  title: "§8§l═══ 副本选择 ═══"
  
  # GUI 大小（必须是 9 的倍数，最大 54）
  size: 54
  
  # 是否启用装饰
  enable-decoration: true

# 副本图标材质配置
dungeon-icon:
  materials:
    idle: DIAMOND_BLOCK        # 空闲状态（默认）
    active: DIAMOND_HELMET     # 进行中状态
    cooldown: REDSTONE_BLOCK   # 冷却中状态
    unconfigured: BARRIER      # 未配置状态

# 音效配置
sounds:
  enabled: true
  open-gui: BLOCK_CHEST_OPEN      # 打开 GUI
  click-success: ENTITY_PLAYER_LEVELUP  # 成功操作
  click-error: ENTITY_VILLAGER_NO       # 错误操作

🚀 快速开始指南

第一步：创建副本房间

第二步：配置波次和怪物

waves:
  all:
    mob-type:
      僵尸: 5
    amount: 5
    attribute-scaling:
      enabled: true
      health-per-wave: 0.05
      damage-per-wave: 0.05

  'ten':
    mob-type:
      精英僵尸: 2
    amount: 2

rewards:
  all:
    - eco give {player} 500
    - LegendWarehouse add {player} mm-玄铁 {波次}
  'ten':
    - give {player} diamond 1 20%
    - exp give {player} {{波次 * 2}}

第三步：开始游戏

🔧 进阶配置

📍 区域复制粘贴功能 (pos1)

使用区域复制功能可以快速创建多个相似的副本房间，大大提高配置效率。

功能说明

通过设置两个坐标点（pos1 和 pos2）来定义一个区域，然后复制该区域的所有配置信息（出生点、刷新点、复活点）到新的房间。

使用步骤

/kkmodx pos1

/kkmodx pos2

/kkmodx copy <源房间ID>

/kkmodx paste <新房间ID>

完整指令列表

使用示例

# 场景：已有一个配置好的 tower1，想复制到新位置创建 tower2

# 1. 在 tower1 区域的一角执行
/kkmodx pos1
提示：已设置坐标点1: world (100, 64, 200)

# 2. 移动到 tower1 区域的对角执行
/kkmodx pos2
提示：已设置坐标点2: world (150, 80, 250)
提示：区域大小: 50x16x50

# 3. 复制 tower1 的配置
/kkmodx copy tower1
提示：已复制房间 tower1 的配置（出生点x1, 刷新点x4, 复活点x1）

# 4. 移动到新位置（tower2 的中心点）
/kkmodx paste tower2
提示：已创建新房间 tower2
提示：已粘贴 出生点x1, 刷新点x4, 复活点x1
提示：配置文件已生成: rooms/tower2.yml

# 5. 重载配置
/kkmodx reload
提示：配置重载完成！

📈 怪物属性缩放系统 强力功能

属性缩放系统可以让怪物的生命值和攻击力随着波次递增而自动提升，为玩家提供渐进式的挑战难度。

功能原理

每波怪物的属性会根据当前波次数计算出一个倍率，然后应用到怪物的基础属性上。使用指数增长算法，越往后波次难度增长越快。

计算公式

配置方式

在房间配置文件的波次配置中添加 attribute-scaling 节点：

waves:
  # 示例：第1-50波配置
  1-50:
    mob-type:
      僵尸: 8
      骷髅: 4
    amount: 12
    
    # 添加属性缩放配置
    attribute-scaling:
      enabled: true              # 是否启用（true=启用 | false=关闭）
      health-per-wave: 0.10      # 每波生命值增长百分比（0.10 = 10%）
      damage-per-wave: 0.08      # 每波攻击力增长百分比（0.08 = 8%）

参数详解

不同难度的推荐配置

attribute-scaling:
  enabled: true
  health-per-wave: 0.05  # 5%
  damage-per-wave: 0.05  # 5%

attribute-scaling:
  enabled: true
  health-per-wave: 0.08  # 8%
  damage-per-wave: 0.08  # 8%

attribute-scaling:
  enabled: true
  health-per-wave: 0.12  # 12%
  damage-per-wave: 0.10  # 10%

attribute-scaling:
  enabled: true
  health-per-wave: 0.15  # 15%
  damage-per-wave: 0.12  # 12%

完整配置示例

# 完整的波次配置示例（带属性缩放）
waves:
  # 第1-10波：新手阶段（缓慢增长）
  1-10:
    mob-type:
      僵尸: 5
    amount: 5
    attribute-scaling:
      enabled: true
      health-per-wave: 0.05
      damage-per-wave: 0.05
  
  # 第11波：BOSS波（不使用缩放，固定难度）
  '11':
    mob-type:
      精英BOSS: 1
    amount: 1
    # BOSS波不添加 attribute-scaling，保持固定强度
  
  # 第12-50波：进阶阶段（中等增长）
  12-50:
    mob-type:
      僵尸: 10
      骷髅: 5
    amount: 15
    attribute-scaling:
      enabled: true
      health-per-wave: 0.08
      damage-per-wave: 0.08
  
  # 第51-100波：挑战阶段（快速增长）
  51-100:
    mob-type:
      精英僵尸: 15
      精英骷髅: 10
    amount: 25
    attribute-scaling:
      enabled: true
      health-per-wave: 0.12
      damage-per-wave: 0.10

实战数据对比表

❓ 常见问题

Q1: 怪物没有生成怎么办？

Q2: 如何修改冷却时间？

Q3: VIP冷却减免如何设置？

Q4: 怎么让玩家免费使用继续功能？

Q5: 如何设置单波BOSS？

waves:
  '10':    # 注意：单引号必须加
    mob-type:
      终极BOSS: 1
    amount: 1

Q6: 属性缩放功能如何使用？

waves:
  1-50:
    mob-type:
      僵尸: 10
    amount: 10
    attribute-scaling:
      enabled: true
      health-per-wave: 0.10  # 每波生命+10%
      damage-per-wave: 0.10  # 每波攻击+10%

Q7: 如何补偿玩家因Bug损失的冷却？

Q8: 奖励系统如何配置概率？

rewards:
  1-10:
    - eco give {player} 500           # 100% 给予
    - give {player} diamond 1 20%    # 20% 概率
    - give {player} emerald 3 50%    # 50% 概率

Q9: 为什么修改配置后没有生效？

Q10: 如何查看插件版本和状态？

感谢使用 KKModQ 插件！

如有问题，请联系插件作者或查看项目文档

版本 5.0-SNAPSHOT 完整教程 含进阶配置

💬 技术交流QQ群：85504171