Spawn

I. Fixed Spawn Point Feature (spawns)

Configuration folder location: spawns

Used to define monster fixed spawn points, including coordinates, time, etc.

Fixed Spawn Point Configuration Example

# This is a spawn point example file (spawns)
# Each spawn point binds to a template via mobId

# Spawn point key, customizable; final spawnId = filename#key
TestSpawnPoint:
  # Corresponds to template key in mobs (pure key, globally unique)
  mobId: "TestTemplate"
  # Whether enabled
  enable: true
  # Spawn time in seconds
  time: 10
  # Last spawn time
  lastSpawnTime: 0
  # Spawn quantity
  number: 1
  # Maximum spawn quantity
  maxNumber: 1
  # Whether to show HD hologram countdown
  hdTip: true
  # Pause spawning while a player is within this distance, 0 = unlimited
  playerSpawnDistance: 0
  # Spawn level range, leave empty to use the level of the mobs template
  level: "10,30"
  # Spawn coordinates
  world: "world"
  x: -321
  y: 64.0
  z: -7

Fixed Spawn Point Configuration Details

1. Basic Configuration

• Spawn Point Key: Custom name, must be unique, final spawnId = filename#key
• mobId: Bound monster template key (corresponds to templates in mobs folder)
• enable: Whether to enable this spawn point
  • true: Enabled
  • false: Disabled

2. Spawn Control

• time: Spawn interval time (unit: seconds, default 60)
• lastSpawnTime: Last spawn time (automatically recorded by system, no manual setup needed)
• number: Number of monsters spawned each time (default 1)
• maxNumber: Maximum existence quantity, stops spawning when monster quantity in area reaches this value (default 1)
  • If number is greater than maxNumber, maxNumber is used

3. Visual Effects

• hdTip: Whether to show hologram countdown
  • true: Show countdown hologram
  • false: Do not show

4. Monster Level

• level: Spawn point level range
  • Fixed value: 10
  • Random range: 10,30, 10-30 or 10~30 (inclusive on both ends)
  • Leave empty to use the level of the mobs template
  • If neither is configured, a random level is generated from randomLevel in config.yml plus the distanceLevel bonus

5. Coordinate Configuration

• world: World name
• x: X-axis coordinate
• y: Y-axis coordinate
• z: Z-axis coordinate

6. Spawn Condition

• playerSpawnDistance: Pause spawning while a player is within this distance
  • 0: Unlimited
  • Greater than 0: Spawning is paused when a player enters the range

II. Quick Spawn Template Feature (fastSpawn.yml)

Configuration file location: fastSpawn.yml

Used to quickly generate preset monster combinations, suitable for events or temporary needs

Quick Spawn Configuration Example

# Soldier quick spawn template
soldier:
  # Spawn time
  time: 60
  # Spawn quantity
  number: 3
  # Maximum quantity
  maxNumber: 10
  # Level
  level: 1,20

# Elite quick spawn template
boss:
  # Spawn time
  time: 3600
  # Spawn quantity
  number: 1
  # Maximum quantity
  maxNumber: 1
  # Level
  level: 100

Quick Spawn Configuration Details

1. Template Basic Configuration

• Template Key: Custom name, used for command invocation
• time: Spawn interval time (unit: seconds)
• number: Number of monsters spawned each time
• maxNumber: Maximum existence quantity

2. Monster Level

• level: Level range
  • Fixed value: 100 means a fixed level 100
  • Random range: 1,20, 1-20 or 1~20 means level 1-20
  • It is written into the spawn point when created by createSpawn, using the same syntax as the spawn point level

III. Notes

1. Relationship between mobs and spawns

   • mobs define monster abilities (skills, attributes, etc.)
   • spawns define spawn locations and times
   • Both work together to achieve complete functionality

2. ID Naming Rules

   • All keys must be globally unique
   • Avoid using special characters
   • Chinese or English is recommended

3. Level Priority

   • Spawn point level > mobs template level > random level from randomLevel in config.yml