roblox-liveops

The systems that keep a live Roblox game measurable and bring players back, taken mostly from Magic Neighborhood (the only one of the three games that has all of them) and checked against Slime Nebula's reward rules.

# wally.toml
[dependencies]
LiveOps = "hurreman/roblox-liveops@0.1.0"

Modules load on first access. Each one receives the game's own data through callbacks (its save tables, stat readers and grants), so none of them requires game code.

A few of them in use

local LiveOps = require(ReplicatedStorage.Packages.LiveOps)

local telemetry = LiveOps.Telemetry.new({
	steps = { "Joined", "BoughtHouse", "FirstMerge" },             -- only ever append
	funnel = function(player) local s = data(player) return s and { done = s.stats.funnel, at = s.stats.funnelAt } end,
	playSeconds = function(player) return data(player).stats.playSeconds end,
	sourceFields = function(player) local s = data(player).stats return s.joinSrc, s.joinCamp end,
	balance = function(player, currency) return data(player).cash end,
	transactions = { Daily = "TimedReward", Offline = "TimedReward" },
	iap = function(sku) return Products.List[sku] ~= nil end,
	counters = function(name, value, a, b) adminStats.add(name, value, a, b) end,
})
telemetry:Start()
telemetry:Onboarding(player, "BoughtHouse")
telemetry:Source(player, "Converter", 120)

local clock = Core.ResetClock.Stockholm                            -- roblox-core
local claimed = LiveOps.Streak.Claim(save.daily, clock.GetDayNumber(os.time()), { cycle = 7 })

local boards = LiveOps.Leaderboards.new({
	boards = { { id = "Earned", log = true }, { id = "Today", scope = "daily" }, { id = "Here", scope = "server" } },
	value = function(board, player) ... end,
	dayOf = clock.GetDayNumber,
})
boards:Start()

Moving the games over

• Magic Neighborhood. Each service keeps its game-specific parts, and the engine underneath becomes the package's:

  Today	Keeps	Becomes
  TelemetryService	the ONBOARDING step list, the tutorial step mapping, place() / housesBucket()	Telemetry
  JoinSource	its SOURCES table	JoinSource.new(SOURCES) (its spec passes unchanged through an adapter, and a corpus agrees with the old module)
  SessionService	goal, tutorial step and cash, as extra	Sessions
  ActivityService and client/Activity		Activity
  BadgeService and shared/Badges	the rules	Badges
  Milestones		Milestones, with the TOTD-specific helpers (houses, seedBought) staying beside it
  LeaderboardService	leaderstats, rollDay, statValue	Leaderboards
  RewardsService	offline earnings, payouts, welcome card	the claim rules: Streak with save = { minStreak = 2, maxMissedDays = 3 }, and Playtime
  SettingsService		Settings with its keys
  FpsWatch		FpsWatch with watching = preset is "auto"

• Slime Nebula:

  • DailyRewardConfig.EvaluateClaimEligibility becomes Streak.Status(..., { cycle = #Days }), with days from ResetClock.Stockholm. They agree on 2000 random states.
  • PlaytimeRewardConfig tiers become Playtime with its ClaimedTiers set.
  • Analytics.lua and OnboardingFunnel can move onto Telemetry (keep the RobloxAdminServer stats copy as counters).

• Steal an Egg: TelemetryService becomes Telemetry the same way.

Developing

lune run tests/run    # specs on hurreman/luau-spec (DevPackages, else ../luau-spec); fakes in tests/fixtures

When the sibling checkouts are present, three specs check against the games' own code:

• JoinSource runs Magic Neighborhood's spec and a launch-data corpus against its module.
• Streak diffs Slime Nebula's EvaluateClaimEligibility over 2000 random states. A deliberate change to the cycle rule made it fail.
• Playtime diffs Magic Neighborhood's giftsReady on its real gift ladder.

In Studio, these were checked: the analytics enum keys and transaction type names the package sends, and that the AnalyticsService, BadgeService, OrderedDataStore, ProximityPrompt and Players APIs it calls exist.

Not run yet:

• real AnalyticsService calls, which need a real Player in Play mode;
• real badge awards;
• OrderedDataStore reads and writes.