Break and Steal an EggOwner documentation← Portfolio

#Zones & Eggs

The world has 10 zones and three map egg types per zone. A map egg rolls a pet from its zone pool; its appearance does not guarantee one particular species.

Forest and Desert zones with eggs and guardians
Eggs spawn at random ground positions. Each has a zone-themed nest, rarity label and HP bar.

#Zone reference

ZoneThemeRequired SpeedMap eggsBase egg HP
1Forest5Rock Egg, Forest Egg, Swamp Egg12
2Desert1,000Cactus Egg, Bones Egg, Scorpion Egg300
3Snowy50,000Frozen Egg, Yeti Egg, Frosty Egg5,000
4Candy750,000Easter Bunny Egg, Candy Egg, Rainbow Egg75,000
5Swamp12,000,000Gooey Egg, Tree Egg, Lake Egg1,200,000
6Ocean150,000,000Sea Stones Egg, Water Egg, Sea Egg20,000,000
7Volcano1,000,000,000Fallen Angel Egg, Angel Egg, Volcanic Egg300,000,000
8Blossom5,000,000,000Blossom Egg, Bamboo Egg, Fortune Egg5,000,000,000
9Galaxy25,000,000,000Sun Egg, Starry Egg, Blackhole Egg100,000,000,000
10Planet X100,000,000,000Nebula Egg, Plasma Egg, Supernova Egg1,200,000,000,000

#Spawn counts

EggService.eggsPerZone interpolates each zone's floor area between a minimum of 10 and maximum of 30 eggs. In this map the counts are 10, 11, 12, 14, 16, 19, 25, 25, 26, 30.

Ground selection leaves space between eggs. A nest is attached at spawn and removed with its egg. Nest templates are stored in ServerStorage.EggNests.Zone1 through Zone10.

#Models and size

Map models live in ReplicatedStorage.Folder.Eggs.NormalEggs. The matcher removes numeric prefixes, spaces and punctuation, so 3: BlackHole Egg can match the configured Blackhole Egg name. Normal zone models take priority over special eggs with the same name.

World egg width varies from 1.8 to 3.6 studs, using width = 1.8 + 1.8 * U^1.8 for uniform U in [0,1]. This favors smaller eggs: theoretical median is about 2.32 studs and about 68% are below 2.7 studs. It affects pet weight and scales HP from roughly 80% to 120% of the zone's base value. It does not change rarity or mutation odds.

#Adding another map egg

Add a matching model, an entry in Config.Eggs, and its name to the zone's Eggs list. Update the fallback WorldData definition as well. See Adding Content for the full checklist.

#Pickaxe timing

Manual and automatic attacks share a server-enforced 0.7-second interval between successful hits. Missing in the air does not spend the hit cooldown. Egg selection uses the character's current position rather than waiting for the periodically updated Zone attribute. This avoids an extra delay after entering a zone; ordinary network latency still applies. Damage per accepted hit remains unchanged.