Wild Zones

To easily create or edit existing Wild Zones, I recommend sd-zonecreator, download here:

GitHub - Samuels-Development/sd-zonecreatorGitHub

It is extremely helpful for easily designing simple or complex poly zones.

---

Creating Wild Zones

Wild Zones control where wild pets can spawn, what species can spawn there, and how fast they respawn

---

1) Locate the Wild Zones Table

Open: hoff-battlebuddies/config.lua

Find: Config.Wild.Zones

This table contains all wild spawn zones.

---

2) Add a New Zone Entry

Each zone is keyed by a label (e.g. ["Mirror Park"]). That key can be anything, but keeping it readable helps.

You can create zones using one of these shapes:

Shape	Best For	Required Fields
sphere	quick circular areas	coords, radius
box	rectangles (lots, farms)	coords, length, width
poly	irregular areas (parks, neighborhoods)	coords, points, thickness

---

3) Configure Spawn Settings

At minimum, a zone should define:

• speciesPool — which pets can spawn + weights

• levelRange — min/max spawn level

• quality — min/max quality tier

• maxPets — max concurrent wild pets in this zone

• respawnTime — seconds (random between min/max)

• enabled — toggle zone on/off

Common optional fields:

• debug — draws debug helpers

• thickness — poly only

---

Examples

Example A: Sphere Zone (Simple)

["Sandy Shores"] = {
	name = "Sandy Shores",
	shape = "sphere",

	coords = vector3(2189.14, 3371.83, 44.42),
	radius = 250.0,

	enabled = true,

	speciesPool = {
		{ speciesId = "boar",   weight = 30 },
		{ speciesId = "coyote", weight = 30 },
		{ speciesId = "rabbit", weight = 25 },
		{ speciesId = "rat",    weight = 15 },
	},

	levelRange = { min = 2, max = 5 },
	maxPets = 5,
	respawnTime = { min = 60, max = 300 }, -- seconds
	quality = { min = 1, max = 3 },
}

---

Example B: Box Zone (Rectangular)

Use boxes for clean, rectangular spaces like parking lots, yards, or fields.

["Example Box Zone"] = {
	name = "Example Box Zone",
	shape = "box",

	coords = vector3(200.0, -900.0, 30.0),
	length = 120.0,
	width = 80.0,

	enabled = true,

	speciesPool = {
		{ speciesId = "cat", weight = 60 },
		{ speciesId = "rat", weight = 40 },
	},

	levelRange = { min = 1, max = 2 },
	maxPets = 6,
	respawnTime = { min = 60, max = 180 },
	quality = { min = 1, max = 2 },
}

---

Example C: Poly Zone (Best for Irregular Areas)

Poly zones are ideal for real map regions (parks/neighborhoods).

["Mirror Park"] = {
	name = "Mirror Park",
	shape = "poly",

	coords = vector3(1100.54, -548.4, 50.0), -- reference Z

	points = {
		vector3(1029.92, -531.82, 50.0),
		vector3(1150.48, -523.62, 50.0),
		vector3(1168.43, -645.16, 50.0),
		vector3(1185.88, -750.29, 50.0),
		vector3(1065.83, -751.32, 50.0),
		vector3(996.58,  -692.34, 50.0),
	},

	thickness = 150.0,
	debug = false,
	enabled = true,

	speciesPool = {
		{ speciesId = "cat",    weight = 40 },
		{ speciesId = "pug",    weight = 30 },
		{ speciesId = "poodle", weight = 20 },
		{ speciesId = "rat",    weight = 10 },
	},

	levelRange = { min = 1, max = 3 },
	maxPets = 50,
	respawnTime = { min = 60, max = 300 },
	quality = { min = 1, max = 3 },
}

---

Reference

Core Shape Fields

shape

One of:

• sphere

• box

• poly

coords

• Sphere/Box: center of the zone

• Poly: a reference Z (used with thickness checks)

Sphere-only

• radius

Box-only

• length

• width

Poly-only

• points — ordered list of vertices

• thickness — vertical buffer for the polygon region

---

Spawn Control Fields

enabled

Toggles the zone on/off without deleting it.

speciesPool

Weighted spawn list:

speciesPool = {
	{ speciesId = "cat", weight = 40 },
	{ speciesId = "rat", weight = 10 },
}

Higher weight = spawns more often.

levelRange

Spawn level roll:

levelRange = { min = 1, max = 3 }

respawnTime

Spawn timing in seconds (random within range):

respawnTime = { min = 60, max = 300 }

quality

Quality tier roll:

quality = { min = 1, max = 3 }

	Poor      = 1,
	Common    = 2,
	Uncommon  = 3,
	Rare      = 4,
	Epic      = 5,
	Legendary = 6,

maxPets

Maximum number of wild pets that can exist concurrently in the zone.