Roblox 体验设计师

-- ServerStorage/Modules/PassManager.lua
local MarketplaceService = game:GetService("MarketplaceService")
local Players = game:GetService("Players")

local PassManager = {}

-- 集中的通行证 ID 注册表——改这里，不要散落在代码库各处
local PASS_IDS = {
    VIP = 123456789,
    DoubleXP = 987654321,
    ExtraLives = 111222333,
}

-- 缓存所有权以避免过多 API 调用
local ownershipCache: {[number]: {[string]: boolean}} = {}

function PassManager.playerOwnsPass(player: Player, passName: string): boolean
    local userId = player.UserId
    if not ownershipCache[userId] then
        ownershipCache[userId] = {}
    end

    if ownershipCache[userId][passName] == nil then
        local passId = PASS_IDS[passName]
        if not passId then
            warn("[PassManager] 未知通行证:", passName)
            return false
        end
        local success, owns = pcall(MarketplaceService.UserOwnsGamePassAsync,
            MarketplaceService, userId, passId)
        ownershipCache[userId][passName] = success and owns or false
    end

    return ownershipCache[userId][passName]
end

-- 通过 RemoteEvent 从客户端提示购买
function PassManager.promptPass(player: Player, passName: string): ()
    local passId = PASS_IDS[passName]
    if passId then
        MarketplaceService:PromptGamePassPurchase(player, passId)
    end
end

-- 连接购买完成——更新缓存并应用收益
function PassManager.init(): ()
    MarketplaceService.PromptGamePassPurchaseFinished:Connect(
        function(player: Player, passId: number, wasPurchased: boolean)
            if not wasPurchased then return end
            -- 使缓存失效以便下次检查重新获取
            if ownershipCache[player.UserId] then
                for name, id in PASS_IDS do
                    if id == passId then
                        ownershipCache[player.UserId][name] = true
                    end
                end
            end
            -- 应用即时收益
            applyPassBenefit(player, passId)
        end
    )
end

return PassManager

-- ServerStorage/Modules/DailyRewardSystem.lua
local DataStoreService = game:GetService("DataStoreService")

local DailyRewardSystem = {}
local rewardStore = DataStoreService:GetDataStore("DailyRewards_v1")

-- 奖励阶梯——索引 = 连续天数
local REWARD_LADDER = {
    {coins = 50,  item = nil},        -- 第 1 天
    {coins = 75,  item = nil},        -- 第 2 天
    {coins = 100, item = nil},        -- 第 3 天
    {coins = 150, item = nil},        -- 第 4 天
    {coins = 200, item = nil},        -- 第 5 天
    {coins = 300, item = nil},        -- 第 6 天
    {coins = 500, item = "badge_7day"}, -- 第 7 天——周连续奖励
}

local SECONDS_IN_DAY = 86400

function DailyRewardSystem.claimReward(player: Player): (boolean, any)
    local key = "daily_" .. player.UserId
    local success, data = pcall(rewardStore.GetAsync, rewardStore, key)
    if not success then return false, "datastore_error" end

    data = data or {lastClaim = 0, streak = 0}
    local now = os.time()
    local elapsed = now - data.lastClaim

    -- 今天已经领过了
    if elapsed < SECONDS_IN_DAY then
        return false, "already_claimed"
    end

    -- 超过 48 小时连续中断
    if elapsed > SECONDS_IN_DAY * 2 then
        data.streak = 0
    end

    data.streak = (data.streak % #REWARD_LADDER) + 1
    data.lastClaim = now

    local reward = REWARD_LADDER[data.streak]

    -- 保存更新后的连续数据
    local saveSuccess = pcall(rewardStore.SetAsync, rewardStore, key, data)
    if not saveSuccess then return false, "save_error" end

    return true, reward
end

return DailyRewardSystem

## Roblox 体验引导流程

### 第一阶段：前 60 秒（留存关键）
目标：玩家执行核心操作并成功一次

步骤：
1. 出生在视觉上独特的"新手区"——不是主世界
2. 立即可控制：无过场动画、无长篇教学对话
3. 第一次成功是保证的——此阶段不可能失败
4. 首次成功时的视觉奖励（闪光/彩带）+ 音频反馈
5. 箭头或高亮引导到"首个任务"NPC 或目标

### 第二阶段：前 5 分钟（核心循环引入）
目标：玩家完成一个完整的核心循环并获得首个奖励

步骤：
1. 简单任务：明确目标、显眼位置、只需一个机制
2. 奖励：足够感觉有意义的初始货币
3. 解锁一个额外功能或区域——创造向前的动力
4. 轻度社交提示："邀请好友获得双倍奖励"（不阻断流程）

### 第三阶段：前 15 分钟（投入钩子）
目标：玩家已投入足够多，退出会感觉是损失

步骤：
1. 首次升级或段位提升
2. 个性化时刻：选择一个装扮或为角色命名
3. 预览一个锁定功能："达到 5 级解锁 [X]"
4. 自然的收藏提示："喜欢这个体验吗？添加到收藏！"

### 流失恢复点
- 2 分钟前离开的玩家：引导太慢——砍掉前 30 秒
- 5–7 分钟离开的玩家：首个奖励不够吸引——增加
- 15 分钟后离开的玩家：核心循环好玩但没有回来的钩子——添加每日奖励提示

-- 记录关键玩家事件用于留存分析
-- 使用 AnalyticsService（Roblox 内置，无需第三方）
local AnalyticsService = game:GetService("AnalyticsService")

local function trackEvent(player: Player, eventName: string, params: {[string]: any}?)
    -- Roblox 内置分析——在 Creator Dashboard 中可见
    AnalyticsService:LogCustomEvent(player, eventName, params or {})
end

-- 追踪引导完成
trackEvent(player, "OnboardingCompleted", {time_seconds = elapsedTime})

-- 追踪首次购买
trackEvent(player, "FirstPurchase", {pass_name = passName, price_robux = price})

-- 离开时追踪会话时长
Players.PlayerRemoving:Connect(function(player)
    local sessionLength = os.time() - sessionStartTimes[player.UserId]
    trackEvent(player, "SessionEnd", {duration_seconds = sessionLength})
end)