如何使用ModuleScript为宠物模型克隆体创建独立属性统计系统

一、核心数据管理模块 #

在ServerStorage里新建一个ModuleScript，命名为PetDataManager，用来统一管理所有玩家的宠物属性：

-- ServerStorage/PetDataManager
local PetDataManager = {}

-- 存储玩家-宠物数据映射，结构：[玩家实例] = { Pets = { [宠物实例] = { 属性键值对 } } }
local playerPetData = {}

-- 初始化玩家的宠物数据容器
function PetDataManager.InitPlayerData(player)
    playerPetData[player] = {
        Pets = {}
    }
end

-- 给新生成的宠物创建专属属性
function PetDataManager.CreatePetData(player, petInstance)
    if not playerPetData[player] then
        PetDataManager.InitPlayerData(player)
    end
    -- 默认属性值可按需调整，比如生命值初始100，满值100
    playerPetData[player].Pets[petInstance] = {
        Health = 100,
        Thirst = 100,
        Hunger = 100,
        Happiness = 100
    }
end

-- 获取宠物的单个属性或全部属性
function PetDataManager.GetPetData(player, petInstance, property)
    local playerData = playerPetData[player]
    if not playerData then return nil end
    local petData = playerData.Pets[petInstance]
    if not petData then return nil end
    -- 如果指定了属性名就返回单个值，否则返回全部属性表
    return property and petData[property] or petData
end

-- 修改宠物属性，自动限制数值在0-100之间
function PetDataManager.UpdatePetData(player, petInstance, property, value)
    local playerData = playerPetData[player]
    if not playerData then return end
    local petData = playerData.Pets[petInstance]
    if not petData then return end
    petData[property] = math.clamp(value, 0, 100)
end

-- 玩家离开时清理数据，避免内存泄漏
function PetDataManager.CleanupPlayerData(player)
    playerPetData[player] = nil
end

return PetDataManager

二、宠物生成时绑定数据 #

在你的宠物生成脚本（比如ServerScriptService里的PetSpawner）里，调用模块初始化玩家和宠物的数据：

-- ServerScriptService/PetSpawner
local PetDataManager = require(game.ServerStorage.PetDataManager)
local ReplicatedStorage = game:GetService("ReplicatedStorage")
-- 替换成你自己的宠物模板路径
local PetTemplate = ReplicatedStorage:FindFirstChild("PetTemplate")

game.Players.PlayerAdded:Connect(function(player)
    -- 先初始化该玩家的宠物数据容器
    PetDataManager.InitPlayerData(player)
    
    -- 克隆宠物模板（这里替换成你现有的跟随系统生成逻辑）
    local petClone = PetTemplate:Clone()
    petClone.Name = player.Name .. "'s Pet"
    petClone.Parent = workspace:FindFirstChild("Pets") or Instance.new("Folder", workspace)
    
    -- 给这个克隆宠物绑定专属属性
    PetDataManager.CreatePetData(player, petClone)
    
    -- 这里插入你已经写好的宠物跟随逻辑...
end)

-- 玩家下线时清理对应数据
game.Players.PlayerRemoving:Connect(function(player)
    PetDataManager.CleanupPlayerData(player)
end)

三、场景中调整属性的示例 #

比如做一个喂食道具，触碰后增加宠物的饥饿值：

-- 喂食道具的Touched脚本（放在道具里）
local PetDataManager = require(game.ServerStorage.PetDataManager)

script.Parent.Touched:Connect(function(hit)
    -- 触发者必须是玩家角色
    local player = game.Players:GetPlayerFromCharacter(hit.Parent)
    if not player then return end
    
    -- 找到该玩家对应的宠物（根据你的命名规则找，这里用玩家名+Pet的格式）
    local pet = workspace.Pets:FindFirstChild(player.Name .. "'s Pet")
    if not pet then return end
    
    -- 获取当前饥饿值，加20后更新
    local currentHunger = PetDataManager.GetPetData(player, pet, "Hunger")
    PetDataManager.UpdatePetData(player, pet, "Hunger", currentHunger + 20)
    print(player.Name .. "的宠物饥饿值更新为: " .. PetDataManager.GetPetData(player, pet, "Hunger"))
end)

四、客户端显示属性的正确姿势 #

如果要在客户端UI显示属性，别直接读ModuleScript（不安全），用RemoteEvent从服务器拉取：

服务器端RemoteEvent脚本 #

-- ServerScriptService/PetDataRemote
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local PetDataManager = require(game.ServerStorage.PetDataManager)
-- 创建RemoteEvent供客户端请求数据
local GetPetDataRemote = Instance.new("RemoteEvent")
GetPetDataRemote.Name = "GetPetDataRemote"
GetPetDataRemote.Parent = ReplicatedStorage

-- 处理客户端请求，先验证宠物归属
GetPetDataRemote.OnServerInvoke = function(player, petInstance, property)
    if petInstance.Name ~= player.Name .. "'s Pet" then return nil end
    return PetDataManager.GetPetData(player, petInstance, property)
end

客户端UI脚本 #

-- 放在PlayerGui里的LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local GetPetDataRemote = ReplicatedStorage:GetRemoteEvent("GetPetDataRemote")
local player = game.Players.LocalPlayer
local pet = workspace.Pets:FindFirstChild(player.Name .. "'s Pet")

-- 请求并显示宠物饥饿值
local hungerValue = GetPetDataRemote:InvokeServer(pet, "Hunger")
print("我的宠物当前饥饿值: " .. hungerValue)
-- 可以把这个值赋值给UI组件，比如TextLabel.Text = hungerValue

内容的提问来源于stack exchange，提问作者Dr_ArmyDevRBX