Currencies and gamepasses

The main currency

Currency = { Key = "Coins", Start = 100000 },

Start = 100000 is a testing value. Set it to whatever a new player should actually have.

Extra currencies

Currencies = {
    Gems = { Start = 500 },
},

Add as many as you like. They appear in the Roblox leaderboard automatically, and an egg can cost one:

price = { currency = "Gems", amount = 50 },

The currency display

CurrencyUI = {
    Enabled = true,
    Show = { "Coins", "Gems" },
},

The boxes in the corner, one per listed currency, in the order listed.

Every name in Show needs an icon in PriceIcons, or its box has no picture.

PriceIcons = {
    Coins = "rbxassetid://91195358993801",
    Gems = "rbxassetid://103825372958185",
    Robux = "rbxassetid://130480283103325",
},

Robux is special: it is used for any egg marked robux = true, whatever that egg's fallback currency is.

The egg gamepasses

Gamepasses = {
    Open3x = 864196470,
    Open8x = 864284268,
    AutoOpen = 864177554,
    FastOpen = 864200461,
    Luck1 = 864392167,
    Luck2 = 864150553,
    Luck3 = 864101978,
},

The multi-open buttons only appear on eggs whose multiOpen lists that count, so an egg with multiOpen = { 1 } shows neither regardless of what a player owns.

Luck

LuckValues = {
    Luck1 = 2,
    Luck2 = 3,
    Luck3 = 5,
},

A player gets the highest tier they own, not the sum. Owning all three is luck 5, not luck 10.

Luck multiplies the effective weight of pool entries marked luckBoost = 1:

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

Whether that is a large or a small change depends on the entry's share of the pool. A 0.05-weight Rainbow Dragon in a 145-weight pool goes from one in 2,900 to about one in 580 at luck 5, which is a real difference the player will feel.

DefaultLuck = 1 is what a player with no pass has. Raising it globally makes the passes worth less, so leave it at 1 and tune the tiers.

LuckIcons sets the picture on each luck button.

Slot passes

Passes = {
    { gamePassId = 1875070251, target = "equip", amount = 3 },
    { gamePassId = 1875718256, target = "backpack", amount = 125 },
},

A list, so add as many as you want.

Owning several adds them up, unlike the luck tiers. Three equip passes of 3 give 9 extra slots.

That is what lets you sell a ladder: a small pass, a bigger pass, and a large pass, all stacking.

Robux eggs

An egg with robux = true and a devProductId is bought with Robux rather than currency. The price shown comes live from the product. See Eggs and hatching.

Ownership caching

Pass ownership is checked once per player per session and cached. A purchase made in-game is picked up immediately through the purchase-finished event, which recomputes the caps and tells the client.

A pass bought on the website while the player is already in the game is not seen until they rejoin.

Plugging in your own economy

Currency goes through an adapter with three functions:

GetBalance(player, currencyKey)
Add(player, currencyKey, amount, reason)
Spend(player, currencyKey, amount, reason)

The default keeps balances on the player's leaderstats. If your game has its own economy, replace the implementation so pets share one wallet with everything else.

The reason argument is passed through, so your economy can log that money came from breakable or went to egg:Pet1.

Pricing

The shipped prices are a demo:

The Huge Egg at one coin for a guaranteed Huge Elephant is a test entry, not a product. Price it, or remove it, before you publish.