Zones

Overview

This configuration file defines the "Barn" zone, which serves as the default starting zone for players. Zones are created by placing YAML files in the zones/ folder, where the filename (without .yml) becomes the zone ID. The stage system and all mobs are completely customizable.

---

Basic Zone Settings

world

• Value: world

• Description: The world name where this zone is located

min-corner

• Value: 0,0,0

• Description: Minimum corner coordinates of the zone boundary (X,Y,Z format)

max-corner

• Value: 0,0,0

• Description: Maximum corner coordinates of the zone boundary (X,Y,Z format)

spawn

• Value: 0,0,0,180,0

• Description: Player spawn location when entering this zone (X,Y,Z,Yaw,Pitch format)

name

• Value: 'Barn'

• Description: Display name of the zone shown to players

---

Mob Mechanics

mob-respawn-time

• Value: 100

• Description: Time in ticks (20 ticks = 1 second) before a new mob spawns after one is killed

• Note: 100 ticks = 5 seconds

max-mobs

• Value: 20

• Description: Maximum number of active mobs allowed in this zone at once

• Important: You must have more spawn locations than the max-mobs value

---

Stage System

The stage system is completely customizable. You can create any number of stages with any configuration you want.

Stage Structure

Each stage can contain:

AFK Mobs Section

afk-mobs:
  '1':
    mob: 'your-mob-id'
    position: x,y,z
    yaw: degrees
    pitch: degrees

Active Mobs Section

mobs:
  '1':
    mob: 'your-mob-id'
    chance: decimal (0.0 to 1.0)
    yaw: degrees (optional)
    pitch: degrees (optional)

Configuration Options

For AFK Mobs:

• mob - The mob ID (references mob configurations)

• position - Fixed spawn position (X,Y,Z)

• yaw - Rotation angle (0-360 degrees)

• pitch - Vertical angle (-90 to 90 degrees)

For Active Mobs:

• mob - The mob ID (references mob configurations)

• chance - Spawn probability (must total ≤ 1.0 across all mobs in stage)

• yaw - Optional custom rotation

• pitch - Optional custom vertical angle

---

Example Configuration Analysis

This barn zone example shows a 10-stage progression:

Stage 1 Example:

• AFK mob: chicken-afk at standard position

• 5 different active mobs with varying rarities

• Special flowey mob with custom rotation

• Chances total: 0.7 + 0.15 + 0.1 + 0.04 + 0.01 = 1.0

Typical Stage Pattern:

• Most stages follow a 4-mob rarity system

• Common (70%), Rare (15%), Epic (10%), Legendary (5%)

• Each stage features different animal themes

---

Spawn Locations

locations

• Value: [] (empty array)

• Description: List of possible spawn coordinates for active mobs

• Format: Each location should be x,y,z coordinates

• Example:

yaml

locations:
  - "10,64,20"
  - "15,64,25"
  - "5,64,30"

---

Customization Examples

Adding a New Stage

'11':
  afk-mobs:
    '1':
      mob: 'dragon-afk'
      position: 0,70,0
      yaw: 0
      pitch: 0
  mobs:
    '1':
      mob: 'dragon-baby'
      chance: 0.8
    '2':
      mob: 'dragon-adult'
      chance: 0.2

Custom Mob Chances

mobs:
  '1':
    mob: 'common-mob'
    chance: 0.5
  '2':
    mob: 'uncommon-mob'
    chance: 0.3
  '3':
    mob: 'rare-mob'
    chance: 0.15
  '4':
    mob: 'ultra-rare-mob'
    chance: 0.05

Multiple AFK Mobs

afk-mobs:
  '1':
    mob: 'guard-mob'
    position: 10,64,10
    yaw: 90
    pitch: 0
  '2':
    mob: 'helper-mob'
    position: 20,64,20
    yaw: 270
    pitch: 0