生成系统

一、固定刷新点功能（spawns）

配置文件夹位置：spawns

用于定义怪物的固定刷新点，包含坐标、时间等信息

固定刷新点配置示例

# 这是刷新点示例文件 (spawns)
# 每个刷新点通过 mobId 绑定模板

# 刷新点 key，可自定义；最终 spawnId = 文件名#key
测试刷新点:
  # 对应 mobs 里的模板 key（纯 key，全局唯一）
  mobId: "测试模板"
  # 是否开启
  enable: true
  # 刷新时间 秒
  time: 10
  # 最后生成时间
  lastSpawnTime: 0
  # 刷新个数
  number: 1
  # 最大刷新个数
  maxNumber: 1
  # 是否生成 hd 全息图倒计时
  hdTip: true
  # 玩家在刷新点多少格内时不刷新，0 表示不限制
  playerSpawnDistance: 0
  # 刷新的等级范围，留空则使用 mobs 模板的等级
  level: "10,30"
  # 刷新的坐标
  world: "world"
  x: -321
  y: 64.0
  z: -7

固定刷新点配置项详解

1. 基础配置

• 刷新点 Key: 自定义名称，必须唯一，最终 spawnId = 文件名#key
• mobId: 绑定的怪物模板 key（对应 mobs 文件夹中的模板）
• enable: 是否启用该刷新点
  • true: 启用
  • false: 禁用

2. 刷新控制

• time: 刷新间隔时间（单位：秒，默认 60）
• lastSpawnTime: 最后生成时间（系统自动记录，无需手动设置）
• number: 每次刷新生成的怪物数量（默认 1）
• maxNumber: 最大存在数量，当区域内怪物数量达到此值时停止刷新（默认 1）
  • number 大于 maxNumber 时会自动按 maxNumber 处理

3. 视觉效果

• hdTip: 是否显示全息图倒计时
  • true: 显示倒计时全息图
  • false: 不显示

4. 怪物等级

• level: 刷新点的等级范围
  • 固定值：10
  • 随机范围：10,30、10-30、10~30（闭区间，包含两端）
  • 留空时使用 mobs 模板中的 level
  • 刷新点与模板都未配置时，按 config.yml 的 randomLevel 随机，并叠加 distanceLevel 距离加成

5. 坐标配置

• world: 世界名称
• x: X 轴坐标
• y: Y 轴坐标
• z: Z 轴坐标

6. 刷新条件

• playerSpawnDistance: 玩家在刷新点多少格内时不刷新
  • 0: 不限制
  • 大于 0: 有玩家进入该范围时暂停刷新

二、快捷生成模版功能（fastSpawn.yml）

配置文件位置：fastSpawn.yml

用于快速生成预设的怪物组合，适合活动或临时需求

快捷生成配置示例

# 小兵快捷生成模版
soldier:
  # 刷新时间
  time: 60
  # 刷新数量
  number: 3
  # 最大数量
  maxNumber: 10
  # 等级
  level: 1,20

# 精英快捷生成模版
boss:
  # 刷新时间
  time: 3600
  # 刷新数量
  number: 1
  # 最大数量
  maxNumber: 1
  # 等级
  level: 100

快捷生成配置项详解

1. 模版基础配置

• 模版 Key: 自定义名称，用于指令调用
• time: 刷新间隔时间（单位：秒）
• number: 每次刷新生成的怪物数量
• maxNumber: 最大存在数量

2. 怪物等级

• level: 等级范围
  • 固定值：100 表示固定 100 级
  • 随机范围：1,20、1-20、1~20 表示 1-20 级
  • 通过 createSpawn 生成刷新点时会写入该等级，写法与刷新点 level 一致

三、注意事项

1. mobs 与 spawns 的关系

   • mobs 定义怪物能力（技能、属性等）
   • spawns 定义刷新位置和时间
   • 两者配合使用实现完整功能

2. ID 命名规则

   • 所有 key 必须全局唯一
   • 避免使用特殊字符
   • 建议使用中文或英文

3. 等级优先级

   • 刷新点 level > mobs 模板 level > config.yml 的 randomLevel 随机等级