Eggs and hatching

An egg

Pet1 = {
    order = 1,
    eggName = "Basic Egg",
    modelName = "Egg9",
    imageId = "rbxassetid://101387078158985",
    price = { currency = "Coins", amount = 2500 },
    multiOpen = { 1, 3, 8 },
    pool = { ... },
},

The key on the left, Pet1, is the id you put in an egg platform's EggId attribute.

The pool

Each line is one possible outcome:

{ species = "Dragon", variant = "Rainbow", weight = 0.05, luckBoost = 1 },

Weights do not need to add to anything. A weight of 50 against a weight of 5 is ten times as likely, and that is the whole rule.

The shipped Basic Egg totals 145.05, so its Rainbow Dragon at 0.05 is roughly one in 2,900.

Luck

luckBoost = 1,

Luck raises an entry's effective weight:

effectiveWeight = weight * (1 + (luck - 1) * luckBoost)

An entry without luckBoost is untouched by luck, so raising a player's luck shifts the distribution toward the entries you marked, at the expense of everything else.

Put it on your rare entries only. Putting it on everything makes luck do nothing, because every weight grows together.

Luck comes from the three luck gamepasses. See Currencies and gamepasses.

Multi-open

multiOpen = { 1, 3, 8 },

Which counts a player may open at once. The server rejects any count not in this list, so the buttons and the rule are the same thing.

Each pet in a multi-open is rolled independently. Opening eight is eight separate rolls, not one roll of a bigger prize.

Robux eggs

robux = true,
devProductId = 1750131364,
price = { currency = "Coins", amount = 500 },

The price shown on the platform is fetched live from the product, so it always matches what Roblox charges. The price block stays as a coin fallback.

Egg platforms

Found by the CollectionService tag EggPlatform, with a string attribute EggId.

A ProximityPrompt named OpenPrompt is created at runtime with no hold, custom style, no line-of-sight requirement and an 8-stud range. It reads Hatch above the egg's name.

Platforms tagged after the server starts are set up immediately, so a placed or streamed-in platform works.

What happens on open

The backpack check is done for the whole batch before anything is spent, so an eight-open that would overflow is refused rather than half-completed.

Sending your pets to a breakable is cancelled when you open an egg, so they come back to you for the reveal.

Auto-delete

The client can pass a set of species and variant keys to discard on arrival. Those results are still rolled and shown in the reveal, marked as auto-deleted, but never enter the inventory.

That is what makes an eight-open of a low-tier egg tolerable once a player has a full backpack.

The open animation

Config/EggAnim.luau:

ShakeDuration = 1.1,
CrackDuration = 0.45,
HoldDuration = 0.15,
ShakeAmplitudeStart = 3,
ShakeAmplitudePeak = 22,
ShakeFrequencyStart = 7,
ShakeFrequencyPeak = 20,
PopScale = 1.3,

The egg shakes, building from gentle to strong, puffs up 30 percent, pops, holds for a moment, and the pet appears.

The Fast Open gamepass skips it. Tune the durations down rather than off if you want a quicker default: the shake is where the anticipation lives.

Rare hatch announcements

Announce = {
    Enabled = true,
    Scope = "global",
    Variants = { Golden = true, Rainbow = true },
    Rarities = { Legendary = true },
    Format = "{player} hatched a {variant} {pet} (%{chance})!",
    HoldSeconds = 6,
},

A hatch is announced if either its variant or its rarity is listed. The shipped configuration announces every Golden, every Rainbow and every Legendary.

Write the percent sign yourself; the token is the number alone. The shipped default also begins with a celebration emoji, which you can remove.

{chance} is computed against that player's luck, so a lucky player's announcement honestly reflects their better odds. Very small numbers are given more decimal places automatically, so a one in three thousand hatch does not read as 0.